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

NAME

6       edquota - edit user quotas
7

SYNOPSIS

9       edquota  [ -p protoname ] [ -u | -g | -P ] [ -rm ] [ -F format-name ] [
10       -f filesystem ] username | groupname | projectname...
11
12       edquota [ -u | -g | -P ] [ -F format-name ] [ -f filesystem ] -t
13
14       edquota [ -u | -g | -P ] [ -F format-name ] [ -f filesystem ] -T  user‐
15       name | groupname | projectname...
16

DESCRIPTION

18       edquota  is a quota editor.  One or more users, groups, or projects may
19       be specified on the command line. If a number is given in the place  of
20       user/group/project  name  it  is  treated as an UID/GID/Project ID. For
21       each user, group, or project a temporary file is created with an  ASCII
22       representation  of  the  current  disk  quotas for that user, group, or
23       project and an editor is then invoked on the file.  The quotas may then
24       be  modified, new quotas added, etc.  Setting a quota to zero indicates
25       that no quota should be imposed.
26
27       Block usage and limits are reported and  interpreted  as  multiples  of
28       kibibyte  (1024 bytes) blocks by default. Symbols K, M, G, and T can be
29       appended to numeric value to express kibibytes,  mebibytes,  gibibytes,
30       and tebibytes.
31
32       Inode  usage and limits are interpreted literally. Symbols k, m, g, and
33       t can be appended to numeric value to express multiples of 10^3,  10^6,
34       10^9, and 10^12 inodes.
35
36       Users are permitted to exceed their soft limits for a grace period that
37       may be specified per filesystem.  Once the grace  period  has  expired,
38       the soft limit is enforced as a hard limit.
39
40       The  current  usage  information  in the file is for informational pur‐
41       poses; only the hard and soft limits can be changed.
42
43       Upon leaving the editor, edquota reads the temporary file and  modifies
44       the binary quota files to reflect the changes made.
45
46       The  editor  invoked  is  vi(1)  unless either the EDITOR or the VISUAL
47       environment variable specifies otherwise.
48
49       Only the super-user may edit quotas.
50

OPTIONS

52       -r, --remote
53              Edit also non-local quota use rpc.rquotad on  remote  server  to
54              set  quota.   This  option is available only if quota tools were
55              compiled with enabled support for setting quotas over RPC.   The
56              -n option is equivalent, and is maintained for backward compati‐
57              bility.
58
59       -m, --no-mixed-pathnames
60              Currently, pathnames of NFSv4 mountpoints are sent without lead‐
61              ing slash in the path.  rpc.rquotad uses this to recognize NFSv4
62              mounts and properly prepend pseudoroot of NFS filesystem to  the
63              path. If you specify this option, edquota will always send paths
64              with a leading slash. This can be useful for legacy reasons  but
65              be  aware that quota over RPC will stop working if you are using
66              new rpc.rquotad.
67
68       -u, --user
69              Edit the user quota. This is the default.
70
71       -g, --group
72              Edit the group quota.
73
74       -P, --project
75              Edit the project quota.
76
77       -p, --prototype=protoname
78              Duplicate the quotas of the prototypical user specified for each
79              user specified.  This is the normal mechanism used to initialize
80              quotas for groups of users.
81
82       --always-resolve
83              Always try to translate user / group name to uid / gid  even  if
84              the name is composed of digits only.
85
86       -F, --format=format-name
87              Edit  quota  for  specified  format  (ie.  don't  perform format
88              autodetection).  Possible  format  names  are:  vfsold  Original
89              quota  format  with  16-bit UIDs / GIDs, vfsv0 Quota format with
90              32-bit UIDs / GIDs, 64-bit space usage, 32-bit inode  usage  and
91              limits,  vfsv1  Quota format with 64-bit quota limits and usage,
92              rpc (quota over NFS), xfs (quota on XFS filesystem)
93
94       -f, --filesystem filesystem
95              Perform specified operations only for given filesystem  (default
96              is to perform operations for all filesystems with quota).
97
98       -t, --edit-period
99              Edit  the  soft  time  limits for each filesystem.  In old quota
100              format if the time limits are zero, the default time  limits  in
101              <linux/quota.h>  are  used. In new quota format time limits must
102              be specified (there is no default value  set  in  kernel).  Time
103              units  of  'seconds',  'minutes', 'hours', and 'days' are under‐
104              stood. Time limits are printed in  the  greatest  possible  time
105              unit such that the value is greater than or equal to one.
106
107       -T, --edit-times
108              Edit time for the user/group/project when softlimit is enforced.
109              Possible values are 'unset' or number and unit.  Units  are  the
110              same as in -t option.
111

FILES

113       aquota.user or aquota.group
114                           quota file at the filesystem root (version 2 quota,
115                           non-XFS filesystems)
116       quota.user or quota.group
117                           quota file at the filesystem root (version 1 quota,
118                           non-XFS filesystems)
119       /etc/mtab           mounted filesystems table
120

SEE ALSO

122       quota(1),  vi(1),  quotactl(2), quotacheck(8), quotaon(8), repquota(8),
123       setquota(8)
124
125
126
127                                                                    EDQUOTA(8)
Impressum