path [ N ]
Lists all paths with devices/project identifiers or set
the current path to the Nth list entry (the current path
is used by many of the commands described here, it
identifies the filesystem toward which a command is
directed). The path list can come from several places -
the command line, the mount table, and the /etc/projects
file.
report [ -gpu ] [ -bir ] [ -ahntlLNU ] [ -f file ]
Report filesystem quota information. This reports all
quota usage for a filesystem, for the specified quota type
(u/g/p and/or blocks/inodes/realtime). It reports blocks
in 1KB units by default. The -h option reports in a
"human-readable" format similar to the df(1) command. The
-f option outputs the report to file instead of stdout.
The -a option reports on all filesystems. By default,
outputs the name of the user/group/project. If no name is
defined for a given ID, outputs the numeric ID instead.
The -n option outputs the numeric ID instead of the name.
The -L and -U options specify lower and upper ID bounds to
report on. If upper/lower bounds are specified, then by
default only the IDs will be displayed in output; with the
-l option, a lookup will be performed to translate these
IDs to names. The -N option reports information without
the header line. The -t option performs a terse report.
state [ -gpu ] [ -av ] [ -f file ]
Report overall quota state information. This reports on
the state of quota accounting, quota enforcement, and the
number of extents being used by quota metadata within the
filesystem. The -f option outputs state information to
file instead of stdout. The -a option reports state on all
filesystems and not just the current path.
limit [ -g | -p | -u ] bsoft=N | bhard=N | isoft=N | ihard=N |
rtbsoft=N | rtbhard=N -d | id | name
Set quota block limits (bhard/bsoft), inode count limits
(ihard/isoft) and/or realtime block limits
(rtbhard/rtbsoft). The -d option (defaults) can be used to
set the default value that will be used, otherwise a
specific user/group/project name or numeric identifier
must be specified.
timer [ -g | -p | -u ] [ -bir ] value [ -d | id | name ]
Allows the quota enforcement timeout (i.e. the amount of
time allowed to pass before the soft limits are enforced
as the hard limits) to be modified. The current timeout
setting can be displayed using the state command.
When setting the default timer via the -d option, or for
id 0, or if no argument is given after value the value
argument is a number of seconds indicating the relative
amount of time after soft limits are exceeded, before hard
limits are enforced.
When setting any other individual timer by id or name, the
value is the number of seconds from now, at which time the
hard limits will be enforced. This allows extending the
grace time of an individual user who has exceeded soft
limits.
For value, units of 'minutes', 'hours', 'days', and
'weeks' are also understood (as are their abbreviations
'm', 'h', 'd', and 'w').
warn [ -g | -p | -u ] [ -bir ] value -d | id | name
Allows the quota warnings limit (i.e. the number of times
a warning will be send to someone over quota) to be viewed
and modified. The -d option (defaults) can be used to set
the default time that will be used, otherwise a specific
user/group/project name or numeric identifier must be
specified. NOTE: this feature is not currently
implemented.
enable [ -gpu ] [ -v ]
Switches on quota enforcement for the filesystem
identified by the current path. This requires the
filesystem to have been mounted with quota enabled, and
for accounting to be currently active. The -v option
(verbose) displays the state after the operation has
completed.
disable [ -gpu ] [ -v ]
Disables quota enforcement, while leaving quota accounting
active. The -v option (verbose) displays the state after
the operation has completed.
off [ -gpu ] [ -v ]
Permanently switches quota off for the filesystem
identified by the current path. Quota can only be
switched back on subsequently by unmounting and then
mounting again.
remove [ -gpu ] [ -v ]
Remove any space allocated to quota metadata from the
filesystem identified by the current path. Quota must not
be enabled on the filesystem, else this operation will
report an error.
dump [ -g | -p | -u ] [ -f file ]
Dump out quota limit information for backup utilities,
either to standard output (default) or to a file. This is
only the limits, not the usage information, of course.
restore [ -g | -p | -u ] [ -f file ]
Restore quota limits from a backup file. The file must be
in the format produced by the dump command.
quot [ -g | -p | -u ] [ -bir ] [ -acnv ] [ -f file ]
Summarize filesystem ownership, by user, group or project.
This command uses a special XFS "bulkstat" interface to
quickly scan an entire filesystem and report usage
information. This command can be used even when
filesystem quota are not enabled, as it is a full-
filesystem scan (it may also take a long time...). The -a
option displays information on all filesystems. The -c
option displays a histogram instead of a report. The -n
option displays numeric IDs rather than names. The -v
option displays verbose information. The -f option send
the output to file instead of stdout.
project [ -cCs [ -d depth ] [ -p path ] id | name ]
The -c, -C, and -s options allow the directory tree quota
mechanism to be maintained. -d allows one to limit
recursion level when processing project directories and -p
allows one to specify project paths at command line (
instead of /etc/projects ). All options are discussed in
detail below.
