Debian Codegraph @

upstream/debian-unstable/man8/edquota.8

raw
1 .TH EDQUOTA 8
2 .SH NAME
3 edquota \- edit user quotas
4 .SH SYNOPSIS
5 .B edquota
6 [
7 .B \-p
8 .I protoname
9 ] [
10 .BR \-u \ |
11 .BR \-g \ |
12 .B \-P
13 ] [
14 .B \-rm
15 ] [
16 .B \-F
17 .I format-name
18 ] [
19 .B \-f
20 .I filesystem
21 ]
22 .IR username \ |
23 .IR groupname \ |
24 .IR projectname .\|.\|.
25 .LP
26 .B edquota
27 [
28 .BR \-u \ |
29 .BR \-g \ |
30 .B \-P
31 ] [
32 .B \-F
33 .I format-name
34 ] [
35 .B \-f
36 .I filesystem
37 ]
38 .B \-t
39 .LP
40 .B edquota
41 [
42 .BR \-u \ |
43 .BR \-g \ |
44 .B \-P
45 ] [
46 .B \-F
47 .I format-name
48 ] [
49 .B \-f
50 .I filesystem
51 ]
52 .B \-T
53 .IR username \ |
54 .IR groupname \ |
55 .IR projectname .\|.\|.
56 .SH DESCRIPTION
57 .IX "edquota command" "" "\fLedquota\fP \(em edit user quotas"
58 .IX edit "user quotas \(em \fLedquota\fP"
59 .IX "user quotas" "edquota command" "" "\fLedquota\fP \(em edit user quotas"
60 .IX "disk quotas" "edquota command" "" "\fLedquota\fP \(em edit user quotas"
61 .IX "quotas" "edquota command" "" "\fLedquota\fP \(em edit user quotas"
62 .IX "filesystem" "edquota command" "" "\fLedquota\fP \(em edit user quotas"
63 .B edquota
64 is a quota editor. One or more users, groups, or projects may be specified
65 on the command line. If a number is given in the place of user/group/project
66 name it is treated as an UID/GID/Project ID. For each user, group, or project
67 a temporary file is created with an
68 .SM ASCII
69 representation of the current disk quotas for that user, group, or project and
70 an editor is then invoked on the file. The quotas may then be modified, new
71 quotas added, etc.
72 Setting a quota to zero indicates that no quota should be imposed.
73 .PP
74 Block usage and limits are reported and interpreted as multiples of kibibyte
75 (1024 bytes) blocks by default. Symbols K, M, G, and T can be appended to
76 numeric value to express kibibytes, mebibytes, gibibytes, and tebibytes.
77 .PP
78 Inode usage and limits are interpreted literally. Symbols k, m, g, and t can
79 be appended to numeric value to express multiples of 10^3, 10^6, 10^9, and
80 10^12 inodes.
81 .PP
82 Users are permitted to exceed their soft limits for a grace period that
83 may be specified per filesystem. Once the grace period has expired, the
84 soft limit is enforced as a hard limit.
85 .PP
86 The current usage information in the file is for informational purposes;
87 only the hard and soft limits can be changed.
88 .PP
89 Upon leaving the editor,
90 .B edquota
91 reads the temporary file and modifies the binary quota files to reflect
92 the changes made.
93 .LP
94 The editor invoked is
95 .BR editor (1)
96 unless either the
97 .SB EDITOR
98 or the
99 .SB VISUAL
100 environment variable specifies otherwise.
101 .LP
102 Only the super-user may edit quotas.
103 .SH OPTIONS
104 .TP
105 .B -r, --remote
106 Edit also non-local quota use rpc.rquotad on remote server to set quota.
107 This option is available only if quota tools were compiled with enabled
108 support for setting quotas over RPC.
109 The
110 .B -n
111 option is equivalent, and is maintained for backward compatibility.
112 .TP
113 .B -m, --no-mixed-pathnames
114 Currently, pathnames of NFSv4 mountpoints are sent without leading slash in the path.
115 .BR rpc.rquotad
116 uses this to recognize NFSv4 mounts and properly prepend pseudoroot of NFS filesystem
117 to the path. If you specify this option,
118 .BR edquota
119 will always send paths with a leading slash. This can be useful for legacy reasons but
120 be aware that quota over RPC will stop working if you are using new
121 .BR rpc.rquotad .
122 .TP
123 .B -u, --user
124 Edit the user quota. This is the default.
125 .TP
126 .B -g, --group
127 Edit the group quota.
128 .TP
129 .B -P, --project
130 Edit the project quota.
131 .TP
132 .B -p, --prototype=\f2protoname\f1
133 Duplicate the quotas of the prototypical user
134 specified for each user specified. This is the normal
135 mechanism used to initialize quotas for groups of users.
136 .TP
137 .B --always-resolve
138 Always try to translate user / group name to uid / gid even if the name
139 is composed of digits only.
140 .TP
141 .B -F, --format=\f2format-name\f1
142 Edit quota for specified format (ie. don't perform format autodetection).
143 Possible format names are:
144 .B vfsold
145 Original quota format with 16-bit UIDs / GIDs,
146 .B vfsv0
147 Quota format with 32-bit UIDs / GIDs, 64-bit space usage, 32-bit inode usage and limits,
148 .B vfsv1
149 Quota format with 64-bit quota limits and usage,
150 .B rpc
151 (quota over NFS),
152 .B xfs
153 (quota on XFS filesystem)
154 .TP
155 .B \-f, --filesystem \f2filesystem\f1
156 Perform specified operations only for given filesystem (default is to perform
157 operations for all filesystems with quota).
158 .TP
159 .B \-t, --edit-period
160 Edit the soft time limits for each filesystem.
161 In old quota format if the time limits are zero, the default time limits in
162 .B <linux/quota.h>
163 are used. In new quota format time limits must be specified (there is no default
164 value set in kernel). Time units of 'seconds', 'minutes', 'hours', and 'days'
165 are understood. Time limits are printed in the greatest possible time unit such that
166 the value is greater than or equal to one.
167 .TP
168 .B \-T, --edit-times
169 Edit time for the user/group/project when softlimit is enforced. Possible values
170 are 'unset' or number and unit. Units are the same as in
171 .B \-t
172 option.
173 .SH FILES
174 .PD 0
175 .TP 20
176 .BR aquota.user " or " aquota.group
177 quota file at the filesystem root (version 2 quota, non-XFS filesystems)
178 .TP
179 .BR quota.user " or " quota.group
180 quota file at the filesystem root (version 1 quota, non-XFS filesystems)
181 .TP
182 .B /etc/mtab
183 mounted filesystems table
184 .PD
185 .SH SEE ALSO
186 .BR quota (1),
187 .BR editor (1),
188 .BR quotactl (2),
189 .BR quotacheck (8),
190 .BR quotaon (8),
191 .BR repquota (8),
192 .BR setquota (8)