ACL_GET_FLAG_NP(3)

✨ ACL_GET_FLAG_NP(3) ✨

okay so bestie, we're in the Library Functions Manual today, section 3, and the star of the show is acl_get_flag_np — say it with me: "check if a flag is set in a flagset." that's the whole vibe. 💅

---

🎀 NAME 🎀

acl_get_flag_np — check if a flag is set in a flagset

📚 LIBRARY 📚

Standard C Library (libc, -lc) — yeah she lives in libc, iconic behavior honestly 🫶

🌸 SYNOPSIS 🌸

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

int
acl_get_flag_np(acl_flagset_t flagset_d, acl_flag_t flag);

💖 DESCRIPTION 💖

so the acl_get_flag_np() function is a non-portable function (iykyk, that _np suffix is literally telling you she's not playing by POSIX rules) and what she does is check if a NFSv4 ACL flag is set in a flagset. that's it. that's the function. lowkey obsessed with how simple that is ✨

👑 RETURN VALUES 👑

here's the vibe check:

• if the flag in flag is set in the flagset flagset_d → you get a 1 🎉
• otherwise → you get a 0 🙈

one or zero, no in-between, no "maybe", periodt.

💀 ERRORS 💀

okay so if any of these conditions happen, the acl_get_flag_np() function will return a value of -1 and set the global variable errno to the corresponding value. not the slay outcome but we move:

• [EINVAL] — argument flag does not contain a valid ACL flag or argument flagset_d is not a valid ACL flagset. basically: one of your inputs is not giving what it needs to give 😭

🦋 SEE ALSO 🦋

the whole friend group, go say hi:

• acl(3)
• acl_add_flag_np(3)
• acl_clear_flags_np(3)
• acl_delete_flag_np(3)
• acl_get_flagset_np(3)
• acl_set_flagset_np(3)
• posix1e(3)

🌈 STANDARDS 🌈

POSIX.1e is described in IEEE POSIX.1e draft 17. yes, a draft, that's the lore fr fr 📜

⭐ HISTORY ⭐

POSIX.1e support was introduced in FreeBSD 4.0. the acl_get_flag_np() function was added in FreeBSD 8.0. glow-up timeline, honestly 💜

🧚 AUTHORS 🧚

the acl_get_flag_np() function was written by Edward Tomasz Napierala <trasz@FreeBSD.org> — thank you for your service king 🫡

---

bestie reminder: that -1 return means always check errno, and that _np means non-portable so don't take her on a world tour without checking first, k? 🍓

mwah, that's the page — brought to you by the Debian crew, dated October 30, 2014, and yes she's still serving looks all these years later 💅✨🎀