Initial commit to Gerrit
[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 \-m
71 ] [
72 .B \-u
73 |
74 .B \-g
75 ]
76 [
77 .B \-F
78 .I quotaformat
79 ]
80 .I block-grace
81 .I inode-grace
82 .B \-a
83 |
84 .I filesystem...
85 .LP
86 .B setquota
87 .B \-T
88 [
89 .B \-m
90 ] [
91 .B \-u
92 |
93 .B \-g
94 ]
95 [
96 .B \-F
97 .I quotaformat
98 ]
99 .I name
100 .I block-grace
101 .I inode-grace
102 .B \-a
103 |
104 .I filesystem...
105 .SH DESCRIPTION
106 .IX  "setquota command"  ""  "\fLsetquota\fP \(em set disk quotas"
107 .IX  set "disk quotas \(em \fLsetquota\fP"
108 .IX  "disk quotas"  "setquota command"  ""  "\fLsetquota\fP \(em set disk quotas"
109 .IX  "disk quotas"  "setquota command"  ""  "\fLsetquota\fP \(em set disk quotas"
110 .IX  "quotas"  "setquota command"  ""  "\fLsetquota\fP \(em set disk quotas"
111 .IX  "filesystem"  "setquota command"  ""  "\fLsetquota\fP \(em set disk quotas"
112 .B setquota
113 is a command line quota editor.
114 The filesystem, user/group name and new quotas for this
115 filesystem can be specified on the command line. Note that if a number is
116 given in the place of a user/group name it is treated as an UID/GID.
117 .TP
118 .B -r, --remote
119 Edit also remote quota use rpc.rquotad on remote server to set quota. This
120 option is available only if quota tools were compiled with enabled support
121 for setting quotas over RPC.
122 .TP
123 .B -m, --no-mixed-pathnames
124 Currently, pathnames of NFSv4 mountpoints are sent without leading slash in the path.
125 .BR rpc.rquotad
126 uses this to recognize NFSv4 mounts and properly prepend pseudoroot of NFS filesystem
127 to the path. If you specify this option,
128 .BR setquota
129 will always send paths with a trailing slash. This can be useful for legacy reasons but
130 be aware that quota over RPC will stop working if you are using new
131 .BR rpc.rquotad .
132 .TP
133 .B -F, --format=\f2quotaformat\f1
134 Perform setting for specified format (ie. don't perform format autodetection).
135 Possible format names are:
136 .B vfsold
137 Original quota format with 16-bit UIDs / GIDs,
138 .B vfsv0
139 Quota format with 32-bit UIDs / GIDs, 64-bit space usage, 32-bit inode usage and limits,
140 .B vfsv1
141 Quota format with 64-bit quota limits and usage,
142 .B rpc
143 (quota over NFS),
144 .B xfs
145 (quota on XFS filesystem)
146 .TP
147 .B -u, --user
148 Set user quotas for named user. This is the default.
149 .TP
150 .B -g, --group
151 Set group quotas for named group.
152 .TP
153 .B -p, --prototype=\f2protoname\f1
154 Use quota settings of user or group
155 .I protoname
156 to set the quota for the named user or group.
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 coresponding 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)