explain_pipe2_or_die(3)

💖 explain_pipe2_or_die 💖

okay bestie, you found the <libexplain/pipe2.h> page, aka the Library Functions Manual entry for explain_pipe2_or_die — and yes she's a whole vibe. let's get into it 🫶

---

✨ NAME ✨

explain_pipe2_or_die — create pipe and report errors

---

🌸 SYNOPSIS 🌸

#include <libexplain/pipe2.h>
void explain_pipe2_or_die(int *fildes, int flags);
int explain_pipe2_on_error(int *fildes, int flags);

---

💅 DESCRIPTION 💅

so like, there are two functions here and they're sisters, not twins, okay?

• explain_pipe2_or_die — she's the dramatic one. she calls the pipe2(2) system call, and if things go sideways, an explanation gets printed to stderr (obtained from the explain_pipe2(3) function), and then the process terminates by calling exit(EXIT_FAILURE). no survivors. periodt. 💀
• explain_pipe2_on_error — she's the chill one. she also calls the pipe2(2) system call, and on failure an explanation is still printed to stderr, obtained from the explain_pipe2(3) function — but she still returns to the caller. she just tells you what happened and keeps it moving. 🦋

now the arguments, because details matter:

• fildes — the fildes, exactly as to be passed to the pipe2(2) system call. no notes, no edits, pass it through as-is. ✨
• flags — the flags, exactly as to be passed to the pipe2(2) system call. same energy. 💖

---

⭐ RETURN VALUE ⭐

explain_pipe2_or_die only returns on success — see pipe2(2) for more information. on failure she prints an explanation and exits, so like... she does not return. at all. she's gone. 👑

explain_pipe2_on_error always returns the value returned by the wrapped pipe2(2) system call. every single time. reliable queen. 🎀

---

🌈 EXAMPLE 🌈

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

explain_pipe2_or_die(fildes, flags);

that's it. that's the whole thing. iconic, honestly. 💜

---

🧚 SEE ALSO 🧚

• pipe2(2) — create pipe
• explain_pipe2(3) — explain pipe2(2) errors
• exit(2) — terminate the calling process

---

🍓 COPYRIGHT 🍓

libexplain version 1.4 Copyright (C) 2013 Peter Miller

---

and that's the page bestie!! 🌸 libexplain version 1.4, copyright 2013 Peter Miller — go forth and pipe responsibly, mwah 💋💅✨