1gfs2_quota(8) System Manager's Manual gfs2_quota(8)
2
6 gfs2_quota - Manipulate GFS2 disk quotas
7
10 gfs2_quota <list|sync|get|limit|warn|check|init|reset> [OPTION]...
11
14 gfs2_quota is used to examine and change quota values in a GFS2
15 filesystem. This command has a number of different actions.
16 GFS2 introduced a new linked list format for the quotas in the quota
18 file. This list format allows for faster list, check and init opera‐
19 tions. Older GFS2 quota files may be migrated to this newer format
20 using the gfs2_quota reset command.
21
24 list List the contents of the quota file. Only IDs that have a non-
25 zero hard limit, warn limit, or value are printed.
26 sync Sync any local quota changes to the quota file.
28 get Get the current data for the ID specified by the -u or -g argu‐
30 ment.
31 limit Set the current hard limit for the ID specified by the -u or -g
33 argument to the value specified by the -l argument on the speci‐
34 fied filesystem. The filesystem won't let the user or group use
35 more than this much space. A value of zero here means that no
36 limit is enforced.
37 warn Set the current warn limit for the ID specified by the -u or -g
39 argument to the value specified by the -l argument on the speci‐
40 fied filesystem. The filesystem will start complaining to the
41 user or group when more than this much space is used. A value
42 of zero here means that the user won't ever be warned.
43 check Scan a filesystem and make sure that what's out there on the
45 disk matches what's in the quota file. This is only accurate if
46 the filesystem is idle when this is running. If there is a mis‐
47 match, it is printed to stdout. Note: GFS2 quotas are transac‐
48 tional and a quota check is not needed every time there is a
49 system crash.
50 init Scan a filesystem and initialize the quota file with the values
52 obtained from the scan. The filesystem should be idle when this
53 is run. You should only need to do this if you upgrade a pre-
54 quota GFS2 filesystem (pre-GFS2 5.1).
55 reset The reset operation will truncate the quota file and all quota
57 information (values, limits, warnings) will be lost. All quota
58 limits and warnings will have to be reassigned after this opera‐
59 tion.
60
63 -b The units for disk space are filesystem blocks.
64 -f Directory
66 Specifies which filesystem to perform the action on.
67 -g GID Specifies the group ID for get, limit, or warn. It can be
69 either the group name from the group file, or the GID number.
70 -h Print out a help message describing available options,
72 then exit.
73 -k The units for disk space are kilobytes.
75 -l Size
77 Specifies the new value for the limit or warn actions. The
78 value is assumed to be in the units specified by the -m, -k, -s,
79 -b arguments. The default is megabytes.
80 -m The units for disk space are megabytes. This is the default.
82 -n Don't try to resolve UIDs and GIDs into user and group names.
84 -s The units for disk space are sectors (512-byte blocks).
86 -u UID Specifies the user ID for get, limit, or warn. It can be either
88 the username from the password file, or the UID number.
89 -V Print program version information, then exit.
91
94 To set the hard limit for user "nobody" to 1048576 kilobytes on
95 filesystem /gfs20
96 gfs2_quota limit -l 1048576 -k -u nobody -f /gfs20
98 gfs2_quota(8)