---
name: "vfs_ceph_snapshots"
section: "8"
platform: "linux"
package: "samba-vfs-ceph"
version: "2:4.22.11+dfsg-0+deb13u1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/vfs_ceph_snapshots"
---

# vfs\_ceph\_snapshots(8)

Expose CephFS snapshots as shadow-copies

## NAME

vfs\_ceph\_snapshots - Expose CephFS snapshots as shadow-copies

## SYNOPSIS

vfs objects = ceph\_snapshots

## DESCRIPTION

This VFS module is part of the [**samba**(8)](/samba/8.md) 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.

## CONFIGURATION

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

```
		[share]
		vfs objects = ceph_snapshots ceph
		path = /non-mounted/cephfs/path
		kernel share modes = 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]
		vfs objects = ceph_snapshots
		path = /mnt/cephfs/
```

## 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**

## VERSION

This man page is part of version 4.22.11-Debian-4.22.11+dfsg-0+deb13u1 of the Samba suite.

## 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.