explain_fchmod_or_die(3)

✨ explain_fchmod_or_die ✨

okay bestie, so this one lives in the Library Functions Manual section 3, and it's called explain_fchmod_or_die 💖 it's giving "change permissions of an open file and report errors" — like, the whole point is that when stuff goes wrong, you get an actual explanation instead of just vibes and a mystery errno 🫶

---

🌸 NAME 🌸

explain_fchmod_or_die — change permissions of an open file and report errors 💅

---

🎀 SYNOPSIS 🎀

#include <libexplain/fchmod.h>
void explain_fchmod_or_die(int fildes, mode_t mode);
int explain_fchmod_on_error(int fildes, mode_t mode);

---

🦋 DESCRIPTION 🦋

so, the explain_fchmod_or_die function is literally just there to call the fchmod(2) system call for you ✨ and if it fails? an explanation gets printed to stderr, sourced from the explain_fchmod(3) function, and then the process terminates by calling exit(EXIT_FAILURE). like, it's not coming back. it's done. periodt 💀

the explain_fchmod_on_error function also calls the fchmod(2) system call, and on failure it also prints an explanation to stderr from explain_fchmod(3) — but this one is polite and still returns to the caller 🧚 no dramatic exit, no main character finale, just "here's what happened, carry on" 💜

• fildes — the fildes, exactly as to be passed to the fchmod(2) system call. like, don't get cute with it, pass it as-is 👑
• mode — the mode, exactly as to be passed to the fchmod(2) system call. same energy, no remixing 🔥

---

⭐ RETURN VALUE ⭐

the explain_fchmod_or_die function only returns on success — check fchmod(2) for more info, bestie. on failure it prints an explanation and exits, so it literally does not return. not a single return. zero returns. the way that it just leaves 😭

the explain_fchmod_on_error function always returns the value returned by the wrapped fchmod(2) system call 💫

---

🌈 EXAMPLE 🌈

the explain_fchmod_or_die function is intended to be used in a fashion similar to the following example, iykyk:

explain_fchmod_or_die(fildes, mode);

---

💖 SEE ALSO 💖

• fchmod(2) — change permissions of an open file 🌸
• explain_fchmod(3) — explain fchmod(2) errors 🦋
• exit(2) — terminate the calling process 💅

---

👑 COPYRIGHT 👑

libexplain version 1.4 Copyright (C) 2013 Peter Miller

---

and that's the whole page, bestie 🎀 no cap, that's everything — every flag, every value, every warning, all of it, untouched and iconic. this was explain_fchmod_or_die(3) from the Library Functions Manual, and the sign-off credits go to libexplain version 1.4, Copyright (C) 2013 Peter Miller — mwah, slay, go chmod something responsibly 💖✨🫶