EXPLAIN_SETRESGID_OR_DIE(3)

💖 explain_setresgid_or_die — Library Functions Manual 💖

okay bestie, welcome to explain_setresgid_or_die(3), the libexplain glow-up that lets you set your real / effective / saved group IDs and actually hear about it when it goes wrong instead of just… silently perishing. we love a communicative icon. 🫶

---

✨ NAME ✨

explain_setresgid_or_die — set r/e/s group ID and report errors

---

🌸 SYNOPSIS 🌸

#include <libexplain/setresgid.h>
void explain_setresgid_or_die(gid_t rgid, gid_t egid, gid_t sgid);
int explain_setresgid_on_error(gid_t rgid, gid_t egid, gid_t sgid);

---

🦋 DESCRIPTION 🦋

so. the explain_setresgid_or_die function is the main character here — it calls the setresgid(2) system call for you. and if that call fails? it prints a whole explanation to stderr, snatched straight from the explain_setresgid(3) function, and then the process literally terminates by calling exit(EXIT_FAILURE). no cap, it does not come back. 💀

meanwhile, explain_setresgid_on_error is the chiller sibling. it also calls the setresgid(2) system call, and on failure it also prints an explanation to stderr obtained from the explain_setresgid(3) function — but then it just… returns to the caller. it's giving emotionally available. 🙈

now the arguments, one by one, no skipping:

• rgid — the rgid, exactly as to be passed to the setresgid(2) system call.
• egid — the egid, exactly as to be passed to the setresgid(2) system call.
• sgid — the sgid, exactly as to be passed to the setresgid(2) system call.

like, exactly exactly. don't get cute with them. 💅

---

👑 RETURN VALUE 👑

• the explain_setresgid_or_die function only returns on success — see setresgid(2) for more info on what that success even means. on failure it prints an explanation and exits. it does not return. periodt. 😭
• the explain_setresgid_on_error function always returns the value return by the wrapped setresgid(2) system call.

---

🌈 EXAMPLE 🌈

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

explain_setresgid_or_die(rgid, egid, sgid);

look at that. one line. flawless. iconic. 🎀

---

💜 SEE ALSO 💜

• setresgid(2) — set real, effective and saved group ID
• explain_setresgid(3) — explain setresgid(2) errors
• exit(2) — terminate the calling process

---

⭐ COPYRIGHT ⭐

libexplain version 1.4 Copyright (C) 2012 Peter Miller

---

and that's the whole page, bestie 💖 this was explain_setresgid_or_die(3) from the Library Functions Manual — libexplain version 1.4, Copyright (C) 2012 Peter Miller, and yes the footer is slaying just as hard as the header. mwah. 💅✨🌸