quotatool(8)

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

NAME

6       quotatool - manipulate filesystem quotas
7

SYNOPSIS

9       quotatool  [-u  uid  |  -g gid] [-b | -i] [-r | -l NUM | -q NUM] [-nvR]
10       [-d] filesystem
11       quotatool (-u | -g) (-b | -i) -t TIME [-nv] filesystem
12       quotatool [-hV]
13

DESCRIPTION

15       quotatool is a tool for manipulating filesystem quotas.   Depending  on
16       the  commandline options given, it can set hard or soft limits on block
17       and inode usage, set and reset grace periods, for both  users  and  (if
18       your  system supports this) groups.  The filesystem to set the quota on
19       is given as the first (and only) non-option element, and it  is  either
20       the  block special file (i.e /dev/sda3) or the mount point (i.e. /home)
21       for the filesystem.
22

OPTIONS

24       -u [uid]
25              Set user quotas
26
27       -g [gid]
28              Set group quotas
29
30       uid and gid are either the numerical ID of the user or  group,  or  its
31       name in the /etc/passwd and /etc/group files.
32
33       -b     Set block quotas [default]
34
35       -i     Set inode quotas
36
37       The -b and -i  options are persistent -- they stay in effect until they
38       are overridden.
39
40       -R     Only raise quotas, never lower. Makes sure  you  don't  acciden‐
41              tally lower quotas for a user/group.
42
43       -t TIME
44              Set  the  system-wide grace period to TIME.  TIME consists of an
45              optional '-' or '+' character, a number, and optionally  one  of
46              the  following modifiers: "seconds", "minutes", "hours", "days",
47              "weeks", or "months".  Unique abbreviations (e.g. "s", "mo") are
48              also accepted. The default is "seconds".  The argument should be
49              preceded by -u|-g and -b|-i
50
51       -r     Reset the grace period
52
53       -l NUM Set hard limit to NUM
54
55       -q NUM Set soft limit (quota) to NUM
56
57       NUM consists of an optional '-' or '+' character, a number, and option‐
58       ally  one of the following modifiers: "MB", "kB", "bytes", or "blocks".
59       Unique abbreviations are also accepted.  The default is "blocks"
60
61       If +/- is supplied, the existing quota is increased or reduced  by  the
62       specified amount.
63
64       -d     Dump quota info for user/group in a machine readable format:
65
66                                 |-------  BLOCKS  --------|  |--------  FILES
67              --------|
68              uid/gid mountpoint current quota limit grace current quota limit
69              grace
70
71              grace  is  the  number  of seconds from now until the grace time
72              ends. May be negative = time already passed. When quota  is  not
73              passed, grace is zero.
74
75       -n     dry-run:  show  what  would have been done but don't change any‐
76              thing.  Use together with -v
77
78       -v     Verbose output. Use twice or thrice for even more output (debug‐
79              ging)
80
81       -h     Print a usage message to stdout and exit successfully
82
83       -V     Print version information to stdout and exit successfully
84

FILESYSTEMS / FORMATS

86       On Linux, quotatool works with both "old" and "new" + "generic" kernel-
87       quota formats and also has support for quotas on XFS.
88

FILES

90       quota.user , quota.group (linux)
91       quotas (solaris, ...)
92

BUGS

94       Calling quotatool with more than one -v option will cause a segfault on
95       some  systems.  This will happen if vprintf (3) fails to check for NULL
96       arguments.  GNU libc doesn't have this problem, solaris libc does.
97