VFS_LINUX_XFS_SGID(8)
π VFS_LINUX_XFS_SGID β the manual page, but make it make sense
okay bestie, so this is vfs_linux_xfs_sgid, a page from the System Administration tools section of the manual. Section 8, so it's a sysadmin thing, not a "type this in your shell and pray" thing. π
β¨ NAME β¨
vfs_linux_xfs_sgid β workaround for the little XFS thing where the sgid bit just... doesn't get inherited. rude of it, honestly. π
πΈ SYNOPSIS πΈ
vfs objects = linux_xfs_sgid
that's it. that's the whole vibe. one line. iconic. π
π¦ DESCRIPTION π¦
so this VFS module is part of the samba(7) suite β yes, the big one, the whole gang. π«Ά
vfs_linux_xfs_sgid is a VFS module whose entire personality is working around an old Linux XFS bug. like, this bug got fixed in 3.11, so we're talking vintage. the bug was this: the SGID bit is not inherited during mkdir when a default ACL is set. no cap, that's the actual bug.
if you want receipts, here they are:
- the original bug report:
https://web.archive.org/web/20160320180937/http://oss.sgi.com/bugzilla/show_bug.cgi?id=280 - the fix:
https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/commit/?id=42c49d7f249c2487f36d3314753d5d8ebcee8249
so what does this module do about it? it does the workaround manually, like a queen. after a mkdir, if the parent directory had the SGID bit set, the module manually sets the SGID bit. that's the whole trick. the way that it just does the kernel's job for it π
heads up: this module is stackable. so yes, you can pile it on with your other VFS modules. go off. π
π EXAMPLES π
want to add linux_xfs_sgid functionality for [share]? bet. here's the whole thing:
[share]
vfs objects = linux_xfs_sgid
that's it, bestie. copy, paste, slay. β¨
β VERSION β
this man page is part of version 4.24.7-Ubuntu-4.24.7+dfsg-1ubuntu1 of the Samba suite. yes, that version string is a whole entire mouthful. write it down carefully. π
π AUTHOR π
the original Samba software and related utilities were created by Andrew Tridgell. absolute legend, main character energy, we stan. πββοΈ
Samba is now developed by the Samba Team as an Open Source project, similar to the way the Linux kernel is developed. so basically a whole community of people doing this for the love of the game. periodt. π
and that's the page, fr fr! π
sign-off time: this was Samba 4.24.7-Ubuntu-4.24.7+dfsg, dated 09/13/2026, living in the VFS_LINUX_XFS_SGID(8) section. thanks for coming to my ted talk, go fix your XFS SGID bits, ily π§π
π¦ where this page comes from
- ubuntu stonking: samba 2:4.24.7+dfsg-1ubuntu1 Β· GPL-3.0-or-later
- π girlified by deepseek-ai/DeepSeek-V4.1-Flash on : a language model's rewrite of the original, under its terms