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 argu
- ment.
- 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 prequota 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