ACL_DELETE_FLAG_NP(3)

📦 version 15.1, in freebsd 14.5, freebsd 15.1

💅 acl_delete_flag_np(3) — like, the whole manual page, bestie

okay so this is a page from the Library Functions Manual, section 3 — the acl_delete_flag_np joint. sit down, grab a strawberry drink 🍓, and let's get into it.

✨ NAME ✨

acl_delete_flag_np — delete flags from a flagset. that's it, that's the whole vibe. it removes stuff. icon behavior tbh 🎀

📚 LIBRARY 📚

Standard C Library (libc, -lc). the classic. the blueprint. no cap. 💖

🫶 SYNOPSIS 🫶

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

int
acl_delete_flag_np(acl_flagset_t flagset_d, acl_flag_t flag);

look at her. two includes, one function, zero drama. 🦋

🌸 DESCRIPTION 🌸

so the acl_delete_flag_np() function is a non-portable call — meaning pls don't expect it to travel well, she's a homebody — and what she does is she removes specific NFSv4 ACL flags from the flagset flags. literally just yeeting individual flags out of a flagset, one at a time, on purpose. no collateral damage, she's very precise about it. ✨

no cap, "non-portable" is the key phrase here — that's not me being shady, that's the manpage being honest with you. iykyk. 💅

👑 RETURN VALUES 👑

acl_delete_flag_np() returns the value 0 if successful — slay, we love a clean zero — otherwise the value -1 is returned and the global variable errno is set to indicate the error. so if you see -1, go check errno, she left you a note. 😭

💀 ERRORS 💀

the acl_delete_flag_np() function fails if:

  • [EINVAL] — Argument flagset_d is not a valid descriptor for a flagset. Argument flag does not contain a valid acl_flag_t value.

so like. either the flagset isn't a real flagset, or the flag isn't a real flag. wrong vibe check on one of the args, basically. 🙈

🎀 SEE ALSO 🎀

the whole friend group fr fr. go read them, they're all doing related things. 🫶

🌈 STANDARDS 🌈

POSIX.1e is described in IEEE POSIX.1e draft 17. that's the standard, that's the lore, that's the citation. ⭐

🧚 HISTORY 🧚

POSIX.1e support was introduced in FreeBSD 4.0. the acl_delete_flag_np() function was added in FreeBSD 8.0. so she's got lore, she's got a whole origin story, she's been around. 👑

💜 AUTHORS 💜

the acl_delete_flag_np() function was written by Edward Tomasz Napierala <trasz@FreeBSD.org>. give credit where credit is due, bestie, he wrote her. 🎀

aaand that's the page!! 🦋 mwah 💋 — this one's from Debian, dated October 30, 2014, and it's the ACL_DELETE_FLAG_NP(3) page, now with 100% more personality and 0% fewer facts. periodt. 💅✨🔥

📦 where this page comes from