VUSU(1)

💖 VUSU 💖

okay so bestie, gather round, because this is vusu from the General Commands Manual and it's literally the tool that sets the default networking stack. yes, the whole stack. she's an icon, she's a legend, and she's about to be your new fave.

---

✨ NAME ✨

vusu — set the default networking stack 🫶

---

✨ SYNOPSIS ✨

vusu [options] [-] [user [*argment...]]

---

✨ DESCRIPTION ✨

so vusu lets you run commands with a substitute user and group ID (in VUOS, mwah 💅). but heads up, it needs a module loaded in VUOS that's able to redefine uid/gid, like unrealuidgid. no module, no magic, iykyk.

when you call it with zero arguments, vusu defaults to running an interactive shell as (virtual) root. main character energy fr.

for compatibility with su(1), vusu defaults to not changing the current directory, and to only setting the environment variables HOME and SHELL (plus USER and LOGNAME if the target user is not root). so lowkey it's keeping things minimal.

⚠️ but bestie, it is recommended to always use the --login option (instead of its shortcut -) to avoid side effects caused by mixing environments. mixing environments is giving chaos, and not the cute kind. 😭

---

✨ OPTIONS ✨

• -c command, --command command — pass command to the shell with the -c option. 🐚
• -, -l, --login — start the shell as a login shell with an environment similar to a real login. the way that it does all of this:
  • clears all the environment variables except TERM
  • initializes the environment variables HOME, SHELL, USER, LOGNAME, and PATH
  • changes to the target user's home directory
  • sets argv[0] of the shell to - in order to make the shell a login shell
• -m, -p, --preserve-environment — preserve the entire environment, i.e. it does not set HOME, SHELL, USER nor LOGNAME. 💀 note that this option is ignored if the option --login is specified. like, ignored ignored.
• -s shell, --shell shell — run the specified shell instead of the default. the shell to run is selected according to the following rules, in order:
  • the shell specified with --shell
  • the shell specified in the environment variable SHELL, if the --preserve-environment option is used
  • the shell listed in the passwd entry of the target user
  • /bin/sh
• -h, --help — display a short help message and exit. slay, short and sweet. 🎀

---

✨ SEE ALSO ✨

umvu(1), su(1) — go read those too, bestie, they're part of the lore 🌸

---

✨ AUTHOR ✨

VirtualSquare. Project leader: Renzo Davoli. (most of this man page is a derivative work from su(1) man page) 👑

---

and that's the whole vibe, babe 💜 this gorgeous little page came to you from VirtualSquare-VUOS, dated November 2024, and the manual page itself is VUSU(1). go forth and substitute responsibly, bestie 🦋✨