pure-quotacheck(8)

💅 pure-quotacheck(8) — Pure-FTPd's own little quota gremlin

okay so real talk, this is pure-quotacheck, a manual page from the Pure-FTPd fam, and it's genuinely one of the most useful lowkey tools in the whole suite if you're running virtual quotas ✨

---

🎀 NAME

pure-quotacheck — updates the virtual quota files for Pure-FTPd, bestie. that's the whole job. no cap.

---

🌸 SYNTAX

pure-quotacheck -u username/gid -d home directory [-g group/gid]

---

🦋 DESCRIPTION

so pure-quotacheck creates a .ftpquota file inside whatever directory you point it at 💖 that file holds the current file count and the size of that directory, and Pure-FTPd reads it when virtual quotas are turned on. it's literally the receipts for your users' disk usage.

and like, the recommendation? run pure-quotacheck periodically for every single user, in crontabs. every user. in crontabs. she said what she said 🫶

---

✨ OPTIONS ✨

• -d <directory> — scans the <directory> you give her. that's the target, the main character, the vibe check destination 🌈
• -g <group or gid> — sets the group that files will be scanned as. this one's optional bestie: if you pass a user name to -u, the groups get retrieved automatically for you 💫
• -u <user or uid> — sets the user name that files will be scanned as. this is mandatory, like non-negotiable, and heads up: it can't be "root" 🙈
• -h — outputs usage information and dips (exits). love an icon who explains herself then leaves 👑

---

🍓 FILES

• .ftpquota

that's it. that's the file. she's small but she's doing so much 💅

---

⭐ EXAMPLES

to run this program the standard way, type:

pure-quotacheck -u john -d /home/john

and that's it, that's the whole slay 🔥

---

👑 AUTHORS

Frank DENIS <j at pureftpd dot org>

---

🧚 SECURITY

okay this section is the serious one, so like, listen up bestie, because these are real protections and not just vibe:

• pure-quotacheck switches real and effective uids/gids as soon as possible. root privileges are never given back. periodt.
• pure-quotacheck refuses to scan directories with uid = 0 (root) or gid = 0 (wheel/root). not today, not ever 💀
• pure-quotacheck performs a chroot() call to the home directory. it never traverses parent directories. she stays in her lane, literally.
• pure-quotacheck only scans real files (no socket, no pipe, etc). if it's not a real file it's not getting counted, sorry.
• pure-quotacheck enforces read access on directories to prevent against people doing chmod 0 before a quota scan. sneaky behaviour? blocked 🚫
• pure-quotacheck enforces write access on the home directory to properly write the .ftpquota file. gotta have somewhere to put the receipts.
• pure-quotacheck never scans the same inode/device pair twice. no double counting, no inflation, we're accurate in this house 📏

---

🌈 SEE ALSO

ftp(1), pure-ftpd(8) pure-ftpwho(8) pure-mrtginfo(8) pure-uploadscript(8) pure-statsdecode(8) pure-pw(8) pure-quotacheck(8) pure-authd(8) pure-certd(8)

RFC 959, RFC 2228, RFC 2389 and RFC 2428 💜

---

alright that's the page!! this one's pure-quotacheck(8), version 1.0.54, written by Frank Denis — mwah, sending her a little kiss, she ate and left no crumbs 🎀💖✨