1
2gfs2_quota(8)               System Manager's Manual              gfs2_quota(8)
3
4
5

NAME

7       gfs2_quota - Manipulate GFS2 disk quotas
8
9

SYNOPSIS

11       gfs2_quota <list|sync|get|limit|warn|check|init> [OPTION]...
12
13

DESCRIPTION

15       gfs2_quota  is  used  to  examine  and  change  quota  values in a GFS2
16       filesystem.  This command has a number of different actions.
17
18

ACTIONS

20       list   List the contents of the quota file.  Only IDs that have a  non-
21              zero hard limit, warn limit, or value are printed.
22
23       sync   Sync any local quota changes to the quota file.
24
25       get    Get  the current data for the ID specified by the -u or -g argu‐
26              ment.
27
28       limit  Set the current hard limit for the ID specified by the -u or  -g
29              argument to the value specified by the -l argument on the speci‐
30              fied filesystem.  The filesystem won't let the user or group use
31              more  than  this much space.  A value of zero here means that no
32              limit is enforced.
33
34       warn   Set the current warn limit for the ID specified by the -u or  -g
35              argument to the value specified by the -l argument on the speci‐
36              fied filesystem.  The filesystem will start complaining  to  the
37              user  or  group when more than this much space is used.  A value
38              of zero here means that the user won't ever be warned.
39
40       check  Scan a filesystem and make sure that what's  out  there  on  the
41              disk matches what's in the quota file.  This is only accurate if
42              the filesystem is idle when this is running.  If there is a mis‐
43              match,  it is printed to stdout.  Note: GFS2 quotas are transac‐
44              tional and a quota check is not needed every  time  there  is  a
45              system crash.
46
47       init   Scan  a filesystem and initialize the quota file with the values
48              obtained from the scan.  The filesystem should be idle when this
49              is  run.   You should only need to do this if you upgrade a pre-
50              quota GFS2 filesystem (pre-GFS2 5.1).
51
52

OPTIONS

54       -b The units for disk space are filesystem blocks.
55
56       -f Directory
57              Specifies which filesystem to perform the action on.
58
59       -g GID Specifies the group ID for get,  limit,  or  warn.   It  can  be
60              either the group name from the group file, or the GID number.
61
62       -h     Print   out   a   help   message  describing  available options,
63              then exit.
64
65       -k     The units for disk space are kilobytes.
66
67       -l Size
68              Specifies the new value for the  limit  or  warn  actions.   The
69              value is assumed to be in the units specified by the -m, -k, -s,
70              -b arguments.  The default is megabytes.
71
72       -m     The units for disk space are megabytes.  This is the default.
73
74       -n     Don't try to resolve UIDs and GIDs into user and group names.
75
76       -s     The units for disk space are sectors (512-byte blocks).
77
78       -u UID Specifies the user ID for get, limit, or warn.  It can be either
79              the username from the password file, or the UID number.
80
81       -V     Print program version information, then exit.
82
83

EXAMPLE

85       To  set  the  hard  limit  for  user  "nobody"  to 1048576 kilobytes on
86       filesystem /gfs20
87
88       gfs2_quota limit -l 1048576 -k -u nobody -f /gfs20
89
90
91
92
93                                                                 gfs2_quota(8)