VOS_LISTADDRS(1)

📦
version 1.8.16.1 · 10 versions
, in ubuntu stonking

💖 vos_listaddrs — bestie, let's read the VLDB together ✨

okay so this is vos_listaddrs(1) from the AFS Command Reference, and it is genuinely one of the most useful little gossip-girl commands in the whole OpenAFS suite. it's giving "who's registered on the block" energy. let me walk you through it, no cap. 🫶

✨ NAME ✨

vos_listaddrs — displays all VLDB server entries. literally all of them. every single one. periodt.

🌸 SYNOPSIS 🌸

vos listaddrs [-uuid <uuid of server>]
    [-host <address of host>] [-printuuid]
    [-cell <cell name>] [-noauth] [-localauth]
    [-verbose] [-encrypt] [-noresolve]
    [-config <config directory>]
    [-help]

vos lista [-u <uuid of server>] >>>
    [-h <address of host>] [-p]
    [-c <cell name>] [-noa] [-l]
    [-v] [-e] [-nor]
    [-co <config directory>]
    [-he]

so yeah, there's the long-form version and the short-flag version (lista, the glow-down nickname 💅). same command, different vibe. yes, that >>> is really in there, don't come for me, i just copy what's on the page. 😭

🦋 DESCRIPTION 🦋

the vos listaddrs command displays all of the server entries from the Volume Location Database (VLDB). that's the whole job. main character behavior honestly.

an entry gets created as the File Server initializes and registers the contents of its /var/lib/openafs/local/sysid file in the VLDB. so like, the server shows up, drops its little sysid card on the table, and the VLDB writes it down. iconic. 👑

💅 OPTIONS 💅

so many options, all of them slay:

  • -host <address of host> — instead of dumping every single server entry, only show the ones for the host you named. this will show all multihomed addresses registered by that File Server in the VLDB. we love a multi-homed queen with several addresses. 🌈
  • -uuid <uuid of server> — same idea, but you filter by the File Server's specific UUID instead of its host. this will show all multihomed addresses registered by that File Server in the VLDB, and it also lets you map a File Server UUID to its address. so it's a filter and a translator. versatile. 🎀
  • -printuuid — prints the UUID of server entries in addition to the registered addresses. heads up bestie: this option is available in OpenAFS versions 1.4.5 or later and 1.5.8 or later. don't come crying if your ancient install doesn't know it. 💀
  • -cell <cell name> — names the cell in which to run the command. do not combine this argument with the -localauth flag. for more details, see vos(1). they're like two exes at the same party — keep them apart. 🙈
  • -noauth — assigns the unprivileged identity anonymous to the issuer. do not combine this flag with the -localauth flag. for more details, see vos(1).
  • -localauth — constructs a server ticket using a key from the local /etc/openafs/server/KeyFile file. the vos command interpreter presents it to the Volume Server and Volume Location Server during mutual authentication. do not combine this flag with the -cell argument or -noauth flag. for more details, see vos(1). it's a strict VIP-only situation, fr fr.
  • -verbose — produces on the standard output stream a detailed trace of the command's execution. if this argument is omitted, only warnings and error messages appear. so it's quiet-mode by default, yapper-mode on request. 🗣️
  • -encrypt — encrypts the command so that the operation's results are not transmitted across the network in clear text. available in OpenAFS versions 1.4.11 or later and 1.5.60 or later. protect your business!! 🔒
  • -noresolve — shows all servers as IP addresses instead of the DNS name. this is very useful when the server address is registered as 127.0.0.1 or when dealing with multi-homed servers. available in OpenAFS versions 1.4.8 or later and 1.5.35 or later. for when the name service is being messy. 😤
  • -config <configuration directory> — set the location of the configuration directory to be used. this defaults to /etc/openafs, except if -localauth is specified, in which case the default is /etc/openafs/server. this option allows the use of alternative configuration locations for testing purposes. perfect for when you wanna test without touching the real setup. ✨
  • -help — prints the online help for this command. all other valid options are ignored. it's giving "i'm not listening to anybody else right now." 💅

🌈 OUTPUT 🌈

the output displays all server entries from the VLDB, each on its own line. cute, tidy, one per line, we love formatting.

if a file server machine is multihomed, all of its registered addresses appear on the line. the first one is the one reported as a volume's site in the output from the vos examine and vos listvldb commands. so order matters — first one is the spokesperson. 🎤

the VLDB records IP addresses, and the command interpreter has the local name service (either a process like the Domain Name Service or a local host table) translate them to hostnames before displaying them. if an IP address appears in the output, it is not possible to translate it. 😭 no name service cooperation, no name. that's just the deal.

⚠️ bestie listen — the existence of an entry does not necessarily indicate that the machine is still an active file server machine. entries linger like old situationships. to remove obsolete server entries, use the vos changeaddr command with the -remove argument. clean your house!! 🧹

🍓 EXAMPLES 🍓

here's the first one — displaying the VLDB server entries in the Example Corporation cell:

% vos listaddrs
sv5.example.com
sv1.example.com
sv2.example.com  afs2.example.com
sv6.example.com

see how sv2.example.com brought a plus-one (afs2.example.com)? multihomed behavior, we stan. 💖

and here we display the VLDB server entry <ital>and</ital> UUID for host sv5.example.com in the Example Corporation cell:

% vos listaddrs -p -ho sv5.example.com
UUID: 000c5aff-8246-1699-96-c4-437b5a45aa77
sv5.example.com

the -p (printuuid) and -ho (host) combo, doing the absolute most. obsessed. ⭐

👑 PRIVILEGE REQUIRED 👑

None

like literally none, bestie. you can just run it. freeloading has never been this easy. 🎀

🔥 SEE ALSO 🔥

fs_uuid(1), sysid(5), vos(1), vos_examine(1), vos_listvldb(1), vos_setaddrs(1), vos_remaddrs(1)

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.

okay that's the whole page, you ate it, you understood it, you're a vos listaddrs girlie now. 🦋✨ this was the OpenAFS manual page, version dating 2026-07-27, from the OpenAFS collection (that's the VOS_LISTADDRS(1) at the bottom, bestie, i didn't forget it 💖). go read your VLDB. periodt. 🌸👑

📦 where this page comes from