gfs_quota(8) System Manager's Manual gfs_quota(8)NAME
gfs_quota - Manipulate GFS disk quotas
SYNOPSIS
gfs_quota <list|sync|get|limit|warn|check|init> [OPTION]...
DESCRIPTION
gfs_quota is used to examine and change quota values in a GFS filesystem. This command has a number of different actions.
ACTIONS
list List the contents of the quota file. Only IDs that have a non-zero hard limit, warn limit, or value are printed.
sync Sync any local quota changes to the quota file.
get Get the current data for the ID specified by the -u or -g argument.
limit Set the current hard limit for the ID specified by the -u or -g argument to the value specified by the -l argument on the specified
filesystem. The filesystem won't let the user or group use more than this much space. A value of zero here means that no limit is
enforced.
warn Set the current warn limit for the ID specified by the -u or -g argument to the value specified by the -l argument on the specified
filesystem. The filesystem will start complaining to the user or group when more than this much space is used. A value of zero
here means that the user won't ever be warned.
check Scan a filesystem and make sure that what's out there on the disk matches what's in the quota file. This is only accurate if the
filesystem is idle when this is running. If there is a mismatch, it is printed to stdout. Note: GFS quotas are transactional and a
quota check is not needed every time there is a system crash.
init Scan a filesystem and initialize the quota file with the values obtained from the scan. The filesystem should be idle when this is
run. You should only need to do this if you upgrade a pre-quota GFS filesystem (pre-GFS 5.1).
OPTIONS -b The units for disk space are filesystem blocks.
-d Don't include the space allocated to GFS' hidden files in what's reported for the root UID and GID values. This is useful if you're
trying to get the numbers reported by gfs_quota to match up with the numbers reported by du.
-f Directory
Specifies which filesystem to perform the action on.
-g GID Specifies the group ID for get, limit, or warn. It can be either the group name from the group file, or the GID number.
-h Print out a help message describing available options, then exit.
-k The units for disk space are kilobytes.
-l Size
Specifies the new value for the limit or warn actions. The value is assumed to be in the units specified by the -m, -k, -s, -b
arguments. The default is megabytes.
-m The units for disk space are megabytes. This is the default.
-n Don't try to resolve UIDs and GIDs into user and group names.
-s The units for disk space are sectors (512-byte blocks).
-u UID Specifies the user ID for get, limit, or warn. It can be either the username from the password file, or the UID number.
-V Print program version information, then exit.
EXAMPLE
To set the hard limit for user "nobody" to 1048576 kilobytes on filesystem /gfs0
gfs_quota limit -l 1048576 -k -u nobody -f /gfs0
gfs_quota(8)
Check Out this Related Man Page
QUOTAON(8) System Manager's Manual QUOTAON(8)NAME
quotaon, quotaoff - turn filesystem quotas on and off
SYNOPSIS
/usr/sbin/quotaon [ -vugfp ] [ -F format-name ] filesystem...
/usr/sbin/quotaon [ -avugfp ] [ -F format-name ]
/usr/sbin/quotaoff [ -vugp ] [ -x state ] filesystem...
/usr/sbin/quotaoff [ -avugp ]
DESCRIPTION
quotaon
quotaon announces to the system that disk quotas should be enabled on one or more filesystems. The filesystem quota files must be present
in the root directory of the specified filesystem and be named either aquota.user (for version 2 user quota), quota.user (for version 1
user quota), aquota.group (for version 2 group quota), or quota.group (for version 1 group quota).
XFS filesystems are a special case - XFS considers quota information as filesystem metadata and uses journaling to provide a higher level
guarantee of consistency. There are two components to the XFS disk quota system: accounting and limit enforcement. XFS filesystems
require that quota accounting be turned on at mount time. It is possible to enable and disable limit enforcement on an XFS filesystem
after quota accounting is already turned on. The default is to turn on both accounting and enforcement.
The XFS quota implementation does not maintain quota information in user-visible files, but rather stores this information internally.
quotaoff
quotaoff announces to the system that the specified filesystems should have any disk quotas turned off.
OPTIONS
quotaon
-F, --format=format-name
Report quota for specified format (ie. don't perform format autodetection). Possible format names are: vfsold 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 XFS filesystem)
-a, --all
All automatically mounted (no noauto option) non-NFS filesystems in /etc/fstab with quotas will have their quotas turned on. This
is normally used at boot time to enable quotas.
-v, --verbose
Display a message for each filesystem where quotas are turned on.
-u, --user
Manipulate user quotas. This is the default.
-g, --group
Manipulate group quotas.
-p, --print-state
Instead of turning quotas on just print state of quotas (ie. whether. quota is on or off)
-x, --xfs-command enforce
Switch on limit enforcement for XFS filesystems. This is the default action for any XFS filesystem. This option is only applicable
to XFS, and is silently ignored for other filesystem types.
-f, --off
Make quotaon behave like being called as quotaoff.
quotaoff
-F, --format=format-name
Report quota for specified format (ie. don't perform format autodetection). Possible format names are: vfsold (version 1 quota),
vfsv0 (version 2 quota), xfs (quota on XFS filesystem)
-a, --all
Force all filesystems in /etc/fstab to have their quotas disabled.
-v, --verbose
Display a message for each filesystem affected.
-u, --user
Manipulate user quotas. This is the default.
-g, --group
Manipulate group quotas.
-p, --print-state
Instead of turning quotas off just print state of quotas (ie. whether. quota is on or off)
-x, --xfs-command delete
Free up the space used to hold quota information (maintained internally) within XFS. This option is only applicable to XFS, and is
silently ignored for other filesystem types. It can only be used on a filesystem with quota previously turned off.
-x, --xfs-command enforce
Switch off limit enforcement for XFS filesystems (perform quota accounting only). This is the default action for any XFS filesystem.
This option is only applicable to XFS, and is silently ignored for other filesystem types.
-x, --xfs-command account
This option can be used to disable quota accounting. It is not possible to enable quota accounting by quota tools. Use mount(8) for
that. This option is only applicable to XFS filesystems, and is silently ignored for other filesystem types.
NOTES ON XFS FILESYSTEMS
To enable quotas on an XFS filesystem, use mount(8) or /etc/fstab quota option to enable both accounting and limit enforcement. quotaon
utility cannot be used for this purpose.
Turning on quotas on an XFS root filesystem requires the quota mount options be passed into the kernel at boot time through the Linux root-
flags boot option.
To turn off quota limit enforcement on any XFS filesystem, first make sure that quota accounting and enforcement are both turned on using
repquota -v filesystem. Then, use quotaoff -v filesystem to disable limit enforcement. This may be done while the filesystem is mounted.
Turning on quota limit enforcement on an XFS filesystem is achieved using quotaon -v filesystem. This may be done while the filesystem is
mounted.
FILES
aquota.user or aquota.group
quota file at the filesystem root (version 2 quota, non-XFS filesystems)
quota.user or quota.group
quota file at the filesystem root (version 1 quota, non-XFS filesystems)
/etc/fstab default filesystems
SEE ALSO quotactl(2), fstab(5), quota_nld(8), repquota(8), warnquota(8)4th Berkeley DistributionQUOTAON(8)