EXPLAIN_ACL_SET_FD_OR_DIE(3)

💖 explain_acl_set_fd_or_die 💖

okay bestie, welcome to the Library Functions Manual entry for explain_acl_set_fd_or_die — yes that name is a whole mouthful, but it's lowkey iconic, trust. grab a boba, we're doing this 🧋✨

---

✨ NAME ✨

explain_acl_set_fd_or_die — set an ACL by file descriptor and report errors 🎀

---

🦋 SYNOPSIS 🦋

#include <libexplain/acl_set_fd.h>
void explain_acl_set_fd_or_die(int fildes, acl_t acl);
int explain_acl_set_fd_on_error(int fildes, acl_t acl);

---

💅 DESCRIPTION 💅

so there's two functions here and they're sisters, not twins, okay?

The explain_acl_set_fd_or_die function is used to call the acl_set_fd(3) system call. On failure an explanation will be printed to stderr, obtained from the explain_acl_set_fd(3) function, and then the process terminates by calling exit(EXIT_FAILURE). yeah. it literally ends it. no cap 💀

The explain_acl_set_fd_on_error function is used to call the acl_set_fd(3) system call. On failure an explanation will be printed to stderr, obtained from the explain_acl_set_fd(3) function, but still returns to the caller. she's the chill one 🫶

• fildes — The fildes, exactly as to be passed to the acl_set_fd(3) system call. exactly. like, don't get cute with it 🌸
• acl — The acl, exactly as to be passed to the acl_set_fd(3) system call. same energy, same rule ✨

---

🌈 RETURN VALUE 🌈

The explain_acl_set_fd_or_die function only returns on success, see acl_set_fd(3) for more information. On failure, prints an explanation and exits, it does not return. like she said what she said and then she LEFT 👑

The explain_acl_set_fd_on_error function always returns the value return by the wrapped acl_set_fd(3) system call.

---

🍓 EXAMPLE 🍓

The explain_acl_set_fd_or_die function is intended to be used in a fashion similar to the following example:

explain_acl_set_fd_or_die(fildes, acl);

that's it. that's the whole vibe. short, sweet, slays 💖

---

👑 SEE ALSO 👑

• acl_set_fd(3) — set an ACL by file descriptor
• explain_acl_set_fd(3) — explain acl_set_fd(3) errors
• exit(2) — terminate the calling process

---

🌸 COPYRIGHT 🌸

libexplain version 1.4 Copyright (C) 2013 Peter Miller

---

and that's the whole page bestie, we ate and left absolutely no crumbs 🎀💅

mwah, sending you off with the full legal tea: this is libexplain version 1.4, Copyright (C) 2013 Peter Miller — and yeah the footer is literally just the title again because manpages love to repeat themselves, periodt 💜

bye pookie, go set some ACLs responsibly 🦋⭐