ACL_SET_FLAGSET_NP(3)

πŸ“¦ version 15.1, in freebsd 14.5, freebsd 15.1

πŸ’… acl_set_flagset_np(3) β€” NFSv4 ACL flagset energy πŸ¦‹

okay so real talk: this page is from the Library Functions Manual, and it's here to help you set the flags on an NFSv4 ACL entry. It's giving very specific, very non-portable, and honestly kinda iconic. Periodt. ✨


🌸 NAME 🌸

acl_set_flagset_np β€” set the flags of an NFSv4 ACL entry πŸ’–

πŸ“š LIBRARY πŸ“š

Standard C Library (libc, -lc) 🫢

✨ SYNOPSIS ✨

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

int
acl_set_flagset_np(acl_entry_t entry_d, acl_flagset_t flagset_d);

πŸŽ€ DESCRIPTION πŸŽ€

The acl_set_flagset_np() function is a non-portable call, bestie β€” so like, it's not out here being all universal. It sets the flags of the NFSv4 ACL entry entry_d with the flags contained in flagset_d.

This call brands the ACL as NFSv4. Yup, it's a whole branding moment. πŸ‘‘

βœ… RETURN VALUES βœ…

acl_set_flagset_np() returns the value 0 if successful. Otherwise, it returns -1 and the global variable errno is set to indicate the error. So if you see -1, check errno, okay? 😭

🚨 ERRORS 🚨

The acl_set_flagset_np() function fails if:

  • [EINVAL] β€” Argument entry_d is not a valid descriptor for an ACL entry. ACL is already branded as POSIX.1e. 🫠

πŸ‘€ SEE ALSO πŸ‘€

acl(3), acl_add_flag_np(3), acl_clear_flags_np(3), acl_delete_flag_np(3), acl_get_brand_np(3), acl_get_flagset_np(3), posix1e(3) β€” go read these if you want the full lore. iykyk πŸ’…

πŸ“œ STANDARDS πŸ“œ

POSIX.1e is described in IEEE POSIX.1e draft 17. That's the standard tea. 🍡

πŸ•°οΈ HISTORY πŸ•°οΈ

POSIX.1e support was introduced in FreeBSD 4.0. The acl_set_flagset_np() function was added in FreeBSD 8.0. We love a historical moment. 🌈

✍️ AUTHORS ✍️

The acl_set_flagset_np() function was written by Edward Tomasz Napierala <trasz@FreeBSD.org>. Iconic behavior, honestly. 🫢


Reminder bestie: this call brands the ACL as NFSv4, and it's non-portable. Don't be surprised if the universe (or another OS) doesn't play along. πŸ’€

This lil page came from Debian, dated October 30, 2014 β€” and it's still out here serving manual-page realness. πŸŽ€βœ¨

πŸ“¦ where this page comes from