Go to main content

man pages section 8: System Administration Commands

Exit Print View

Updated: Thursday, June 13, 2019

vfs_snapper (8)


vfs_snapper - copies


vfs objects = snapper


System Administration tools                                     VFS_SNAPPER(8)

       vfs_snapper - Expose snapshots managed by snapper as shadow-copies

       vfs objects = snapper

       This VFS module is part of the samba(8) suite.

       The vfs_snapper VFS module exposes snapshots managed by snapper for use
       by Samba. This provides the ability for remote SMB clients to access
       shadow-copies via Windows Explorer using the "previous versions"

       Snapshots can also be created and remove remotely, using the File
       Server Remote VSS Protocol (FSRVP). Snapshot creation and deletion
       requests are forwarded to snapper via DBus.

       This module is stackable.

       The underlying share path must have a corresponding snapper
       configuration file. The snapshot directory tree must allow access for
       relevant users.

                     vfs objects = snapper

       For remote snapshot creation and deletion, Samba's FSRVP server must be
       configured in the [global] section:

                     rpc_daemon:fssd = fork
                     registry shares = yes
                     include = registry

       Snapper stores snapshots under a .snapshots subdirectory. This
       directory must permit traversal for any users wishing to access
       snapshots via the Windows Explorer previous versions dialog. By
       default, traversal is forbidden for all non-root users. Additionally,
       users must be granted permission to list snapshots managed by snapper,
       via snapper's ALLOW_USERS or ALLOW_GROUPS options. Snapper can grant
       these users and groups .snapshots traversal access automatically via
       the SYNC_ACL option.

       Remote snapshot creation and deletion is only permitted by Samba for
       Active Directory administrators, backup operators, or users explicitly
       granted SeBackupPrivilege. Snapper must also permit creation and
       deletion for the appropriate user, via snapper's ALLOW_USERS or
       ALLOW_GROUPS options.

       The DiskShadow.exe FSRVP client initially authenticates as the Active
       Directory computer account. This account must therefore be granted the
       same permissions as the user account issuing the snapshot creation and
       deletion requests.

       This man page is part of version 4.9.3 of the Samba suite.

       The original Samba software and related utilities were created by
       Andrew Tridgell. Samba is now developed by the Samba Team as an Open
       Source project similar to the way the Linux kernel is developed.

       See attributes(7) for descriptions of the following attributes:

       |Availability   | service/network/samba |
       |Stability      | Volatile              |
       This software was built from source available at
       https://github.com/oracle/solaris-userland.  The original community
       source was downloaded from

       Further information about this software can be found on the open source
       community website at http://www.samba.org/.

Samba 4.9.3                       01/24/2019                    VFS_SNAPPER(8)