explain_access_or_die(3)

💖 NAME 💖

explain_access_or_die — bestie, this one checks the permissions on a file and then tells you all about it if something goes wrong 🎀

---

✨ SYNOPSIS ✨

#include <libexplain/libexplain.h>
void explain_access_or_die(const char *pathname, int mode);

---

🦋 DESCRIPTION 🦋

Okay so explain_access_or_die is the moment you call the access(2) system call, and then — this is the important part — it actually checks the result. No vibes-only permission checking here, we verify 💅

If it fails, it prints out a whole explanation of the error, which it gets from explain_access(3), and then it literally ends everything by calling exit(EXIT_FAILURE). Dramatic? Yes. Effective? Also yes.

explain_access_or_die(pathname, mode);

• pathname — the pathname, exactly as to be passed to the access(2) system call. Like, don't get creative with it, pass it exactly the way access(2) wants it 🫶
• mode — the mode, exactly as to be passed to the access(2) system call. Same deal, exactly as-is, no notes ✨

Returns:

• Only ever return on success. On failure process will exit.

💀 fr fr: if this thing fails, your process is gone. It exits. That's the whole bit. On success you get to keep vibing, but failure means exit(EXIT_FAILURE) and no further yapping.

---

👑 COPYRIGHT 👑

libexplain version 1.4 Copyright (C) 2008 Peter Miller

---

🌸 AUTHOR 🌸

Written by Peter Miller <pmiller@opensource.org.au> — an actual icon, we stan 🌈

---

And that's a wrap, bestie! This was the explain_access_or_die(3) page from the <span>Library Functions Manual</span>, footer and all — you already got the title folded in up top and now the source deets right here at the end. Go forth and check those permissions, you've got this 💜✨