ACL_EXTENDED_FILE_NP(3)

💅 ACL_EXTENDED_FILE_NP(3) — ok so this is a manual page from the Library Functions Manual, bestie, and it's about checking whether a file has extended ACLs 🎀

✨ NAME ✨

acl_extended_file_np, acl_extended_file_nofollow_np, acl_extended_link_np — these three besties check if the file has extended ACLs set 🦋

📚 LIBRARY 📚

Standard C Library (libc, -lc) — the classic, the icon, the one you link with -lc 💅

🧚 SYNOPSIS 🧚

#include <sys/types.h>
#include <sys/acl.h>

int
acl_extended_file_np(const char* path_p);

int
acl_extended_file_nofollow_np(const char* path_p);

int
acl_extended_link_np(const char* path_p);

🌸 DESCRIPTION 🌸

Okay so listen 👑 — acl_extended_file_np() is a non-portable call (iykyk, it's not POSIX-portable, it's a FreeBSD-ish situation) that checks whether the file or directory referred to by the argument path_p contains extended access ACLs.

Then acl_extended_file_nofollow_np() does literally the exact same thing, except it does not follow symlinks 🙈 — the way that it just refuses to chase the link, we stan.

And acl_extended_link_np() is a synonym for acl_extended_file_nofollow_np(), just named in FreeBSD style ✨.

Now, the important bit, the main character rule of the whole page 🫶: an ACL counts as an extended access one if it contains entries other than the three required entries of tag types ACL_USER_OBJ, ACL_GROUP_OBJ and ACL_OTHER. Like, those three are the bare minimum, the required trio — anything else and it's ~extended~ 💖

⭐ RETURN VALUES ⭐

Upon successful completion, this function returns 0 if the file object does not contain extended access ACLs, and 1 in the other case 🔥.

Otherwise, the value -1 is returned, and errno indicates the error 💀

🌈 ERRORS 🌈

If any of the following conditions occur, the acl_extended_file_np() function shall return a value of -1 and set errno to the corresponding value:

• EACCES — Search permission is denied for a component of the path prefix 😭

ngl there's exactly one error listed here and that's EACCES. Don't go inventing more, bestie 🙈

---

👀 SEE ALSO 👀

extattr_get_file(2), posix1e(3) — go read these next, fr fr 📖

📜 STANDARDS 📜

POSIX.1e is described in IEEE POSIX.1e draft 17 📄. Discussion of the draft continues on the cross-platform POSIX.1e implementation mailing list ✉️ — and to join this list, see the FreeBSD POSIX.1e implementation page for more information 🦋

🕰️ HISTORY 🕰️

POSIX.1e support was introduced in FreeBSD 4.0, and development continues 🔥 like it literally never stopped, slay 💅

💜 AUTHORS 💜

Gleb Popov 👑

---

okay that's the whole page, you ate it up 🍓 this queen of a page came from the Debian crew and is dated February 26, 2021 — mwah, periodt 💋✨