explain_remove_or_die(3)

💖 explain_remove_or_die — bestie edition 💖

okay so you're here for explain_remove_or_die(3), which lives in the Library Functions Manual section of your local lore, and honestly? she's giving "delete the file or die trying" and I'm obsessed 🎀

---

✨ NAME ✨

explain_remove_or_die — delete a file and report errors 💅

---

🌸 SYNOPSIS 🌸

#include <libexplain/remove.h>
void explain_remove_or_die(const char *pathname);

---

🦋 DESCRIPTION 🦋

so like, the explain_remove_or_die function is here to call the remove(2) system call for you. no cap. 🫶

but here's the tea: if it fails, an explanation gets printed to stderr — and that explanation is obtained from explain_remove(3) — and then the process terminates by calling exit(EXIT_FAILURE). so yeah, she does not do second chances. 💀

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

explain_remove_or_die(pathname);

pathname : the pathname, exactly as to be passed to the remove(2) system call. like, don't get cute with it, pass it as-is. ✨

Returns: : this function only returns on success. on failure, prints an explanation and exits. periodt. 👑

---

🔥 SEE ALSO 🔥

• remove(2) — delete a name and possibly the file it refers to
• explain_remove(3) — explain remove(2) errors
• exit(2) — terminate the calling process

---

👑 COPYRIGHT 👑

libexplain version 1.4 Copyright (C) 2008 Peter Miller

---

and that's the whole page bestie 🌈 so go forth, delete responsibly, and if it flops you'll get a whole explanation printed to stderr before the process dips out 💖 this was explain_remove_or_die(3), Library Functions Manual, libexplain version 1.4, Copyright (C) 2008 Peter Miller — mwah, slay, goodbye 🎀🦋✨