ACL_CHECK(3)

📦 version 2.4.0, in alpine 3.22, alpine 3.23, alpine 3.24, arch rolling, centos-stream 10, centos-stream 9, debian bookworm, debian trixie, fedora 43, fedora 44, nixpkgs unstable, opensuse-leap 16.0, ubuntu jammy, ubuntu noble, ubuntu resolute, ubuntu stonking

💖 ACL_CHECK(3) — Library Functions Manual 💖

okay so bestie, welcome to the libacl corner of the internet, we're doing error messages today and honestly? it's giving helpful. 🎀

✨ NAME ✨

acl_error — convert an ACL error code to a text message 🦋

📚 LIBRARY 📚

Linux Access Control Lists library (libacl, -lacl). yep, that's the one, that's the vibe. 💅

🌸 SYNOPSIS 🌸

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

const char *
acl_error(int code);

👑 DESCRIPTION 👑

so the acl_error() function does one (1) thing and it does it flawlessly: it takes an ACL error code — like, the kind of thing acl_check() hands you — and turns it into a text message describing whatever went wrong. it's the translator bestie. it speaks fluent "error code" and fluent "human". 🫶

and in the “POSIX” locale, acl_check() returns these descriptions for these error codes, no cap:

  • ACL_MULTI_ERROR — “Multiple entries” 🔥
  • ACL_DUPLICATE_ERROR — “Duplicate entries” 😭
  • ACL_MISS_ERROR — “Missing or wrong entry” 💀
  • ACL_ENTRY_ERROR — “Invalid entry type” 🙈

⭐ RETURN VALUE ⭐

if the error code is recognized, acl_error() returns a text message. slay.

if it's not recognized, you get a value of (const char *)NULL instead. so like… check for that. don't be out here dereferencing NULL, that's not the main character move. 🌈

📏 STANDARDS 📏

okay so this is a non-portable, Linux specific extension to the ACL manipulation functions defined in IEEE Std 1003.1e draft 17 (“POSIX.1e”, abandoned). yes bestie, abandoned. we still use it. iconic behaviour honestly. 👑

🔍 SEE ALSO 🔍

🎀 AUTHOR 🎀

Written by Andreas Gruenbacher <andreas.gruenbacher@gmail.com>. thank you king, we appreciate you. 🫶

that's the whole page bestie, go forth and convert your error codes. ✨

mwah 💋 — this was Linux ACL, from way back on March 23, 2002, filed under ACL_CHECK(3). 🦋💖

📦 where this page comes from