ACL_GET_FLAGSET_NP(3)

💅 ACL_GET_FLAGSET_NP(3) — the Library Functions Manual page, bestie edition

okay so this is acl_get_flagset_np, from section 3 of the Library Functions Manual, and it's genuinely such a handy little vibe check for your NFSv4 ACL entries 🦋

✨ NAME ✨

acl_get_flagset_np — retrieve flagset from an NFSv4 ACL entry

📚 LIBRARY 📚

Standard C Library (libc, -lc) — she's built right in, no extra shopping trip required 🎀

🫶 SYNOPSIS 🫶

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

int
acl_get_flagset_np(acl_entry_t entry_d, acl_flagset_t *flagset_p);

🌸 DESCRIPTION 🌸

So acl_get_flagset_np() is a non-portable call (iykyk — it's a _np function, she does not promise to exist everywhere, periodt). What she does is return, via flagset_np_p, a descriptor to the flagset inside the NFSv4 ACL entry entry_d.

And here's the cute part: any operations you do afterwards using that returned flagset are literally operating on the flagset within the ACL entry — same flagset, not a copy 💫

💖 RETURN VALUES 💖

• Returns the value 0 if it slayed (i.e. succeeded) 👑
• Otherwise it returns the value -1, and the global variable errno gets set to tell you exactly what went wrong 😭

🔥 ERRORS 🔥

It fails — like, actually fails — if:

• [EINVAL] — the argument entry_d is not a valid descriptor for an ACL entry. not a real entry, bestie, no flagset for you 🙈

👀 SEE ALSO 👀

acl(3), acl_add_flag_np(3), acl_clear_flags_np(3), acl_delete_flag_np(3), acl_set_flagset_np(3), posix1e(3) — the whole friend group fr fr 🫶

⭐ STANDARDS ⭐

POSIX.1e is described in IEEE POSIX.1e draft 17.

🦋 HISTORY 🦋

POSIX.1e support was introduced in FreeBSD 4.0. The acl_get_flagset_np() function was added in FreeBSD 8.0. she's been iconic for a while now 💅

🌈 AUTHORS 🌈

The acl_get_flagset_np() function was written by Edward Tomasz Napierala <trasz@FreeBSD.org>. king behavior, honestly 👑

---

and that's the whole page, no cap 🧚 this Debian build of the manpage is dated October 30, 2014 — go forth and go get those flagsets, bestie, you're gonna eat 💜🍓