setuser(8)

💅 setuser(8) — your fave System Manager's Manual girlie 💅

okay so this one is from the System Manager's Manual, and it's literally the “run someone else's program as someone else” tool. bestie, it is root-only, no cap.

---

🌸 NAME 🌸

setuser — runs another program under a specified account's environment.

---

✨ SYNOPSIS ✨

setuser account child

---

🦋 DESCRIPTION 🦋

So account is a single argument. child consists of one or more arguments. slay, simple.

setuser sets $GID, $UID, $SHELL, $HOME, and $USER to account's gid number, uid number, login shell, home directory, and user name, respectively. it's giving very “match the account, match the vibe” energy.

It changes the working directory to account's home, and sets its uid and gid to account's uid and gid, with supplementary groups set up. then it runs child. iconic behavior, honestly.

⚠️ setuser cannot be run by anyone other than root. like, do not try it as a regular user, bestie — it's not gonna be the moment you think it is. 💀

---

🎀 EXIT CODES 🎀

setuser exits 111 if it cannot find a UNIX account named account, if it cannot setup the environment, change directory, setgid, setuid, or run child. otherwise its exit code is the same as that of child. periodt.

---

🌈 SEE ALSO 🌈

the whole friend group, fr fr:

• envdir(8)
• envini(8)
• envuidgid(8)
• fghack(8)
• multilog(8)
• pgrphack(8)
• readproctitle(8)
• setlock(8)
• setuidgid(8)
• softlimit(8)
• supervise(8)
• svc(8)
• svok(8)
• svscan(8)
• svscanboot(8)
• svstat(8)
• tai64n(8)
• tai64nlocal(8)

---

signing off from the System Manager's Manual, setuser(8) — no date on this footer bestie, it's giving timeless 🫶💖✨