Update to 4.01.
[profile/ivi/quota.git] / setquota.8
1 .TH SETQUOTA 8
2 .SH NAME
3 setquota \- set disk quotas
4 .SH SYNOPSIS
5 .B setquota
6 [
7 .B \-rm
8 ]
9 [
10 .B \-u
11 |
12 .B \-g
13 ]
14 [
15 .B \-F
16 .I quotaformat
17 ]
18 .I name
19 .I block-softlimit
20 .I block-hardlimit
21 .I inode-softlimit
22 .I inode-hardlimit
23 .B \-a
24 |
25 .I filesystem...
26 .LP
27 .B setquota
28 [
29 .B \-rm
30 ]
31 [
32 .B \-u
33 |
34 .B \-g
35 ]
36 [
37 .B \-F
38 .I quotaformat
39 ]
40 [
41 .B \-p
42 .I protoname 
43 ]
44 .I name
45 .B \-a
46 |
47 .I filesystem...
48 .LP
49 .B setquota
50 .B \-b
51 [
52 .B \-rm
53 ]
54 [
55 .B \-u
56 |
57 .B \-g
58 ]
59 [
60 .B \-F
61 .I quotaformat
62 ]
63 .B \-a
64 |
65 .I filesystem...
66 .LP
67 .B setquota
68 .B \-t
69 [
70 .B \-u
71 |
72 .B \-g
73 ]
74 [
75 .B \-F
76 .I quotaformat
77 ]
78 .I block-grace
79 .I inode-grace
80 .B \-a
81 |
82 .I filesystem...
83 .LP
84 .B setquota
85 .B \-T
86 [
87 .B \-u
88 |
89 .B \-g
90 ]
91 [
92 .B \-F
93 .I quotaformat
94 ]
95 .I name
96 .I block-grace
97 .I inode-grace
98 .B \-a
99 |
100 .I filesystem...
101 .SH DESCRIPTION
102 .IX  "setquota command"  ""  "\fLsetquota\fP \(em set disk quotas"
103 .IX  set "disk quotas \(em \fLsetquota\fP"
104 .IX  "disk quotas"  "setquota command"  ""  "\fLsetquota\fP \(em set disk quotas"
105 .IX  "disk quotas"  "setquota command"  ""  "\fLsetquota\fP \(em set disk quotas"
106 .IX  "quotas"  "setquota command"  ""  "\fLsetquota\fP \(em set disk quotas"
107 .IX  "filesystem"  "setquota command"  ""  "\fLsetquota\fP \(em set disk quotas"
108 .B setquota
109 is a command line quota editor.
110 The filesystem, user/group name and new quotas for this
111 filesystem can be specified on the command line. Note that if a number is
112 given in the place of a user/group name it is treated as an UID/GID.
113 .TP
114 .B -r, --remote
115 Edit also remote quota use rpc.rquotad on remote server to set quota. This
116 option is available only if quota tools were compiled with enabled support
117 for setting quotas over RPC.
118 .TP
119 .B -m, --no-mixed-pathnames
120 Currently, pathnames of NFSv4 mountpoints are sent without leading slash in the path.
121 .BR rpc.rquotad
122 uses this to recognize NFSv4 mounts and properly prepend pseudoroot of NFS filesystem
123 to the path. If you specify this option,
124 .BR setquota
125 will always send paths with a leading slash. This can be useful for legacy reasons but
126 be aware that quota over RPC will stop working if you are using new
127 .BR rpc.rquotad .
128 .TP
129 .B -F, --format=\f2quotaformat\f1
130 Perform setting for specified format (ie. don't perform format autodetection).
131 Possible format names are:
132 .B vfsold
133 Original quota format with 16-bit UIDs / GIDs,
134 .B vfsv0
135 Quota format with 32-bit UIDs / GIDs, 64-bit space usage, 32-bit inode usage and limits,
136 .B vfsv1
137 Quota format with 64-bit quota limits and usage,
138 .B rpc
139 (quota over NFS),
140 .B xfs
141 (quota on XFS filesystem)
142 .TP
143 .B -u, --user
144 Set user quotas for named user. This is the default.
145 .TP
146 .B -g, --group
147 Set group quotas for named group.
148 .TP
149 .B -p, --prototype=\f2protoname\f1
150 Use quota settings of user or group
151 .I protoname
152 to set the quota for the named user or group.
153 .TP
154 .B --always-resolve
155 Always try to translate user / group name to uid / gid even if the name
156 is composed of digits only.
157 .TP
158 .B -b, --batch
159 Read information to set from stdin (input format is
160 .I name block-softlimit block-hardlimit inode-softlimit inode-hardlimit
161 ). Empty lines and lines starting with # are ignored.
162 .TP
163 .B -c, --continue-batch
164 If parsing of an input line in batch mode fails, continue with processing the next line.
165 .TP
166 .B -t, --edit-period
167 Set grace times for users/groups. Times
168 .B block-grace
169 and
170 .B inode-grace
171 are specified in seconds.
172 .TP
173 .B -T, --edit-times
174 Alter times for individual user/group when softlimit is enforced. Times
175 .B block-grace
176 and
177 .B inode-grace
178 are specified in seconds or can be string 'unset'.
179 .TP
180 .B -a, --all
181 Go through all filesystems with quota in
182 .B /etc/mtab
183 and perform setting.
184 .PP
185 To disable a quota, set the corresponding parameter to 0. To change quotas
186 for several filesystems, invoke once for each filesystem.
187 .PP
188 Only the super-user may edit quotas.
189 .SH FILES
190 .PD 0
191 .TP 20
192 .B aquota.user or aquota.group
193 quota file at the filesystem root (version 2 quota, non-XFS filesystems)
194 .TP
195 .B quota.user or quota.group
196 quota file at the filesystem root (version 1 quota, non-XFS filesystems)
197 .TP
198 .B /etc/mtab
199 mounted filesystem table
200 .PD
201 .SH SEE ALSO
202 .BR edquota (8),
203 .BR quota (1),
204 .BR quotactl (2),
205 .BR quotacheck (8),
206 .BR quotaon (8),
207 .BR repquota (8)