SETRUID(3)

💅 SETRUID(3) — Library Functions Manual 💅

okay bestie, this is the glow-up of the SETRUID(3) manual page — same facts, way more group-chat energy. Let’s get into it ✨

---

🌸 NAME 🌸

setruid, setrgid — set user and group ID

🧚 LIBRARY 🧚

Standard C Library (libc, -lc) — yes, she lives in libc, iconic behavior.

✨ SYNOPSIS ✨

#include <unistd.h>

int
setruid(uid_t ruid);

int
setrgid(gid_t rgid);

🦋 DESCRIPTION 🦋

The setruid() function (and setrgid(), her matching bestie) sets the real user ID (group ID) of the current process. lowkey straightforward, no cap.

🎀 RETURN VALUES 🎀

Upon successful completion, the value 0 is returned; otherwise the value -1 is returned and the global variable errno is set to indicate the error. so if you see -1, check errno — she’s trying to tell you something 💖

⚠️ COMPATIBILITY ⚠️

Heads up, bestie: The use of these calls is not portable. Their use is discouraged; they will be removed in the future. not a drill, fr fr 😭

🚨 ERRORS 🚨

The functions fail if:

• [EPERM] — The user is not the super user and the ID specified is not the real or effective ID.

🌈 SEE ALSO 🌈

getgid(2), getuid(2), setegid(2), seteuid(2), setgid(2), setuid(2) — go read the whole squad 🫶

💜 HISTORY 💜

The setruid() and setrgid() syscalls appeared in 4.2BSD and were dropped in 4.4BSD. historical icons, honestly 👑

---

Source/version + date moment: this page is from Debian, dated June 2, 1993, and the manual page is SETRUID(3). mwah 💋✨