Provided by: gfs-tools_1.20060222-0ubuntu5_i386 bug

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)