QUOTA(1)

💖 QUOTA(1) — the quota glow-up 💖

okay bestie, sit DOWN, because quota is about to become your new favorite command. this is the quota page from the General Commands Manual, and it's literally just: how much disk are you using, and what are your limits. that's it. that's the vibe. 🎀

---

✨ NAME ✨

quota — display disk usage and limits 🦋

---

🌸 SYNOPSIS 🌸

quota [ -F format-name ] [ -guqvswi ] [ -l | [ -QAm ]]
quota [ -F format-name ] [ -qvswi ] [ -l | [ -QAm ]] -u user...
quota [ -F format-name ] [ -qvswi ] [ -l | [ -QAm ]] -g group...
quota [ -F format-name ] [ -qvswi ] [ -l | [ -QAm ]] -P project...
quota [ -F format-name ] [ -qvswugQm ] -f filesystem...

five whole flavors, pick your fighter 💅

---

🫶 DESCRIPTION 🫶

so quota displays users' disk usage and limits. by default only the user quotas are printed — like, it assumes you're asking about you, which, fair.

also by default, space usage and limits are shown in kbytes (and yes they're named blocks for historical reasons, don't @ me, it's giving ancient lore 📜).

quota reports the quotas of all the filesystems listed in /etc/mtab. and if a filesystem is NFS-mounted? it makes a call to the rpc.rquotad on the server machine to go get that info. networking, but make it quota. 🌐

---

💅 OPTIONS 💅

okay here's the whole menu, no skips, no skimming, we're eating every single one 🔥

• -F, --format=format-name — show quota for a specified format (aka don't do the format autodetection thing, just tell it). the 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), rpc (quota over NFS), xfs (quota on XFS filesystem).
• -g, --group — print group quotas for the group of which the user is a member. the optional group argument(s) narrows the display down to just the specified group(s).
• -u, --user — this flag is equivalent to the default. it's giving "I said what I said, but louder." 🙈
• -P, --project — print project quotas for the specified project.
• -v, --verbose — will display quotas on filesystems where no storage is allocated. like, even the empty ones get a moment on stage. ⭐
• -s, --human-readable[=units] — makes quota(1) try to choose units for showing limits, used space and used inodes. units can also be specified explicitly by an optional argument in format [ kgt ],[ kgt ] where the first character specifies space units and the second character specifies inode units.
• --always-resolve — always try to translate user / group name to uid / gid even if the name is composed of digits only. 🔢
• -p, --raw-grace — when a user is in grace period, report time in seconds since epoch for when their grace time runs out (or already has run out). the field is '0' when no grace time is in effect. this one is especially useful when parsing output by a script. 🤖
• -i, --no-autofs — ignore mountpoints mounted by automounter. not today, autofs. 💀
• -l, --local-only — report quotas only on local filesystems (aka ignore NFS mounted filesystems).
• -A, --all-nfs — report quotas for all NFS filesystems even if they report to be on the same device.
• -f, --filesystem-list — report quotas only for filesystems specified on the command line.
• --filesystem=path — report quotas only for filesystem path. this option can be specified multiple types and quota will be reported for each specified filesystem. unlike the command line option -f, the remaining command line arguments are still treated as user / group / project names to report. 👑
• -m, --no-mixed-pathnames — so rn, pathnames of NFSv4 mountpoints are sent without a leading slash in the path. rpc.rquotad uses this to recognize NFSv4 mounts and properly prepend pseudoroot of NFS filesystem to the path. if you specify this option, quota will always send paths with a leading slash. this can be useful for legacy reasons but be aware that quota over RPC will stop working if you are using new rpc.rquotad. ⚠️
• -q, --quiet — print a more terse message, containing only information on filesystems where usage is over quota. minimalism, but make it threatening. 😭
• -Q, --quiet-refuse — do not print an error message if connection to rpc.rquotad is refused (usually this happens when rpc.rquotad is not running on the server). we're pretending we didn't see it. 🙈
• -w, --no-wrap — do not wrap the line if the device name is too long. this can be useful when parsing the output of quota(1) by a script. 📏
• --show-mntpoint — show also mount point as a filesystem identification.
• --hide-device — do not show device name in a filesystem identification.

---

specifying both -g and -u displays both the user quotas and the group quotas (for the user). slay, both at once. 💖

only the super-user may use the -u flag and the optional user argument to view the limits of other users. also viewing of project quota usage and limits is limited to super-user only. non-super-users can use the -g flag and optional group argument to view only the limits of groups of which they are members. sorry bestie, permissions are permissions. 🔒

and one more thing: the -q flag takes precedence over the -v flag. periodt. 💅

---

🩺 DIAGNOSTICS 🩺

if quota exits with a non-zero status, one or more filesystems are over quota. that's the whole tell. 🚨

---

📁 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

---

👀 SEE ALSO 👀

go read these next, bestie, they're all in the family:

quotactl(2), fstab(5), edquota(8), quotacheck(8), quotaon(8), quota_nld(8), repquota(8), warnquota(8), setquota(8)

---

that's the whole page, no cap. this was the quota(1) page from the General Commands Manual — QUOTA(1), section 1, and that's the footer talking, not me. go check your limits, main character. 🦋💜✨