1VFS_SNAPPER(8)            System Administration tools           VFS_SNAPPER(8)
2
3
4

NAME

6       vfs_snapper - Expose snapshots managed by snapper as shadow-copies
7

SYNOPSIS

9       vfs objects = snapper
10

DESCRIPTION

12       This VFS module is part of the samba(8) suite.
13
14       The vfs_snapper VFS module exposes snapshots managed by snapper for use
15       by Samba. This provides the ability for remote SMB clients to access
16       shadow-copies via Windows Explorer using the "previous versions"
17       dialog.
18
19       Snapshots can also be created and remove remotely, using the File
20       Server Remote VSS Protocol (FSRVP). Snapshot creation and deletion
21       requests are forwarded to snapper via DBus.
22
23       This module is stackable.
24

CONFIGURATION

26       The underlying share path must have a corresponding snapper
27       configuration file. The snapshot directory tree must allow access for
28       relevant users.
29
30                     [share]
31                     vfs objects = snapper
32
33
34       For remote snapshot creation and deletion, Samba's FSRVP server must be
35       configured in the [global] section:
36
37                     [global]
38                     rpc_daemon:fssd = fork
39                     registry shares = yes
40                     include = registry
41
42

PERMISSIONS

44       Snapper stores snapshots under a .snapshots subdirectory. This
45       directory must permit traversal for any users wishing to access
46       snapshots via the Windows Explorer previous versions dialog. By
47       default, traversal is forbidden for all non-root users. Additionally,
48       users must be granted permission to list snapshots managed by snapper,
49       via snapper's ALLOW_USERS or ALLOW_GROUPS options. Snapper can grant
50       these users and groups .snapshots traversal access automatically via
51       the SYNC_ACL option.
52
53       Remote snapshot creation and deletion is only permitted by Samba for
54       Active Directory administrators, backup operators, or users explicitly
55       granted SeBackupPrivilege. Snapper must also permit creation and
56       deletion for the appropriate user, via snapper's ALLOW_USERS or
57       ALLOW_GROUPS options.
58
59       The DiskShadow.exe FSRVP client initially authenticates as the Active
60       Directory computer account. This account must therefore be granted the
61       same permissions as the user account issuing the snapshot creation and
62       deletion requests.
63

VERSION

65       This man page is part of version 4.15.2 of the Samba suite.
66

AUTHOR

68       The original Samba software and related utilities were created by
69       Andrew Tridgell. Samba is now developed by the Samba Team as an Open
70       Source project similar to the way the Linux kernel is developed.
71
72
73
74Samba 4.15.2                      11/13/2021                    VFS_SNAPPER(8)
Impressum