FS_LISTQUOTA(1)

📦
version 1.8.16.1 · 10 versions
, in ubuntu stonking

💖 FS_LISTQUOTA — girl help me understand my quota 💖

okay so bestie, welcome to the AFS Command Reference ✨ this is fs_listquota(1), the little command that goes "hey, here's how fat your volume is getting" 🫶 it lives in the AFS command fam, and it's genuinely one of the most useful lil guys in the toolbox, no cap.

🌸 NAME 🌸

fs_listquota — shows you the quota tea for a volume 💅

✨ SYNOPSIS ✨

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

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

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

like, yes, there are three whole ways to spell it. listquota is the full name, listq and lq are the shorties for when you're typing fast and living your truth 💅

🦋 DESCRIPTION 🦋

so fs listquota spills the info about the volume that contains each directory or file you point it at. we're talking:

  • the volume's name
  • its quota
  • how much disk space is used

…plus an indicator of the percentage of space used on the host partition 👑

want even MORE tea about the host partition? go hit up the fs examine command, she'll tell you everything 🍓

wanna actually set a volume quota? that's fs setquota or fs setvol, bestie — this command is strictly the gossip, not the gossip-setter ✨

🎀 CAUTIONS 🎀

okay so this part matters, listen up 👀

right now, the maximum quota for a volume is 2 terabytes (2^41 bytes). and no, that's not the whole story — this only affects the volume's quota. a volume can grow way bigger than that if the volume quota is disabled 💀

BUT. and this is the BUT. volumes over 2 terabytes in size may be:

  • impractical to move 😭
  • reported at the wrong size by some tools — and yeah, fs_listquota(1) is one of those tools 🙈

so like. be aware. that's the vibe check.

💜 OPTIONS 💜

  • -path <dir/file path>+ — names a file or directory that resides in the volume you want output about. partial pathnames get interpreted relative to the current working directory, which is also the default value if you just… don't pass this argument at all 😌
  • -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, as appropriate 🧚✨
  • -help — prints the online help for this command. all other valid options are ignored when you do this, so don't bother combining, she's not listening 💅

🌈 OUTPUT 🌈

the output displays information about the volume that houses each directory or file you specified, in a tabular format that uses these headers 👇

⭐ Volume Name

the name of the volume, periodt.

⭐ Quota

the volume's quota in kilobytes, or the string "no limit" to indicate an unlimited quota 🦋 (iconic of her honestly)

⭐ Used

the amount of space used. if -human is not specified, this value is in kilobytes.

⭐ % Used

the percentage of the volume's quota that is used — and yes, it's literally the "Used" statistic divided by the "Quota" statistic, times 100. math ate 💅

⭐ Partition

the percentage of space used on the partition that houses the volume. lowkey this isn't directly related to how much of the user's quota is used, but it's reported anyway because a full partition can cause writing of data back to the volume to fail even when the volume has not reached its quota 😭 that's the whole reason she's here.

note that due to limitations in the current wire protocol, OpenAFS cannot accurately calculate this field for partitions over 2 terabytes (2^41 bytes) in size. as a result, the percentage displayed in this field may be smaller than reality. for example:

  • if the partition has over 2 terabytes (2^41 bytes) free, fs listquota will report the partition usage as 0%.
  • if the partition has less than 2 terabytes (2^41 bytes) free, but is larger than 2 terabytes (2^41 bytes) in size, the reported partition usage will be larger than 0%, but will still be less than the actual usage.

so basically, take that percentage with a grain of salt, bestie 🧂

🔥 EXAMPLES 🔥

the following example shows the output for the volume "user.smith":

% fs listquota -path /afs/example.com/usr/smith
Volume Name     Quota    Used    % Used   Partition
user.smith      15000    5071       34%         86%

look at her go ✨ 34% used, 86% partition. living dangerously but making it work 💅

👑 PRIVILEGE REQUIRED 👑

the issuer 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.

so like, no sneaking in the back door, you need the actual permissions 📋✨

🌸 SEE ALSO 🌸

fs_diskfree(1), fs_examine(1), fs_quota(1), fs_setquota(1), fs_setvol(1)

(the whole friend group fr fr 🫶)

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 FS_LISTQUOTA(1) from the OpenAFS crew, dated 2026-07-27 — go forth, check your quota, and slay 💅✨🦋

📦 where this page comes from