FS_DISKFREE(1)

📦
version 1.8.16.1 · 10 versions
, in ubuntu stonking

💾 FS_DISKFREE(1) — bestie's guide to the AFS Command Reference 💖

okay so listen ✨ this is fs_diskfree, and it lives in the AFS Command Reference, and it is literally the "how much room do we have in here" command. it tells you stuff about the partition that's housing a directory or a file. iconic behavior honestly 🫶

🌸 NAME 🌸

fs_diskfree — shows data about the partition housing a directory or file 🎀

✨ SYNOPSIS ✨

fs diskfree [-path <dir/file path>+] [-human] [-help]

fs df [-p <dir/file path>+] [-hu] [-he]

fs di [-p <dir/file path>+] [-hu] [-he]

like three whole names for one command, she's versatile 💅

🦋 DESCRIPTION 🦋

fs diskfree formats and displays info about the partition that houses the volume containing the directory or file you named. so it's giving... size, how much space is being used rn, the whole vibe check on that partition 💖

if you wanna see info about the volume itself, that's a different command — use fs examine. also fs examine and fs quota both show info about a volume too, iykyk.

⚠️ CAUTIONS ⚠️

okay bestie, this is the part where we're careful 😭

  • the partition stats in this command's output do not always agree with the matching values from the standard UNIX df command. not beef, just different math.
  • the stats this command reports can be up to five minutes old 🕰️ — because the Cache Manager polls the File Server for partition info at that frequency. so yeah, it's lowkey a little stale.
  • also, on some operating systems, df's report of partition size includes reserved space that this command's calculation does not include. so df's number is likely to be about 10% larger. bestie is just built different, no cap.

👑 OPTIONS 👑

  • -path <dir/file path>+ — names a file or directory that lives on the partition you want output about. partial pathnames get interpreted relative to the current working directory, which is also the default value if you omit this argument. so if you say nothing, it's just like... "here, current directory, do your thing" 💅
  • -human — prints space in a "human-readable" format 🌈 instead of always printing space in kilobytes, it shows disk space in kilobytes, megabytes, gigabytes, terabytes, or petabytes, whichever fits. as appropriate. queen of readability.
  • -help — prints the online help for this command. and every other valid option gets ignored. rude but fair 🙈

💜 OUTPUT 💜

the output reports the following info about the volume and partition that houses each file or directory:

  • Volume Name — the name of the volume. pretty self-explanatory bestie 🎀
  • total — the partition's total size. if -human is not specified, this value is in kilobytes.
  • used — the amount of space used on the partition. if -human is not specified, this value is in kilobytes.
  • avail — the amount of space available on the partition. if -human is not specified, this value is in kilobytes.
  • %used — the percentage of the partition's total space that's used (the "used" statistic divided by the "kbytes" statistic, times 100). math girlies rise 🔥
🚨 if the %used statistic is greater than 90%, it gets marked with the string "<<WARNING" at the right margin. so you'll know. dramatic and helpful.

also: if the volume is a read-only volume, the output includes info about only one of the partitions that houses it — generally the one on the file server machine with the lowest preference rank. to verify which machine the output is actually referring to, use the vos listvldb command to list the volume's locations, and the vos partinfo command to display the size of each one 🔍

🌟 EXAMPLES 🌟

here's the output for the partitions housing the volumes "user.smith" and "sun4x_56.bin" ✨

% fs diskfree -path /afs/example.com/usr/smith /afs/example.com/sun4x_56/bin
Volume Name      total    used   avail     %used
user.smith     4177920 3841258  336662       92% <<WARNING
sun4x_56.bin   4423680 3174500 1249180       72%

see that <<WARNING? that's the 92% one being loud about it 😭 ate and left no crumbs.

🔐 PRIVILEGE REQUIRED 🔐

whoever runs this must have:

  • the "r" (read) permission on the ACL of the root directory of the volume that houses the file or directory named by the -path argument, and
  • "l" (list) permission on the ACL of each directory that precedes it in the pathname.

no shortcuts bestie, permissions are permissions 💅

🫶 SEE ALSO 🫶

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. giving credit where credit is due, always 💖

and that's the whole page bestie!! this was OpenAFS, dated 2026-07-27, page FS_DISKFREE(1) — tysm for reading, go check your disk space, ilysm, bye 🎀✨💜

📦 where this page comes from