gfs2_quota(8)						      System Manager's Manual						     gfs2_quota(8)

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 opera-
       tions. 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 lim-
	      its 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

																     gfs2_quota(8)