logo
Free, unlimited AI code reviews that run on commit
git-lrc git-lrc GitHub Install Now We'd appreciate a star git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt

vfs_ceph_snapshots - Expose CephFS snapshots as shadow-copies

Author

       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.

Samba 4.22.3-Ubuntu-4.22.3+dfs                     07/21/2025                              VFS_CEPH_SNAPSHOTS(8)

Configuration

       When used atop vfs_ceph, path refers to an absolute path within the Ceph filesystem and should not be
       mounted locally:

                     [share]vfsobjects=ceph_snapshotscephpath=/non-mounted/cephfs/pathkernelsharemodes=no

       vfs_ceph_snapshots can also be used atop a kernel CephFS mounted share path, without vfs_ceph. In this
       case Samba's default VFS backend vfs_default is used:

                     [share]vfsobjects=ceph_snapshotspath=/mnt/cephfs/

Description

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

       The 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, but vfs_ceph_snapshots must be listed first in the 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.

Name

       vfs_ceph_snapshots - Expose CephFS snapshots as shadow-copies

Options

       ceph:snapdir = subdirectory
           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

Synopsis


       vfs objects = ceph_snapshots

Version

       This man page is part of version 4.22.3-Ubuntu-4.22.3+dfsg-4ubuntu1 of the Samba suite.

See Also