GFSETFACL(1)

✨ GFSETFACL(1) ✨

okay bestie, sit down, hydrate, and let me tell you about gfsetfacl 💅 this is a Gfarm manual page, page one of section one, and it is literally the tool that tells your files who's allowed to do what. no cap.

---

🌸 NAME 🌸

gfsetfacl — set Gfarm file access control lists 🎀

---

🦋 SYNOPSIS 🦋

gfsetfacl [options] [path...]

---

💖 DESCRIPTION 💖

gfsetfacl changes the Access Control List (ACL) of files or directories in the Gfarm filesystem. that's it, that's the whole job, and it eats every single time 👑

---

✨ OPTIONS ✨

• -b — removes all extended ACL entries. (the base ACL entries of the owner, group and others are not removed — those ones are staying, periodt.)
• -k — removes the only Default ACL. bye bestie 🫶
• -n — do not recalculate the mask entry of the ACL. the default behavior of gfsetfacl is to recalculate the mask entry, if a mask entry is not explicitly given. (so like, this is the "actually, don't" option 🙈)
• -r — always recalculate the mask entry of the ACL. (Even if a mask entry is explicitly given.) (See the -n option.) it's giving "we are recalculating no matter what, idc" 🔥
• -t — is test mode. instead of changing the ACL of any files or directories, the ACL text of input text and the new ACL text are displayed. window shopping, not buying 🛍️✨
• -m acl_spec — this option specifies the ACL entries text to add/replace the ACL entries of a Gfarm files or directories. multiple ACL entries are separated by comma characters (`,').
• -M acl_file — this option specifies the file or standard input (`-') to add/replace the ACL entries of a Gfarm files or directories. this input of ACL file accepts the output of gfgetfacl command. (piping, my beloved 🧚)
• -R — changes ACL recursively. the whole tree. every last one. 🌈
• -? — displays a list of command options. when in doubt, ask the question mark bestie 💀

---

🎀 ACL ENTRIES 🎀

the gfsetfacl command recognizes the following ACL entry formats. the perms field is a combination of characters that indicate the permissions: read (r), write (w), execute (x). a Default ACL entry has a d[efault:] prefix.

• [d[efault:]u[ser]::perms — permissions of owner. 👑
• [d[efault:]u[ser]:username:perms — permissions of a named user.
• [d[efault:]g[roup]::perms — permissions of a file group.
• [d[efault:]g[roup]:groupname:perms — permissions of a named group.
• [d[efault:]m[ask]::perms — mask of effective rights. 🎭
• [d[efault:]o[ther]::perms — permissions of others.

---

⭐ EXAMPLES ⭐

Granting read access to a named user 🌸

gfsetfacl -m u:testuser:r filename

Replacing the ACL of filename2 by filename1 🔁

gfgetfacl filename1 | gfsetfacl -b -M - filename2

ACL text of long form 📜

# comment
user::rw-
user:testuser:rw-       #effective:r--
group::r--
group:testgroup:rw-     #effective:r--
mask::r--
other::r--
default:user::rwx
default:group::r-x
default:other::r-x

ACL text of short form ⚡

u::rw,u:user1:rw,g::r,g:group1:rw,m::r,o::r,d:u::rwx,d:g::rx,d:o::rx

---

🌈 SEE ALSO 🌈

gfgetfacl(1) — the other half of the duo, the reading to this writing, iykyk 💜

---

and that's the whole page bestie, no notes, ate and left no crumbs 🍓

Gfarm 🌸 this one's dated 28 Sep 2020 and it's the GFSETFACL(1) page, so go forth and set those ACLs responsibly, mwah 💖✨