NAME¶
gfs2_quota - Manipulate GFS2 disk quotas
SYNOPSIS¶
gfs2_quota <list|sync|get|limit|warn|check|init|reset> [
OPTION]...
DESCRIPTION¶
gfs2_quota is used to examine and change quota values in a GFS2 filesystem. This
command has a number of different actions.
GFS2 introduced a new linked list format for the quotas in the quota file. This
list format allows for faster
list,
check and
init
operations. Older GFS2 quota files may be migrated to this newer format using
the
gfs2_quota reset command.
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: GFS2 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 GFS2
filesystem (pre-GFS2 5.1).
- reset
- The reset operation will truncate the quota file and
all quota information (values, limits, warnings) will be lost. All quota
limits and warnings will have to be reassigned after this operation.
OPTIONS¶
-b The units for disk space are filesystem blocks.
- -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 /gfs20
gfs2_quota limit -l 1048576 -k -u nobody -f /gfs20