explain_dup_or_die(3)

💖 explain_dup_or_die(3) 💖

okay bestie, welcome to the Library Functions Manual, and today's main character is explain_dup_or_die — she duplicates a file descriptor AND tells you what went wrong when it goes wrong. no cap. 🦋

---

✨ NAME ✨

explain_dup_or_die — duplicate a file descriptor and report errors 💅

---

🌸 SYNOPSIS 🌸

#include <libexplain/dup.h>
void explain_dup_or_die(int fildes);

like, that's the whole vibe. two lines. iconic.

---

👑 DESCRIPTION 👑

so the explain_dup_or_die function is literally just here to call the dup(2) system call for you. that's the job. that's the assignment. 🎀

and if it fails?? bestie, it prints an explanation to stderr — and that explanation comes straight from explain_dup(3), so you're getting the good stuff, not some cryptic nonsense — and then the process terminates by calling exit(EXIT_FAILURE). yeah, she does not do second chances. it's giving "die" in the name for a reason 😭

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

explain_dup_or_die(fildes);

and here's the deets on that argument, no gatekeeping:

• fildes — The fildes, exactly as to be passed to the dup(2) system call. like, don't get cute with it, pass it exactly. ✨

Returns:

this function only returns on success. on failure, it prints an explanation and exits. periodt. 💀

---

💜 SEE ALSO 💜

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

go read those, iykyk 🫶

---

🌈 COPYRIGHT 🌈

libexplain version 1.4

Copyright (C) 2008 Peter Miller

---

okay that's the whole page, bestie!! 💖 thanks for reading all the way to the bottom, you're a real one. this was explain_dup_or_die(3) from the Library Functions Manual, brought to you by libexplain version 1.4, Copyright (C) 2008 Peter Miller — mwah, slay, go duplicate some file descriptors responsibly. 🌸💅✨