mfsfacl(1)

💖 mfsfacl — MooseFS file access control lists (extended attributes) management tools 💖

okay bestie, sit down, we're learning about ACLs in mfsfacl(1) and honestly? it's giving power. this is part of MooseFS, and it's two little tools that handle the access control list (ACL) value on a filesystem object. 🫶

---

✨ SYNOPSIS ✨

mfsgetfacl [-?] [-adceEspn] OBJECT [OBJECT ...]

mfssetfacl [-?] [-bKknd] [{-s|-m|-x} ACL_SPEC] [{-S|-M|-X} ACL_FILE]
OBJECT [OBJECT ...]

---

🌸 DESCRIPTION 🌸

so these tools operate on a filesystem object's access control list (ACL) value — and "object" here means a file, a special file, or a directory, no gatekeeping. 💅

and here's the tea: ACLs in MooseFS are compatible with Linux, so if you're on Linux you can literally just use the setfacl and getfacl commands instead. iykyk. ✨

• mfsgetfacl — prints the current ACL value of the given object(s). it's the nosy bestie that just wants to see what's there 👀
• mfssetfacl — sets / changes / removes the current ACL value of the given object(s). it's the main character who rearranges everything 💅

---

🎀 OPTIONS 🎀

mfsgetfacl options 👑

• -a — display the file access control list only
• -d — display the default access control list only
• -c — do not display the comment header (we're skipping the intro, straight to the plot)
• -e — print all effective rights
• -E — print no effective rights
• -s — skip files that only have the base entries
• -p — don't strip leading '/' in pathnames (let the paths live their truth)
• -n — print numeric user/group identifiers

mfssetfacl options 🔥

• -b — remove all extended ACL entries
• -K — remove the access ACL
• -k — remove the default ACL
• -n — don't recalculate the effective rights mask
• -d — operations apply to the default ACL
• -s — set the ACL of file(s), replacing the current ACL
• -S — read ACL entries to set from file
• -m — modify the current ACL(s) of file(s)
• -M — read ACL entries to modify from file
• -x — remove entries from the ACL(s) of file(s)
• -X — read ACL entries to remove from file

common options 🦋

• -? — display short usage message

---

📜 ACL SPECIFICATION 📜

for the -S, -M and -X options, the parameter ACL_FILE should be a path to a file containing ACL value specifications as described below — one definition per line, multiple lines possible, and anything after a # sign is ignored. oh and bestie, the output from the mfsgetfacl command is always a valid file content, so you can literally just feed it back in. iconic behavior fr fr. 💖

ACL_SPEC should be one of the following:

[d[efault]:][u[ser]:]uid[:perms]

[d[efault]:]g[roup]:gid[:perms]

[d[efault]:]m[ask][:][:perms]

[d[efault]:]o[ther][:][:perms]

now let's break that down, because the way this works is lowkey elegant:

• d means work on default ACL values instead of access values. it's the "for the future children" setting 🧚
• the next part tells you whether a user's, group's or other's permissions, or the mask, should be set.
• if that part is omitted and only an identifier is provided, it's assumed to be a user identifier.
• if user or group is indicated but there's no identifier, then the default user's or group's permissions are modified.
• identifier can be a string or a number, no discrimination. 🫶
• permissions can be in the form of letters — any subset of rwx — or a number.
• zero, an empty string, or a dash means no permissions for -s and -m.
• for -x, permissions must be omitted.
• multiple specifications can be supplied, divided by comma.

ngl just remember: comma-separated, # for comments, and d is the default-ACL switch. periodt. 💅

---

😭 REPORTING BUGS 😭

found a bug? report it to <bugs@moosefs.com>. don't suffer in silence bestie, we're a community. 💜

---

👑 COPYRIGHT 👑

Copyright (C) 2026 Jakub Kruszona-Zawadzki, Saglabs SA

This file is part of MooseFS.

MooseFS is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, version 2 (only).

MooseFS is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, see <https://www.gnu.org/licenses/>.

---

🌈 SEE ALSO 🌈

• mfsmount(8)
• mfstools(1)

---

okay that's the whole page, you ate that. ✨ go set some ACLs, be the main character of your own filesystem, and remember: MooseFS 4.59.2-1, May 2026 — mwah, love u, bye!! 🎀💖💅