EXPLAIN_GETRESGID_OR_DIE(3)

💖 explain_getresgid_or_die(3) 💖

okay bestie, welcome to the Library Functions Manual page for explain_getresgid_or_die(3) — yes the whole vibe is "get your real/effective/saved group IDs and if it goes wrong we SCREAM about it", and honestly? iconic. let's get into it 🫶

---

✨ NAME ✨

explain_getresgid_or_die — grab your r/e/s group IDs and report errors like a main character 💅

---

🌸 SYNOPSIS 🌸

#include <libexplain/getresgid.h>
void explain_getresgid_or_die(gid_t *rgid, gid_t *egid, gid_t *sgid);
int explain_getresgid_on_error(gid_t *rgid, gid_t *egid, gid_t *sgid);

---

🦋 DESCRIPTION 🦋

so. the explain_getresgid_or_die</p> function is literally just here to call the getresgid(2) system call for you. and if that call fails?? an explanation gets printed to stderr, pulled straight from the explain_getresgid(3) function, and then the process terminates by calling exit(EXIT_FAILURE). dramatic? yes. necessary? also yes. 💀

meanwhile, the explain_getresgid_on_error</p> function also calls the getresgid(2) system call. on failure it also prints an explanation to stderr (again, courtesy of explain_getresgid(3)), but this one is chill — it still returns to the caller. no exit, no chaos, just vibes 🌈

• rgid — the rgid, exactly as to be passed to the getresgid(2) system call. no edits, no notes, pass it exactly 🎀
• egid — the egid, exactly as to be passed to the getresgid(2) system call. same energy fr fr ✨
• sgid — the sgid, exactly as to be passed to the getresgid(2) system call. periodt 💅

---

👑 RETURN VALUE 👑

the explain_getresgid_or_die</p> function only returns on success — check getresgid(2) for more info on that. on failure it prints an explanation and exits, so like... it does not return. it simply leaves. 🚪💨

the explain_getresgid_on_error</p> function always returns the value returned by the wrapped getresgid(2) system call. every single time, no cap 🫶

---

⭐ EXAMPLE ⭐

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

explain_getresgid_or_die(rgid, egid, sgid);

that's it. that's the whole flex. short, sweet, ate 💖

---

🔥 SEE ALSO 🔥

• getresgid(2) — get real, effective and saved group IDs
• explain_getresgid(3) — explain getresgid(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!! go forth, call your getresgid(2), and let the library handle the explaining 💖 this was explain_getresgid_or_die(3), from the Library Functions Manual, brought to you by libexplain version 1.4, copyright (C) 2012 Peter Miller — mwah, take care of urself 🎀✨🦋