NFS4_GETFACL(1)

πŸ“¦
version 0.4.2 Β· 2 versions
, in centos-stream 10, centos-stream 9, debian trixie, fedora 43, fedora 44, ubuntu questing, ubuntu resolute, ubuntu stonking

πŸ’… NFS4_GETFACL(1) β€” NFSv4 Access Control Lists πŸ’…

okay bestie, so this one lives in the NFSv4 Access Control Lists corner of the manual, and its name is nfs4_getfacl 🫢


✨ NAME ✨

nfs4_getfacl β€” get NFSv4 file/directory access control lists. yes, that's the whole vibe: it gets the ACLs. iconic behavior honestly πŸ‘‘


🌸 SYNOPSIS 🌸

nfs4_getfacl [-HR] file ...

πŸ¦‹ DESCRIPTION πŸ¦‹

so nfs4_getfacl will display the NFSv4 Access Control List (ACL) for the files you hand it as arguments β€” provided they're chillin' on mounted NFSv4 filesystems that actually support ACLs. no ACL support, no ACLs, that's just how it is 😭

If you pass the -H/--more-help flag, nfs4_getfacl will print some info about NFSv4 ACLs and the fields used in ACEs. like a lil study session, but make it free πŸ“šβœ¨

If you pass the -R/--recursive flag, nfs4_getfacl will list the NFSv4 ACLs of all files and directories recursively. it goes down the whole tree, no skips, no shortcuts 🌈

If you pass the -c/--omit-header flag, nfs4_getfacl will not display the comment header (Do not print filename). bye bye header πŸ‘‹

If you pass the --dacl flag, nfs4_getfacl will retrieve the dacl. heads up though β€” this functionality is only available if the server supports NFSv4 minor version 1 or newer 🧚

If you pass the --sacl flag, nfs4_getfacl will retrieve the sacl. same deal, bestie β€” this functionality is only available if the server supports NFSv4 minor version 1 or newer πŸ’œ

The output format for an NFSv4 file ACL, e.g., is:

# file: /somedir
A::OWNER@:rwatTnNcCy
A::alice@nfsdomain.org:rxtncy
A::bob@nfsdomain.org:rwadtTnNcCy
A:g:GROUP@:rtncy
D:g:GROUP@:waxTC
A::EVERYONE@:rtncy
D::EVERYONE@:waxTC

In the example output above, the user alice@nfsdomain.org has the equivalent of "read" and "execute" permissions, bob@nfsdomain.org has "read" and "write", and both GROUP@ and EVERYONE@ have "read". look at them, sharing the read permissions, so generous πŸ₯°

The ACL listings of multiple files are separated by blank lines. spacing! we love to see it ✨

Refer to the nfs4_acl(5) manpage for detailed information about NFSv4 ACL terminology and syntax. go read the lore, iykyk πŸ“–

πŸ‘‘ AUTHORS πŸ‘‘

nfs4_getfacl was written by people at CITI, the Center for Information Technology Integration (http://www.citi.umich.edu). This manpage was written by David Richter. absolute legends, no cap πŸ«‘πŸ’–


πŸ’Œ CONTACT πŸ’Œ

Please send bug reports, feature requests, and comments to <linux-nfs@vger.kernel.org>. they're literally waiting for your thoughts, don't be shy πŸŽ€


πŸ”₯ SEE ALSO πŸ”₯


and that's the whole page, bestie πŸ¦‹ this was the Linux version 0.3.4, August 2018 edition β€” slay, periodt, go read your ACLs πŸ’…βœ¨πŸŒΈ