ACL_FROM_MODE_NP(3)

📦 version 15.1, in freebsd 14.5, freebsd 15.1

💅 ACL_FROM_MODE_NP(3) — acl_from_mode_np, bestie edition

okay so this is acl_from_mode_np from the Library Functions Manual, and it's literally the glow-up your mode bits have been waiting for ✨ It lives in the Standard C Library (libc, linked with -lc) — iconic behavior, no cap 🫶

🌸 SYNOPSIS 🌸

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

acl_t
acl_from_mode_np(const mode_t mode);

✨ DESCRIPTION ✨

So acl_from_mode_np() is that non-portable call — yes bestie, non-portable, we said what we said 💅 — and what it does is it takes the permissions set referred to by mode and converts it into the corresponding minimal ACL structure. Which is exactly what you want for applying to files, or for manipulating. It's giving "translate my vibe into ACL language" 🔥

⚠️ Heads up honey: this function causes memory to be allocated. The caller should free any free-able memory when the new ACL is no longer required, by calling acl_free(3) with the (void *)acl_t as an argument. Don't ghost your allocations, that's messy 😭

🦋 RETURN VALUES 🦋

Upon successful completion, the function returns a pointer to the internal representation of the ACL in working storage. Slay 💖

Otherwise? A value of (acl_t)NULL is returned, and errno is set to indicate the error. Sad but honest 🥲

🎀 ERRORS 🎀

If any of the following conditions occur, acl_from_mode_np() returns a value of (acl_t)NULL and sets errno to the corresponding value:

  • [ENOMEM] — the ACL working storage requires more memory than is allowed by the hardware or system-imposed memory management constraints. basically the memory said "no ❤️" 💀

🌈 SEE ALSO 🌈

go read them, iykyk 📚

👑 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. To join this list, see the FreeBSD POSIX.1e implementation page for more information. like, join the group chat, fr fr 💌

⭐ HISTORY ⭐

POSIX.1e support was introduced in FreeBSD 4.0, and development continues. it's giving longevity, main character energy 👑

🧚 AUTHORS 🧚

Gleb Popov — thank you for your service, we love you for this 🫶

and that's the whole page, bestie! this one's from the Debian build, dated January 20, 2021 — go forth and allocate responsibly, mwah 💜✨

📦 where this page comes from