WARNQUOTA(8)

💖 WARNQUOTA 💖

okay bestie, so this one is literally called warnquota and it lives in the System Manager's Manual, section 8 — the big-girl sysadmin section, no cap 👑

✨ NAME ✨

warnquota — send mail to users over quota 📬

🌸 SYNOPSIS 🌸

warnquota [ -ugsid ] [ -F quotaformat ] [ -q quotatab ] [ -c configfile
] [ -a adminsfile ] [ filesystem...  ]

🦋 DESCRIPTION 🦋

So here's the vibe: warnquota goes and checks the disk quota for the local filesystems you name. And if you don't name any? It just checks every single local filesystem, bestie, all of them, no skipping 💅

Then it mails a warning message to all the users who have reached their softlimit. Like, "hey girl, you're at the limit, maybe chill" 💌

People typically run this via cron(8) — it's a set-it-and-forget-it kinda situation, main character energy fr fr ✨

👑 OPTIONS 👑

• -F, --format=quotaformat — does the thing for the format you specify (aka, it won't do the format autodetection, so you're telling it directly, periodt). The possible format names are: vfsold — the 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 an XFS filesystem 🗂️
• -q, --quota-tab=quotatab — use quotatab instead of /etc/quotatab as the file with device description strings (peep quotatab(5) for the syntax, iykyk).
• -c, --config=configfile — use configfile instead of /etc/warnquota.conf as the configuration file (syntax lives in warnquota.conf(5), go look 🌸).
• -a, --admins-file=adminsfile — use adminsfile instead of /etc/quotagrpadmins as the file holding the administrators of the groups (syntax is in quotagrpadmins(5), bestie).
• -u, --user — checks whether the users are not exceeding quotas. This is the default behaviour, so it's already doing this unless you say otherwise 💅
• -g, --group — checks whether groups are not exceeding quotas. And if a group is exceeding its quota, a mail gets sent to the user specified in /etc/quotagrpadmins. Teamwork, honestly 🫶
• -s, --human-readable[=units] — tries to report used space, number of used inodes and limits in units that are way more appropriate than the defaults, because raw numbers are giving chaos 😭. Units can also be specified explicitly with an optional argument in the format [ kgt ],[ kgt ] where the first character specifies space units and the second character specifies inode units.
• -i, --no-autofs — ignore mountpoints that were mounted by the automounter. Not today, autofs 🙈
• -d, --no-details — do not attach the quota report in the email. Short and sweet, no receipts 💌

💜 FILES 💜

• aquota.user — quota file at the filesystem root (version 2 quota, non-XFS filesystems)
• quota.user — quota file at the filesystem root (version 1 quota, non-XFS filesystems)
• /etc/warnquota.conf — configuration file
• /etc/quotatab — device description
• /etc/quotagrpadmins — administrators of the groups
• /etc/mtab — default filesystems
• /etc/passwd — default set of users

🌈 SEE ALSO 🌈

quota(1), quotatab(5), quotagrpadmins(5), warnquota.conf(5), cron(8), edquota(8).

🎀 AUTHORS 🎀

warnquota(8) was written by Marco van Wieringen <mvw@planets.elm.net>, with modifications by Jan Kara <jack@suse.cz>. This reference page was written by Heiko Schlittermann <heiko@lotte.sax.de>, with modifications by Jan Kara. Legends only, honestly 👑

ok and that's the whole page, bestie!! this one comes straight out of the System Manager's Manual, section 8, and it's the WARNQUOTA(8) situation in all its glory. go forth and warn those quota-havers 💖✨🎀