explain_setpgid_or_die(3)

💖 explain_setpgid_or_die(3) 💖

okay bestie, welcome to the Library Functions Manual page for explain_setpgid_or_die(3) — yes that's the whole manual name, we're not being weird about it, it's just the vibe ✨

---

🌸 NAME 🌸

explain_setpgid_or_die — set process group and report errors 🫶

---

✨ SYNOPSIS ✨

#include <libexplain/setpgid.h>
void explain_setpgid_or_die(pid_t pid, pid_t pgid);
int explain_setpgid_on_error(pid_t pid, pid_t pgid);

---

💅 DESCRIPTION 💅

So the explain_setpgid_or_die function is literally just there to call the setpgid(2) system call. And if that goes badly? An explanation gets printed to stderr — grabbed straight from the explain_setpgid(3) function — and then the process terminates by calling exit(EXIT_FAILURE). no coming back from that one, bestie 💀

Then there's explain_setpgid_on_error, which also calls the setpgid(2) system call. Same deal on failure: explanation printed to stderr, obtained from explain_setpgid(3). BUT — and this is the key difference, iykyk — this one still returns to the caller. she's giving graceful 🌈

• pid — the pid, exactly as to be passed to the setpgid(2) system call. no edits, no remixing, just hand it over as-is 💖
• pgid — the pgid, exactly as to be passed to the setpgid(2) system call. same energy, character for character 🎀

---

👑 RETURN VALUE 👑

explain_setpgid_or_die only returns on success — peep setpgid(2) for more info on that. On failure? It prints an explanation and exits. It does not return. periodt.

explain_setpgid_on_error always returns the value returned by the wrapped setpgid(2) system call. always. every single time. 🦋

---

🌟 EXAMPLE 🌟

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

explain_setpgid_or_die(pid, pgid);

like... that's it. that's the whole thing. slay 💅

---

🔥 SEE ALSO 🔥

• setpgid(2) — set process group
• explain_setpgid(3) — explain setpgid(2) errors
• exit(2) — terminate the calling process

---

🎀 COPYRIGHT 🎀

libexplain version 1.4 Copyright (C) 2011 Peter Miller

---

and that's a wrap on explain_setpgid_or_die(3) 🫶 this page came to you courtesy of libexplain version 1.4, copyright (C) 2011 Peter Miller — go forth and set those process groups, bestie, and may your stderr stay quiet 🌸✨💜