<3>xfs_quota<1> [ <3>-x<1> ] [ <3>-p<1> prog ] [ <3>-c<1> cmd ] ...
		[ <3>-d<1> project ] ... [path...]

<3>-c<1> <2>cmd<1>

<2>xfs_quota<1> commands may be run interactively (the default) or as arguments on the command line. Multiple <3>-c<1> arguments may be given. The commands are run in the sequence given, then the program exits.

<3>-p<1> <2>prog<1>

Set the program name for prompts and some error messages, the default value is <2>xfs_quota<1>.

<3>-x<1>

Enable expert mode. All of the administrative commands (see the ADMINISTRATOR COMMANDS section below) which allow modifications to the quota system are available only in expert mode.

<3>-d<1> <2>project<1>

Project names or numeric identifiers may be specified with this option, which restricts the output of the individual <3>xfs_quota<1> commands to the set of projects specified. Multiple <3>-d<1> arguments may be given.

The optional <2>path<1> argument(s) can be used to specify mount points or device files which identify XFS filesystems. The output of the individual <3>xfs_quota<1> commands will then be restricted to the set of filesystems specified.

This manual page is divided into two sections - firstly, information for users of filesystems with quota enabled, and the xfs_quota commands of interest to such users; and then information which is useful only to administrators of XFS filesystems using quota and the quota commands which allow modifications to the quota system.

Note that common to almost all of the individual commands described below are the options for specifying which quota types are of interest - user quota (<2>-u<1>), group quota (<2>-g<1>), and/or project quota (<2>-p<1>). Also, several commands provide options to operate on "blocks used" (<2>-b<1>), "inodes used" (<2>-i<1>), and/or "realtime blocks used" (<2>-r<1>).

Many commands also have extensive online help. Use the <3>help<1> command for more details on any command.

<3>path<1> [ <2>N<1> ]

Lists all paths with devices/project identifiers or set the current path to the <2>N<1>th 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 <2>/etc/projects<1> file.

<3>df<1>

See the <3>free<1> command.

<3>quota<1> [ <2>-gpu<1> ] [ <2>-bir<1> ] [ <2>-hnNv<1> ] [ id|name ] ...

Show individual usage and limits, for a single user name or numeric user ID. The <2>-h<1> option reports in a "human-readable" format similar to the df(1) command.

<3>free<1> [ <2>-bir<1> ] [ <2>-hN<1> ]

Reports filesystem usage, much like the df(1) utility. It can show usage for blocks, inode, and/or realtime block space, and shows used, free, and total available. If directory quota are in use (see the DIRECTORY QUOTA section below), it will also report utilisation for those directory trees. The <2>-h<1> option reports in a "human-readable" format,

<3>help<1> [ <2>command<1>]

Online help for all commands, or one specific <2>command<1>.

<3>quit<1>

Exit <2>xfs_quota<1>.

<3>q<1>

See the <3>quit<1> command.

1.

quotacheck(8) has no effect on XFS filesystems. The first time quota accounting is turned on (at mount time), XFS does an automatic quotacheck internally; afterwards, the quota system will always be completely consistent until quotas are manually turned off.

2.

There is no need for quota file(s) in the root of the XFS filesystem.

3.

XFS distinguishes between quota accounting and limit enforcement. Quota accounting must be turned on at the time of mounting the XFS filesystem. However, it is possible to turn on/off limit enforcement any time quota accounting is turned on. The "quota" option to the mount(8) command turns on both (user) quota accounting and enforcement. The "uqnoenforce" option must be used to turn on user accounting with limit enforcement disabled.

4.

Turning on quotas on the root filesystem is slightly different from the above. For IRIX XFS, refer to quotaon(1) For Linux XFS, the quota mount flags must be passed in with the "rootflags=" boot parameter.

5.

It is useful to use the <2>state<1> to monitor the XFS quota subsystem at various stages - it can be used to see if quotas are turned on, and also to monitor the space occupied by the quota system itself..

6.

There is a mechanism built into xfsdump(8) that allows quota limit information to be backed up for later restoration, should the need arise.

7.

Quota limits cannot be set before turning on quotas on.

8.

XFS filesystems keep quota accounting on the superuser (user ID zero), and the tool will display the superuser's usage information. However, limits are never enforced on the superuser (nor are they enforced for group and project ID zero).

9.

XFS filesystems perform quota accounting whether the user has quota limits or not.

10.

XFS supports the notion of project quota, which can be used to implement a form of directory tree quota (i.e. to restrict a directory tree to only being able to use up a component of the filesystems available space; or simply to keep track of the amount of space used, or number of inodes, within the tree).

<3>report<1> [ <2>-gpu<1> ] [ <2>-bir<1> ] [ <2>-ahnNt<1> ]

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 <2>-h<1> option reports in a "human-readable" format similar to the df(1) command.

<3>state<1> [ <2>-gpu<1> ]

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.

<3>limit<1> [ <2>-gpu<1> ] \

<2>bsoft<1>=N | <2>bhard<1>=N | <2>isoft<1>=N | <2>ihard<1>=N | <2>rtbsoft<1>=N | <2>rtbhard<1>=N... -d|id|name
Set quota block limits (bhard/bsoft), inode count limits (ihard/isoft) and/or realtime block limits (rtbhard/rtbsoft). The <2>-d<1> 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.

<3>timer<1> [ <2>-gpu<1> ] [ <2>-bir<1> ] value

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 <3>state<1> command. The value argument is a number of seconds, but units of 'seconds', 'minutes', 'hours', 'days', and 'weeks' are also understood (as are their abbreviations, 's', 'm', 'h', 'd', and 'w').

<3>warn<1> [ <2>-gpu<1> ] [ <2>-bir<1> ] 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 <2>-d<1> 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.

<3>enable<1> [ <2>-gpu<1> ] [ <2>-v<1> ]

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 <2>-v<1> option (verbose) displays the state after the operation has completed.

<3>disable<1> [ <2>-gpu<1> ] [ <2>-v<1> ]

Disables quota enforcement, while leaving quota accounting active. The <2>-v<1> option (verbose) displays the state after the operation has completed.

<3>off<1> [ <2>-gpu<1> ] [ <2>-v<1> ]

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.

<3>remove<1> [ <2>-gpu<1> ] [ <2>-v<1> ]

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.

<3>dump<1> [ <2>-gpu<1> ] [ <2>-f<1> <2>file<1> ]

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.

<3>restore<1> [ <2>-gpu<1> ] [ <2>-f<1> <2>file<1> ]

Restore quota limits from a backup <2>file<1>. The file must be in the format produced by the <3>dump<1> command.

<3>quot<1> [ <2>-gpu<1> ] [ <2>-bir<1> ] [ <2>-av<1> ] [ <2>-c<1> ]

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...).

<3>project<1> [ <2>-cds<1> id|name ]

Without arguments, this command lists known project names and identifiers (based on entries in the /etc/projects and /etc/projid files). The <2>-c<1>, <2>-C<1>, and <2>-s<1> options allow the directory tree quota mechanism, discussed in detail below, to be maintained.

 .8v
# comments are hash-prefixed


# ...


10:/export/cage


42:/var/log


 

  


 The


  projid

 file provides a mapping between numeric project identifiers and a


simple human readable name (similar relationship to the one that


exists between usernames and uids).


Its format is simply:



 .8v
# comments are hash-prefixed


# ...


10:cage


42:logfiles


 

  


 This file is optional, if a project identifier cannot be mapped to


a name, it will be displayed as a number only.


 

  


 

 .8v
# mount -o uquota /dev/xvm/home /home


# xfs_quota -c 'edit bsoft=500m bhard=550m tanya' /home


# xfs_quota -c report /home


 

  


 Enabling directory quota on an XFS filesystem (restrict files in


log file directories to only using 1 gigabyte of space).



 .8v
# mount -o pquota /dev/xvm/var /var


# echo 42:/var/log >> /etc/projects


# echo logfiles:42 >> /etc/projid


# xfs_quota -c 'projects -c logfiles' /home


# xfs_quota -c 'edit -p bhard=1g logfiles' /home

/etc/projects

Mapping of numeric project identifiers to directories trees.

/etc/projid

Mapping of numeric project identifiers to project names.