VFS_CAP(8)

💖 NAME 💖

okay bestie, gather round, because this one is genuinely iconic: vfs_cap — it does CAP encoding of filenames. that's the whole vibe. no cap. 🎀

---

✨ SYNOPSIS ✨

vfs objects = cap

that's it. that's the whole thing. one line. she's low maintenance like that. 💅

---

🦋 DESCRIPTION 🦋

so this lil VFS module is part of the samba(7) suite — yes, that samba(7) suite, the one we all know and love. 🫶

okay so what even is CAP? CAP stands for Columbia Appletalk Protocol, and CAP encoding is a technique for representing non-ASCII filenames in ASCII. like, fitting the whole alphabet's side quests into plain ol' ASCII. the vfs_cap VFS module translates filenames to and from CAP format, which means users get to name their files in their native encoding. main character energy, honestly. 👑

and where does CAP encoding live its best life? most commonly in Japanese language environments. it's giving very much tailored, very much on purpose. 🌸

one more thing bestie: this module is stackable. so she plays nice, she stacks, she slays. ✨

---

🌈 EXAMPLES 🌈

say you're on a system using GNU libiconv and you wanna use CAP encoding to support the users hanging out in the Shift_JIS locale — boom, here's the config:

                   [global]
                dos charset = CP932
                dos charset = CP932
                vfs objects = cap

⚠️ and yes, the dos charset = CP932 line is there twice in the original. no, that's not a typo, that's not me being chaotic — we reproduce it exactly as written. periodt. 💀

---

⭐ 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 real version string, we don't truncate around here. 💜

---

👑 AUTHOR 👑

the original Samba software and related utilities were created by Andrew Tridgell — a legend, fr fr. these days Samba is developed by the Samba Team as an Open Source project, similar to the way the Linux kernel is developed. collaborative, community-coded, absolutely iconic. 🧚

---

okay that's the whole page bestie! this was pulled from Samba 4.24.7-Ubuntu-4.24.7+dfsg-1ubuntu1 and dated 09/13/2026 under the manual name VFS_CAP(8) — go forth and encode those filenames, you absolute icon 🎀💖