Provided by: gfs2-utils_3.1.3-0ubuntu1_i386 bug

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

                                                                 gfs2_quota(8)