vfs_ceph_snapshots — Expose CephFS snapshots as shadow-copies
vfs objects = ceph_snapshots
This VFS module is part of the samba(8) suite.
vfs_ceph_snapshots VFS module exposes
CephFS snapshots for use by Samba. When enabled, SMB clients
such as Windows Explorer's Previous Versions dialog, can
enumerate snapshots and access them via "timewarp" tokens.
This module can be combined with
vfs_ceph_snapshots must be listed first
vfs objects parameter list.
CephFS support for ceph.snap.btime virtual extended attributes is required for this module to work properly. This support was added via https://tracker.ceph.com/issues/38838.
When used atop
path refers to an absolute path within the
Ceph filesystem and should not be mounted locally:
vfs_ceph_snapshots can also be used atop a
kernel CephFS mounted share path, without
vfs_ceph. In this case Samba's default VFS
vfs_default is used:
Allows for the configuration of the special CephFS
snapshot subdirectory name. This parameter should only
be changed from the ".snap" default if the ceph.conf
client snapdir or
snapdirname mount option settings
are changed from their matching ".snap" defaults.
Default: ceph:snapdir = .snap
Example: ceph:snapdir = .snapshots