ACL_FREE(3)

💖 ACL_FREE — release memory allocated to an ACL data object 💖

okay bestie, welcome to acl_free(3), straight out of the Library Functions Manual ✨ it lives in the Linux Access Control Lists library — that's libacl, and you link it with -lacl. 🎀

✨ SYNOPSIS ✨

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

int
acl_free(void *obj_p);

🧚 DESCRIPTION 🧚

so basically, acl_free() frees any releasable memory that's currently allocated to the ACL data object that obj_p points at. no cap, that's the whole job. 🫶

and the way that obj_p is flexible?? iconic. it can point at:

• an ACL
• an ACL entry qualifier
• a pointer to a string that was allocated by acl_to_text()

so like, three totally different vibes, one cleanup function. slay. 💅

👑 RETURN VALUE 👑

acl_free() returns the value 0 if it's successful ✨ otherwise it returns -1, and the global variable errno gets set to tell you what went wrong. not me being dramatic but like. respect the errno. 😭

💀 ERRORS 💀

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

• [EINVAL] — the value of the argument obj_p is invalid. 💀

bestie this is the only error listed here. if you see EINVAL, your obj_p is simply not it. 🙈

🌈 STANDARDS 🌈

IEEE Std 1003.1e draft 17 (“POSIX.1e”, abandoned) — yeah it's abandoned, don't ask, we don't talk about it, it's giving ghosted. 💀

🦋 SEE ALSO 🦋

• acl_copy_int(3)
• acl_create_entry(3)
• acl_dup(3)
• acl_from_text(3)
• acl_get_fd
• acl_get_file(3)
• acl_init(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>. absolute legends, we stan. 👑

and that's the whole page, bestie!! this one came from the Linux ACL crew and it's dated March 23, 2002, filed under ACL_FREE(3) in the Library Functions Manual. go free your memory, you're doing amazing sweetie 💖✨🌸