VOS_LISTPART(1)

📦
version 1.8.16.1 · 10 versions
, in ubuntu stonking

💖 VOS_LISTPART(1) 💖

okay so bestie, this is vos_listpart from the AFS Command Reference, and it's genuinely one of the chillest little commands in the whole vos universe. she's giving "just show me the receipts" energy and we're obsessed. no cap.

🌸 NAME 🌸

vos_listpart — displays all AFS partitions on a file server machine. that's it. that's her whole job. iconic.

🎀 SYNOPSIS 🎀

vos listpart -server <machine name>
    [-cell <cell name>]
    [-noauth] [-localauth]
    [-verbose] [-encrypt] [-noresolve]
    [-config <config directory>]
    [-help]

vos listp -s <machine name> [-c <cell name>]
    [-noa] [-l] [-v] [-e] [-nor]
    [-co <config directory>]
    [-h]

two whole ways to say the same thing, and honestly? we stan options. you can spell everything out all proper, or you can go full lowercase-abbreviation gremlin mode. both slay.

✨ DESCRIPTION ✨

so vos listpart shows you all of the valid AFS partitions on whichever file server machine you point at 🫶 — and here's the cute part — it does that without ever consulting the Volume Location Database (VLDB). so no VLDB drama, no waiting on that whole situation. just vibes and partitions.

now if you want size deets — like how big a partition is and how much room she's got left — that's a different girlie: the vos partinfo command. vos listpart is not the one for that, bestie. don't get it twisted. 😭

💅 OPTIONS 💅

  • -server <server name> — tells it which file server machine's partitions you wanna see. give her the machine's IP address, or its host name — either fully qualified or as an unambiguous abbreviation, whichever you feel like. want the full deets? see vos(1). 💖
  • -cell <cell name> — names the cell you're running the command in. 🦋 do not combine this argument with the -localauth flag, okay? that's a hard no. more details live in vos(1).
  • -noauth — assigns the unprivileged identity "anonymous" to whoever's issuing the command. 🙈 also: do not combine this flag with -localauth. pick a lane, babe. more details in vos(1).
  • -localauth — constructs a server ticket using a key from the local /etc/openafs/server/KeyFile file. 🔐 the vos command interpreter then presents that ticket to the Volume Server and Volume Location Server during mutual authentication. and guess what — do not combine this flag with the -cell argument or the -noauth flag. more details in vos(1).
  • -verbose — produces a detailed trace of the command's execution on the standard output stream. 🎀 if you leave this argument out, only warnings and error messages show up. so basically it's the difference between "just the tea" and "the entire group chat scrollback".
  • -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.
  • -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 you're dealing with multi-homed servers (iykyk). available in OpenAFS versions 1.4.8 or later and 1.5.35 or later.
  • -config <configuration directory> — sets the location of the configuration directory to be used. 🌈 it defaults to /etc/openafs — except if -localauth is specified, in which case the default is /etc/openafs/server. this option is what lets you use alternative configuration locations for testing purposes. very much for the scientists and the chaos agents.
  • -help — prints the online help for this command. 💜 and, important: all other valid options are ignored when you use it. she's the main character now.

🌟 OUTPUT 🌟

you get a list of partition names in the form /vicepxx, and they come after this header, every single time:

The partitions on the server are:

and then — drumroll — the last line of the output reports the total number of partitions. 🎉

🍓 EXAMPLES 🍓

this command displays the partitions on "fs1.example.com":

% vos listpart fs1.example.com
The partitions on the server are:
    /vicepa     /vicepb     /vicepc     /vicepd
Total:  4

look at that output. clean. organized. four partitions and a total. she ate and left absolutely no crumbs. 🔥

👑 PRIVILEGE REQUIRED 👑

None. ✨ literally none. anybody can run this. no auth gatekeeping, no ticket drama, just pure partition-listing freedom. we love a low-barrier-to-entry moment.

🔗 SEE ALSO 🔗

vos(1), vos_partinfo(1)

go read those too, bestie, they're the extended universe.

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!! 🫶 this was VOS_LISTPART(1) from the AFS Command Reference, brought to you by OpenAFS, dated 2026-07-27. mwah, go list some partitions, you got this 💖✨🎀

📦 where this page comes from