REPQUOTA(8)

💅 REPQUOTA — the manual page, but make it cute

okay bestie, welcome to repquota, section 8 of the System Manager's Manual. it's the girl who summarizes quotas for a filesystem, and she ate. let's get into it 🫶

✨ NAME ✨

repquota — summarize quotas for a filesystem 💖

🌸 SYNOPSIS 🌸

/usr/sbin/repquota [ -vspiugP ] [ -c | -C ] [ -t | -n ] [ -F format-name
] filesystem...

/usr/sbin/repquota [ -avtpsiugP ] [ -c | -C ] [ -t | -n ] [ -F format-
name ]

like, two whole ways to call her. pick your fighter. 🎀

🦋 DESCRIPTION 🦋

repquota prints a summary of the disc usage and quotas for the specified file systems. periodt. for each user it prints the current number of files and the amount of space (in kilobytes), along with any quota limits that were set with edquota(8) or setquota(8). the way that it's all just there for you? iconic.

now, in the second column repquota prints two characters marking which limits are exceeded, and this is the part where you gotta pay attention bestie:

• if the user is over their space softlimit, or reaches their space hardlimit in the case where softlimit is unset, the first character is +. otherwise the character printed is -.
• the second character denotes the state of inode usage, analogously. same energy, different resource. 💀

repquota has to translate the ids of all users/groups/projects to names (unless option -n was specified), so yeah, it may take a while to print all the information. lowkey a slow queen sometimes. to make translating as fast as possible, repquota tries to detect — by reading /etc/nsswitch.conf — whether entries are stored in a standard plain text file or in a database, and then it either translates chunks of 1024 names or each name individually. you can override this autodetection with the -c or -C options. you're in charge, main character. 👑

💅 OPTIONS 💅

• -a, --all — Report on all filesystems indicated in /etc/mtab to be read-write with quotas. all of them, bestie. every single one. 🔥
• -v, --verbose — Report all quotas, even if there is no usage. also be more verbose about quotafile information. she's chatty, we love her. 💬
• -c, --cache — Cache entries to report and translate uids/gids to names in big chunks by scanning all users (this is the default). this is the good (fast) behaviour when you're using an /etc/passwd file. ✨
• -C, --no-cache — Translate individual entries. this is faster when you have users stored in a database. different strokes, still slay. 🦋
• -t, --truncate-names — Truncate user/group names longer than 9 characters. this results in nicer output when there are such names. yes it's a little rude to the names but the output is cuter. 🙈
• -n, --no-names — Don't resolve UIDs/GIDs to names. this can speed up printing a lot. no cap, it's a huge glow-up for speed. 🔥
• -s, --human-readable[=units] — Try to report used space, number of used inodes and limits in more appropriate units than the default ones. units can also be specified explicitely by an optional argument in the format [ kgt ],[ kgt ], where the first character specifies space units and the second character specifies inode units. so like, two little letters doing so much work. 💅
• -p, --raw-grace — When the user is in grace period, report the time in seconds since epoch when their grace time runs out (or has run out). the field is '0' when no grace time is in effect. this is especially useful when parsing output by a script. robot-readable, we stan. 🤖
• -i, --no-autofs — Ignore mountpoints mounted by automounter. not today, autofs. 💀
• -F, --format=format-name — Report quota for the specified format (ie. don't perform format autodetection). possible format names are:
  • vfsold — Original quota format with 16-bit UIDs / GIDs
  • vfsv0 — Quota format with 32-bit UIDs / GIDs, 64-bit space usage, 32-bit inode usage and limits
  • vfsv1 — Quota format with 64-bit quota limits and usage
  • xfs — quota on XFS filesystem
• -g, --group — Report quotas for groups. group chat energy fr fr. 🫶
• -P, --project — Report quotas for projects. project managers, this one's for you. 📁
• -u, --user — Report quotas for users. this is the default. she's the baseline, the blueprint, the moment. ⭐
• -O, --output=format-name — Output quota report in the specified format. possible format names are:
  • default — The default format, optimized for console viewing
  • csv — Comma-separated values, a text file with the columns delimited by commas
  • xml — Output is XML encoded, useful for processing with XSLT

⚠️ only the super-user may view quotas which are not their own. so like, know your lane bestie, the permissions said what they said. 🔒

🎀 FILES 🎀

• aquota.user or aquota.group — quota file at the filesystem root (version 2 quota, non-XFS filesystems)
• quota.user or quota.group — quota file at the filesystem root (version 1 quota, non-XFS filesystems)
• /etc/mtab — default filesystems
• /etc/passwd — default set of users
• /etc/group — default set of groups

🌈 SEE ALSO 🌈

quota(1), quotactl(2), edquota(8), quotacheck(8), quotaon(8), quota_nld(8), setquota(8), warnquota(8)

go read them too, they're all part of the same friend group. 💜

and that's the whole page, bestie! this one comes to you from the 4th Berkeley Distribution — yeah, she's got history, she's got lore — and this is REPQUOTA(8), the section 8 manual page. mwah. 💖✨