explain_rename_or_die(3)

✨ explain_rename_or_die — NAME ✨

okay so bestie, welcome to explain_rename_or_die(3) from the Library Functions Manual 💖 this one is a lil rename-and-if-it-breaks-we-scream situation and honestly? iconic.

explain_rename_or_die — change the name of a file and report errors 🎀

---

🌸 SYNOPSIS 🌸

#include <libexplain/rename.h>
void explain_rename_or_die(const char *oldpath, const char *newpath);

like, that's the whole vibe. two strings in, chaos out. 🦋

---

💅 DESCRIPTION 💅

so the explain_rename_or_die function is your lil bestie that calls the rename(2) system call for you. but here's the tea: if it fails, it prints an explanation to stderr — and that explanation comes from explain_rename(3) — and then the process literally terminates by calling exit(EXIT_FAILURE). no cap. it does not play. 💀

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

explain_rename_or_die(oldpath, newpath);

oldpath — the oldpath, exactly as to be passed to the rename(2) system call. no extra seasoning, no improvising. 🍓

newpath — the newpath, exactly as to be passed to the rename(2) system call. same energy, same rules. 🍓

✨ Returns ✨

okay so listen — this function only returns on success. that's it. that's the whole deal. on failure, it prints an explanation and exits. so if you ever see a line of code after it, congrats, it worked. if not… well. 🫶

heads up bestie: on failure this thing does not come back. it prints the explanation and dips out via exit(EXIT_FAILURE). no return value, no second chance, no nothing. plan accordingly. 😭

---

👑 SEE ALSO 👑

• rename(2) — change the name or location of a file 🌈
• explain_rename(3) — explain rename(2) errors 🔥
• exit(2) — terminate the calling process 💜

---

🎀 COPYRIGHT 🎀

libexplain version 1.4 Copyright (C) 2008 Peter Miller

---

and that's the page, bestie 💖 libexplain version 1.4, Copyright (C) 2008 Peter Miller, and this lil manual page is literally called explain_rename_or_die(3) — slay, go rename something, and may your exit status always be zero ✨🦋🌸