VUNAME(1)

💖 VUNAME 💖

okay bestie, welcome to vuname(1) — it's a manual page from the General Commands Manual section and honestly? it's giving main character energy. sit down, hydrate, let's go 🫶

---

✨ NAME ✨

vuname — print system/view information, and also set the view name. two jobs, one icon 💅

---

🌸 SYNOPSIS 🌸

vuname [options ...]

or

vuname newname

like. pick a lane bestie, either options or one new name. that's the whole vibe ✨

---

🦋 DESCRIPTION 🦋

so what does it even do? it prints certain system/view information. that's the whole thing, no cap.

• if you give it no options and no arguments, it's literally the same as running it with -s.
• if you give it no options and exactly one argument, it sets the VUOS view name. one argument. exactly one. don't try to be clever 🔥

here's the tea: this tool extends uname(1). it should give you the same output as uname — except when it runs as a VUOS process (or when --x/--nouname turns that feature off). and in VUOS, the system info gets extended with view information. so it's uname but with ✨lore✨.

---

💅 OPTIONS 💅

okay here's the full lineup, no skips, we don't do that here:

• -a, --all — print all the information, in the following order, except it omits -p and -i if they're unknown 👑
• -s, --kernel-name — print the kernel name
• -n, --nodename — print the network node hostname
• -r, --kernel-release — print the kernel release
• -v, --kernel-version — print the kernel version
• -m, --machine — print the machine hardware name
• -p, --processor — print the processor type or unknown
• -i, --hardware-platform — print the hardware platform or unknown
• -o, --operating-system — print the operating system
• -U, --serverid — print the VUOS server id (it's the process id of the hypervisor, iykyk)
• -V, --viewname — print the view name
• -P, --prompt — returns a suitable (shell) command prompt 🐚. here's the algorithm, stay with me: it's the nodename (-n) if vuname runs outside VUOS; otherwise it's the view name (-V) if one has been defined; otherwise it's the nodename followed by the server id enclosed in square brackets — something like host[42]. iconic formatting honestly 💖
• -x, --nouname — do not use uname. without this flag, the command behaves like uname when it runs on a non VUOS enabled environment 🙈
• -q, --quiet — quiet mode: error messages get suppressed 🤫
• --help — display a help message and exit
• --version — output version information and exit

---

ok real talk bestie, the --all caveat matters: -p and -i get omitted if unknown. that's not a bug, that's the spec. don't @ me 💀

---

and that's the whole page, you ate it 🎀

VirtualSquare-VUOS, dated January 2024 — mwah, sending you the biggest forehead kiss, now go run vuname -a and slay ✨💜🦋