VOS_PARTINFO(1)

📦
version 1.8.16.1 · 10 versions
, in ubuntu stonking

✨ VOS_PARTINFO(1) — AFS Command Reference ✨

okay bestie, welcome to vos_partinfo from the AFS command reference, aka the part of vos that tells you how much room you actually have on a partition 🎀 (also it's a section 1 page, so it's a whole command, periodt).

💖 NAME 💖

vos_partinfo — reports the available and total space on a partition

Like, it's the "how full is it" check but for AFS partitions, no cap.

🌸 SYNOPSIS 🌸

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

vos p -se <machine name>
    [-p <partition name>] [-su]
    [-c <cell name>]
    [-noa] [-l] [-v] [-e] [-nor]
    [-co <config directory>]
    [-h]

so you can type the whole thing out like a scholar, or you can shorten everything to death like a girl in a group chat at 2am. both are valid. both are iconic. 💅

🦋 DESCRIPTION 🦋

vos partinfo reports how much space is available and how big the total is, either for all the partitions on the file server machine you point at (that's what happens if you leave out the -partition argument), or just for the one partition you name on that file server machine.

and the plot twist: the Volume Location Database (VLDB) is not consulted. not even a little. it's giving "I don't need the VLDB for this, I asked the file server directly" energy. 🙈

⚠️ CAUTIONS ⚠️

Currently, the maximum quota for a volume is 2 terabytes (2^41 bytes). Note that this only affects the volume's quota; a volume may grow much larger if the volume quota is disabled. However, volumes over 2 terabytes in size may be impractical to move, and may have their size incorrectly reported by some tools, such as fs_listquota(1).

so like. the quota cap is a quota thing, not a hard wall on the volume itself, but bestie... big volumes get weird and some tools lie about them. be mindful. 😭

👑 OPTIONS 👑

  • -server <server name> — tells it which file server machine to show partition info for. you can hand it the machine's IP address or its host name (either fully qualified or using an unambiguous abbreviation). for the details, go look at vos(1).
  • -partition <partition name> — tells it which partition on the machine named by -server to show info for. give the partition's complete name with a preceding slash (for example, /vicepa) or use one of the three acceptable abbreviated forms. again, details live in vos(1).
  • -summary — prints storage summary.
  • -cell <cell name> — names the cell to run the command in. do not combine this argument with the -localauth flag. more deets in vos(1).
  • -noauth — assigns the unprivileged identity "anonymous" to the issuer. do not combine this flag with the -localauth flag. more deets in 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. more deets in vos(1).
  • -verbose — produces on the standard output stream a detailed trace of the command's execution. if you omit this argument, only warnings and error messages show up. it's the "tell me everything, I want the whole tea" option 🍓
  • -encrypt — encrypts the command so that the operation's results are not transmitted across the network in clear text. this option is 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 dealing with multi-homed servers. this option is available in OpenAFS versions 1.4.8 or later and 1.5.35 or later.
  • -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. lowkey a testing-arc king 👑
  • -help — prints the online help for this command. all other valid options are ignored. it's the "I'm not listening to anything else until you help me" mode.

⚠️ CAUTIONS (part two, electric boogaloo) ⚠️

The partition-related statistics in this command's output do not always agree with the corresponding values in the output of the standard UNIX df command. The statistics reported by this command can be up to five minutes old, because the Cache Manager polls the File Server for partition information at that frequency. Also, on some operating systems, the df command's report of partition size includes reserved space not included in this command's calculation, and so is likely to be about 10% larger.

so if df and vos partinfo are beefing, that's normal, that's expected, that's just the five-minute polling delay and reserved space being different, fr fr. 💀

🌈 OUTPUT 🌈

The output reports the amount of space available and total space for each specified partition.

✨ EXAMPLES ✨

this one displays all partitions on the file server machine "fs2.example.com".

% vos partinfo fs2.example.com
Free space on partition /vicepa: 27301 K blocks out of total 549197
Free space on partition /vicepb: 13646 K blocks out of total 69194
Free space on partition /vicepc: 31798 K blocks out of total 320315
Free space on partition /vicepd: 33302 K blocks out of total 494954

look at those numbers go. we love a clean readout 🫶

🧚 PRIVILEGE REQUIRED 🧚

None

(we love a permissionless queen. no ticket drama, no auth nonsense, just vibes.)

💜 SEE ALSO 💜

vos(1), vos_listpart(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.

and that's the whole page, bestie 🎀 this was OpenAFS, dated 2026-07-27 — go free some space, or at least go look at how much space you have. main character partition-monitoring energy only. bye 💖✨

📦 where this page comes from