EXPLAIN_ACL_GET_FILE_OR_DIE(3)

💖 explain_ac...file_or_die(3) 💖

okay bestie, welcome to the Library Functions Manual ✨ this is the page for explain_acl_get_file_or_die and its lil sibling, and honestly? it's giving "your fave error-reporting glow-up" 💅

---

🌸 NAME 🌸

explain_acl_get_file_or_die — Execute acl_get_file(3) and report errors 🫶

---

✨ SYNOPSIS ✨

#include <libexplain/acl_get_file.h>
acl_t explain_acl_get_file_or_die(const char *pathname, acl_type_t
type);
acl_t explain_acl_get_file_on_error(const char *pathname, acl_type_t
type);

---

🦋 DESCRIPTION 🦋

so. the explain_acl_get_file_or_die function is literally just there to call the acl_get_file(3) system call for you 💫 and if things go sideways? an explanation gets printed to stderr (it gets that tea from the explain_acl_get_file(3) function, no cap), and then the process straight up terminates by calling exit(EXIT_FAILURE). dramatic? yes. necessary? also yes 💀

the explain_acl_get_file_on_error function also calls the acl_get_file(3) system call. on failure it prints an explanation to stderr too, obtained from the explain_acl_get_file(3) function, but this one is the chill sibling — it still returns to the caller instead of noping out 🎀

🍓 the arguments

• pathname — the pathname, exactly as to be passed to the acl_get_file(3) system call. like, exactly exactly, don't freestyle it 🌈
• type — the type, exactly as to be passed to the acl_get_file(3) system call. same energy, same rules 👑

---

🔥 RETURN VALUE 🔥

the explain_acl_get_file_or_die function only returns on success — peek at acl_get_file(3) if you want the full lore on that. on failure, it prints an explanation and exits. it does not return. it's gone. it said bye 🙈

the explain_acl_get_file_on_error function always returns the value return by the wrapped acl_get_file(3) system call 👑

---

🧚 EXAMPLE 🧚

the explain_acl_get_file_or_die function is intended to be used in a fashion similar to the following example, bestie:

acl_t result = explain_acl_get_file_or_die(pathname, type);

iconic. no further notes ✨

---

👑 SEE ALSO 👑

• acl_get_file(3) — Execute acl_get_file(3)
• explain_acl_get_file(3) — explain acl_get_file(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 🫶 go forth and let your errors explain themselves 💖

libexplain version 1.4 🌸 Copyright (C) 2013 Peter Miller — yeah that's the source and the version and the date-vibe, mwah 💅 see you in the next manpage, explain_ac...file_or_die(3) out 🎀✨