BOS_LISTUSERS(8)

💖 BOS_LISTUSERS 💖

okay bestie, welcome to bos_listusers from the AFS Command Reference — this is the one that reads the guest list at the door of your file server, no cap 👑

---

✨ NAME ✨

bos_listusers — literally just lists the privileged users straight out of the UserList file. that's it. that's the whole job. slay. 💅

---

🦋 SYNOPSIS 🦋

bos listusers -server <machine name> [-cell <cell name>]
    [-noauth] [-localauth] [-help]

bos listu -s <machine name> [-c <cell name>] [-n]
    [-l] [-h]

see how listu is the short king version of listusers? both work, pick your vibe ✨

---

🌸 DESCRIPTION 🌸

so the way this works: bos listusers pulls the user names out of the /etc/openafs/server/UserList file, and it does that on whatever file server machine you point at with the -server argument. simple. iconic.

and what are those users, you ask? they're the ones authorized to issue privileged bos and vos commands. the VIP section, basically. 🫶

want to actually change that guest list instead of just staring at it? that's what bos adduser and bos removeuser are for, bestie. this command is read-only energy only.

---

💅 OPTIONS 💅

• -server <machine name> — tells it which server machine to go grab the UserList file from. you can identify the machine by IP address or by its host name (fully-qualified, or abbreviated as long as it's unambiguous — no guessing games). for the deets, peep bos(8).

okay important: for consistent performance in the cell, the output has to be the same on every server machine. the bos adduser reference page explains how to keep all the machines synchronized. do NOT skip that part fr fr 😭

• -cell <cell name> — names the cell you want to run the command in. do not combine this argument with the -localauth flag, they do not get along. more details in bos(8).
• -noauth — assigns the unprivileged identity "anonymous" to whoever's issuing the command. do not combine this flag with -localauth. again, more details in bos(8).
• -localauth — constructs a server ticket using a key from the local /etc/openafs/server/KeyFile or /etc/openafs/server/KeyFileExt file. the bos command interpreter then presents that ticket to the BOS Server during mutual authentication. do not combine this flag with the -cell or -noauth options. more details in bos(8).
• -help — prints the online help for this command. and bestie, if you pass this one, all other valid options are ignored. it's giving main character, it simply does not care about the rest 💀

---

🌈 OUTPUT 🌈

it lists the user name of every user entitled to issue privileged bos and vos commands. that's the tea. 🍓

---

⭐ EXAMPLES ⭐

here's the moment you've been waiting for — listing the users from the UserList file on the machine "fs4.example.com":

% bos listusers fs4.example.com
SUsers are: pat smith jones terry

look at that little SUsers are: opening like it's a whole personality. adorable. 🙈

---

👑 PRIVILEGE REQUIRED 👑

None.

literally none. zero. nada. anyone can peek at the list, the flex is in editing it. ✨

---

💜 SEE ALSO 💜

KeyFile(5), KeyFileExt(5), UserList(5), bos(8), bos_adduser(8), bos_removeuser(8)

(the whole friend group, go say hi 🫶)

---

🎀 COPYRIGHT 🎀

IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.

This documentation is covered by the IBM Public License Version 1.0. It was converted from HTML to POD by software written by Chas Williams and Russ Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.

---

and that's the whole page, bestie 💖 this edition of the OpenAFS manual came to you from 2026-07-27 — write that date down, it's the era we're living in. mwah, go forth and list those users. 💅✨🦋