VFS_CEPH_SNAPSHOTS(8)

💖 VFS_CEPH_SNAPSHOTS(8) 💖

okay bestie, sit down, because this one is genuinely iconic — it's a section 8 System Administration tools page and it's all about making your CephFS snapshots show up in Samba like the little time capsules they are 🦋

---

✨ NAME ✨

vfs_ceph_snapshots — expose CephFS snapshots as shadow-copies 🌸

---

🎀 SYNOPSIS 🎀

vfs objects = ceph_snapshots

like. that's it. that's the whole incantation 💅

---

🧚 DESCRIPTION 🧚

So bestie, this VFS module is part of the samba(8) suite. It's giving "team player" energy, no cap.

The vfs_ceph_snapshots VFS module exposes CephFS snapshots for Samba to use. When you turn it on, SMB clients — think Windows Explorer's Previous Versions dialog — can enumerate your snapshots and get at them via "timewarp" tokens. Literally the glow-up your file history deserved ✨

You can combine this module with vfs_ceph, but listen closely: vfs_ceph_snapshots must be listed first in the vfs objects parameter list. Order matters, it's giving lineup-at-a-concert, the headliner goes first 🔥

⚠️ Heads up: CephFS support for ceph.snap.btime virtual extended attributes is required for this module to work properly. That support was added via https://tracker.ceph.com/issues/38838 — go check it out, iykyk.

---

🌈 CONFIGURATION 🌈

main character setup: on top of vfs_ceph 🫶

When you use it atop vfs_ceph, path refers to an absolute path within the Ceph filesystem and should not be mounted locally. Do not mount it locally, bestie, I'm begging 😭

[share]
vfs objects = ceph_snapshots ceph
path = /non-mounted/cephfs/path
kernel share modes = no

the other vibe: on top of a kernel CephFS mount 🦋

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/

two ways to slay, pick your fighter 💖

---

💅 OPTIONS 💅

• ceph:snapdir = subdirectory — lets you set 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. like, don't freestyle it unless you're matching your mount options, fr fr 🙈

Default: ceph:snapdir = .snap

Example: ceph:snapdir = .snapshots

---

⭐ VERSION ⭐

This man page is part of version 4.24.7-Ubuntu-4.24.7+dfsg-1ubuntu1 of the Samba suite. yes that's the whole string, don't @ me 💀

---

👑 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. kings of the open source pipeline, periodt 👑

---

and that's the whole page, bestie!! this one's from the Samba suite, version 4.24.7-Ubuntu-4.24.7+dfs on the tin, dated 09/13/2026 — go forth and timewarp responsibly 🎀💜