explain_setregid_or_die(3)

💖 explain_setregid_or_die(3) 💖

okay bestie, welcome to the libexplain manual, section 3 (that's Library Functions, for the uninitiated ✨). this one's all about explain_setregid_or_die — she sets your real and/or effective group ID, and if anything goes sideways she tells you why before she dips. iconic behaviour, honestly.

---

🌸 NAME 🌸

explain_setregid_or_die — set real and/or effective group ID and report errors 🫶

---

✨ SYNOPSIS ✨

#include <libexplain/setregid.h>
void explain_setregid_or_die(gid_t rgid, gid_t egid);
int explain_setregid_on_error(gid_t rgid, gid_t egid);

---

💅 DESCRIPTION 💅

so there's these two functions and they're basically sisters, okay. both of them call the setregid(2) system call. the difference is what they do when things go wrong.

the explain_setregid_or_die function is used to call the setregid(2) system call. on failure, an explanation gets printed to stderr — and that explanation comes straight from the explain_setregid(3) function — and then the process terminates by calling exit(EXIT_FAILURE). yeah. she does not play. it's giving "we ride at dawn or we don't ride at all" 💀

the explain_setregid_on_error function is used to call the setregid(2) system call too. on failure, an explanation also gets printed to stderr, also obtained from the explain_setregid(3) function — but this one still returns to the caller. she's the chill sister. she tells you what happened and lets you keep going 🧚

now the args, and yes you have to get these exactly right:

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

literally just pass them through unchanged, bestie. no remixing, no editing, no "improving". pass them exactly as they are. 👑

---

🦋 RETURN VALUE 🦋

the explain_setregid_or_die function only returns on success — see setregid(2) for more information. on failure, it prints an explanation and exits. it does not return. like, at all. that's the whole bit. no cap. 😭

the explain_setregid_on_error function always returns the value return by the wrapped setregid(2) system call.

---

🎀 EXAMPLE 🎀

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

explain_setregid_or_die(rgid, egid);

look at her go. so clean. so demure. so mindful. ⭐

---

🌈 SEE ALSO 🌈

• setregid(2) — set real and/or effective group ID
• explain_setregid(3) — explain setregid(2) errors
• exit(2) — terminate the calling process

---

👑 COPYRIGHT 👑

libexplain version 1.4

Copyright (C) 2012 Peter Miller

---

okay that's the whole page, you ate that fr fr 💖✨ go set some group IDs responsibly, bestie — and remember, one of these functions will literally end your whole process if you fumble it, so choose wisely 🫶🌸 this has been the explain_setregid_or_die(3) page, brought to you by libexplain version 1.4, copyright (C) 2012 Peter Miller. slay. 💅🎀