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 ] [ -rm ] [ -F format-name ] [ -f
10       filesystem ] username...
11
12       edquota [ -u | -g ] [ -F format-name ] [ -f filesystem ] -t
13
14       edquota [ -u | -g ] [ -F format-name ] [ -f filesystem ] -T  username |
15       groupname...
16

DESCRIPTION

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

OPTIONS

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

FILES

109       aquota.user or aquota.group
110                           quota file at the filesystem root (version 2 quota,
111                           non-XFS filesystems)
112       quota.user or quota.group
113                           quota file at the filesystem root (version 1 quota,
114                           non-XFS filesystems)
115       /etc/mtab           mounted filesystems table
116

SEE ALSO

118       quota(1), vi(1), quotactl(2), quotacheck(8),  quotaon(8),  repquota(8),
119       setquota(8)
120
121
122
123                                                                    EDQUOTA(8)
Impressum