explain_dup2_or_die(3)

💖 explain_dup2_or_die — bestie edition 💖

okay so this is a page from the libexplain library, manual section 3, and it's about the lil function called explain_dup2_or_die. yes the name is dramatic. no it's not being extra, it literally means what it says 🫶

---

✨ NAME ✨

explain_dup2_or_die — duplicate a file descriptor and report errors

like. that's the whole job. dup a file descriptor, and if it goes wrong, tell you why instead of just vibing in silence 💅

---

🌸 SYNOPSIS 🌸

#include <libexplain/dup2.h>
void explain_dup2_or_die(int oldfd, int newfd);

that's it. two ints in, and one of two outcomes out. iconic behaviour honestly ✨

---

🦋 DESCRIPTION 🦋

so here's the tea, bestie 🍓

the explain_dup2_or_die function is used to call the dup2(2) system call. simple enough, right? but here's the twist: on failure, an explanation gets printed to stderr, and that explanation is obtained from explain_dup2(3). and then, because this function is not about second chances, the process terminates by calling exit(EXIT_FAILURE).

so like. it either works, or it explains itself and then immediately exits. no in-between. no "let me think about it". main character energy fr fr 😭

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

explain_dup2_or_die(oldfd, newfd);

that's the whole vibe. you just call it and let it cook 🔥

oldfd — the oldfd, exactly as to be passed to the dup2(2) system call.

newfd — the newfd, exactly as to be passed to the dup2(2) system call.

like, no extra seasoning, no secret remixing. whatever you'd hand to dup2(2) is exactly what you hand to this. periodt 👑

Returns:

this function only returns on success. on failure, it prints an explanation and exits. that's it, that's the deal. if you got your return value back, congrats, you ate 💅 if you didn't... you're not around to read about it anymore 🙈

---

🌈 SEE ALSO 🌈

• dup2(2) — duplicate a file descriptor
• explain_dup2(3) — explain dup2(2) errors
• exit(2) — terminate the calling process

iykyk, go read these next, they're all connected bestie 🧚

---

👑 COPYRIGHT 👑

libexplain version 1.4 Copyright (C) 2008 Peter Miller

---

okay and that's the whole page!! tysm for reading my little manual moment, this was explain_dup2_or_die(3) from the Library Functions Manual, brought to you by libexplain version 1.4, copyright 2008 Peter Miller — stay dup-ing responsibly, bestie, mwah 💖✨🎀