explain_link_or_die(3)

💖 explain_link_or_die(3) 💖

okay bestie, welcome to the Library Functions Manual — this one's short, sweet, and honestly kind of iconic ✨

---

🌸 NAME 🌸

explain_link_or_die — make a new name for a file and report errors 🫶

---

✨ SYNOPSIS ✨

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

---

💅 DESCRIPTION 💅

so like. the explain_link_or_die function is the girl who calls the link(2) system call for you. and if things go ✨wrong✨? she prints an explanation straight to stderr — that explanation comes from explain_link(3) — and then she ends the whole process by calling exit(EXIT_FAILURE). no cap, that's the whole vibe. 💀

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

explain_link_or_die(oldpath, newpath);

• oldpath — the oldpath, exactly as to be passed to the link(2) system call. like, don't get creative with it, hand it over as-is 🌸
• newpath — the newpath, exactly as to be passed to the link(2) system call. same energy, exactly as-is 🎀

Returns:

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

ngl bestie, "only returns on success" is doing a LOT of heavy lifting in that sentence — if it fails, you literally do not come back. plan accordingly 😭

---

🦋 SEE ALSO 🦋

• link(2) — make a new name for a file
• explain_link(3) — explain link(2) errors
• exit(2) — terminate the calling process

---

👑 COPYRIGHT 👑

• libexplain version 1.4 ⭐
• Copyright (C) 2008 Peter Miller 💜

---

okay that's the whole page, you ate that 🍓 and for the cute sign-off: this lil masterpiece lives under the header explain_link_or_die(3), comes to you courtesy of libexplain version 1.4, and it's copyright 2008 Peter Miller — mwah, go link some files bestie 💖✨🦋