.TH gfs_quota 8

.SH NAME
gfs_quota - Manipulate GFS disk quotas

.SH SYNOPSIS
.B gfs_quota
<list|sync|get|limit|warn|check|init> [\fIOPTION\fR]...

.SH DESCRIPTION
gfs_quota is used to examine and change quota values in a GFS filesystem.
This command has a number of different actions.

.SH ACTIONS
.TP
\fBlist\fP
List the contents of the quota file.  Only IDs that have a non-zero hard limit,
warn limit, or value are printed.
.TP
\fBsync\fP
Sync any local quota changes to the quota file.
.TP
\fBget\fP
Get the current data for the ID specified by the -u or -g argument.
.TP
\fBlimit\fP
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.
.TP
\fBwarn\fP
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.
.TP
\fBcheck\fP
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 \fBnot\fP
needed every time there is a system crash.
.TP
\fBinit\fP
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).

.SH OPTIONS
\fB-b\fP
The units for disk space are filesystem blocks.
.TP
\fB-d\fP
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.
.TP
\fB-f\fP \fIDirectory\fR 
Specifies which filesystem to perform the action on.
.TP
\fB-g\fP \fIGID\fR 
Specifies the group ID for get, limit, or warn.  It can be either
the group name from the group file, or the GID number.
.TP
\fB-h\fP
Print  out  a  help  message  describing  available
options, then exit.
.TP
\fB-k\fP
The units for disk space are kilobytes.
.TP
\fB-l\fP \fISize\fR 
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.
.TP
\fB-m\fP
The units for disk space are megabytes.  This is the default.
.TP
\fB-n\fP
Don't try to resolve UIDs and GIDs into user and group names.
.TP
\fB-s\fP
The units for disk space are sectors (512-byte blocks).
.TP
\fB-u\fP \fIUID\fR 
Specifies the user ID for get, limit, or warn.  It can be either
the username from the password file, or the UID number.
.TP
\fB-V\fP
Print program version information, then exit.

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