ACL_GET_PERMSET(3)

💖 acl_get_permset — bestie, let's get that permission set 💖

okay so you're deep in libacl (that's the Linux Access Control Lists library, aka libacl, link it with -lacl), and you need the permission set out of an ACL entry? say less. this is the acl_get_permset(3) page from the Library Functions Manual and it's about to be your new fave. 🫶

✨ NAME ✨

acl_get_permset — retrieve the permission set from an ACL entry

📚 LIBRARY 📚

Linux Access Control Lists library (libacl, -lacl). yes queen, link the library.

🌸 SYNOPSIS 🌸

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

int
acl_get_permset(acl_entry_t entry_d, acl_permset_t *permset_p);

🦋 DESCRIPTION 🦋

so the acl_get_permset() function hands you back, inside permset_p, a descriptor to the permission set living in the ACL entry that entry_d points at. it's giving "here's your lil handle, go wild." ✨

and the important part: any operations you do afterward using that returned permission set descriptor are operating on the permission set within the ACL entry itself. not a copy. the actual one. 💅

also, any ACL entry descriptors that refer to the entry that entry_d refers to? they shall continue to refer to those entries. no identity crises here, everybody keeps pointing where they were pointing. periodt.

🔥 RETURN VALUE 🔥

• returns the value 0 if it's successful — slay 💖
• otherwise returns the value -1, and the global variable errno gets set to indicate the error 😭

💀 ERRORS 💀

if any of these conditions happen, acl_get_permset() returns -1 and sets errno to the matching value:

• [EINVAL] — the argument entry_d is not a valid descriptor for an ACL entry. that's it, that's the one. not valid = not valid, bestie.

👑 STANDARDS 👑

IEEE Std 1003.1e draft 17 (“POSIX.1e”, abandoned)

ok lowkey the tea is that POSIX.1e was abandoned 🙈 but our girl acl_get_permset is still out here doing her thing, main character energy fr fr.

🌈 SEE ALSO 🌈

• acl_add_perm(3)
• acl_clear_perms(3)
• acl_delete_perm(3)
• acl_get_perm(3)
• acl_get_qualifier(3)
• acl_get_tag_type(3)
• acl_set_permset(3)
• acl_set_qualifier(3)
• acl_set_tag_type(3)
• acl(5)

🎀 AUTHOR 🎀

derived from the FreeBSD manual pages written by Robert N M Watson <rwatson@FreeBSD.org>, and adapted for Linux by Andreas Gruenbacher <andreas.gruenbacher@gmail.com>. shoutout to the legends who wrote this so we could vibe with ACLs today 🫶

and that's the whole page, bestie!! 💜 this was the Linux ACL manual page for acl_get_permset(3), dated March 23, 2002. go forth and retrieve those permission sets, you absolute icon 👑✨ no cap.