pure-quotacheck(8)

pure-quotacheck8

Update virtual quota files for pure-ftpd

Usage

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

Overview

pure-quotacheck create a .ftpquota file in the specified directory.
This file contains the current file and size of the directory, and it is used by Pure-FTPd when virtual quotas are enabled.
It's recommended to periodically run pure-quotacheck for every user, in crontabs.

Options

-d <directory>

Scans the specified <directory>.

-g <group or gid>

Sets the group files will be scanned as. This is optional: if a user name is passed to -u</fR>, group are automatically retrieved.

-u <user or uid>

Set the user name files will be scanned as. This is mandatory, and it can't be "root".

-h

Output usage information and exit.

Files

.ftpquota

Examples

To run this program the standard way type:

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

Security

pure-quotacheck switches real and effective uids/gids as soon as possible. Root privileges are never given back.
pure-quotacheck refuses to scan directories with uid = 0 (root) or gid = 0 (wheel/root) .
pure-quotacheck performs a chroot() call to the home directory. It never traverses parent directories.
pure-quotacheck only scans real files (no socket, no pipe, etc) .
pure-quotacheck enforces read access on directories to prevent against people doing chmod 0 before a quota scan.
pure-quotacheck enforces write access on the home directory to properly write the .ftpquota file.
pure-quotacheck never scans the same inode/device pair twice.

Releases

11 releases since Debian 3.1 (Sarge); the text changed 6 times.

  1. 3.1–5.0
  2. 6.0
  3. 7–8
  4. 9
  5. 10
  6. 11
  7. 12–13

Authors

Frank DENIS <j at pureftpd dot org>

From pure-ftpd-common 1.0.50-2.2 in Debian 13 (Trixie). Parsed by carta from the page's man source.