Debian Codegraph @

upstream/debian-unstable/man8/quotaon.8

raw
1 .TH QUOTAON 8
2 .UC 4
3 .SH NAME
4 quotaon, quotaoff \- turn filesystem quotas on and off
5 .SH SYNOPSIS
6 .B quotaon
7 [
8 .B \-vugfp
9 ] [
10 .B \-F
11 .I format-name
12 ]
13 .IR filesystem .\|.\|.
14 .br
15 .B quotaon
16 [
17 .B \-avugPfp
18 ] [
19 .B \-F
20 .I format-name
21 ]
22 .LP
23 .B quotaoff
24 [
25 .B \-vugPp
26 ]
27 [
28 .B \-x
29 .I state
30 ]
31 .IR filesystem .\|.\|.
32 .br
33 .B quotaoff
34 [
35 .B \-avugp
36 ]
37 .SH DESCRIPTION
38 .SS quotaon
39 .IX "quotaon command" "" "\fLquotaon\fP \(em turn filesystem quotas on"
40 .IX "user quotas" "quotaon command" "" "\fLquotaon\fP \(em turn filesystem quotas on"
41 .IX "disk quotas" "quotaon command" "" "\fLquotaon\fP \(em turn filesystem quotas on"
42 .IX "quotas" "quotaon command" "" "\fLquotaon\fP \(em turn filesystem quotas on"
43 .IX "filesystem" "quotaon command" "" "\fLquotaon\fP \(em turn filesystem quotas on"
44 .LP
45 .B quotaon
46 announces to the system that disk quotas should be enabled on one or
47 more filesystems. The filesystem quota files must be present in the root
48 directory of the specified filesystem and be named either
49 .IR aquota.user
50 (for version 2 user quota),
51 .IR quota.user
52 (for version 1 user quota),
53 .IR aquota.group
54 (for version 2 group quota), or
55 .IR quota.group
56 (for version 1 group quota).
57 .PP
58 XFS filesystems are a special case - XFS considers quota
59 information as filesystem metadata and uses journaling to provide
60 a higher level guarantee of consistency.
61 There are two components to the XFS disk quota system:
62 accounting and limit enforcement.
63 XFS filesystems require that quota accounting be turned on at mount time.
64 It is possible to enable and disable limit enforcement on an XFS
65 filesystem after quota accounting is already turned on.
66 The default is to turn on both accounting and enforcement.
67 .PP
68 The XFS quota implementation does not maintain quota information in
69 user-visible files, but rather stores this information internally.
70 .SS quotaoff
71 .IX "quotaoff command" "" "\fLquotaoff\fP \(em turn filesystem quotas off"
72 .IX "user quotas" "quotaoff command" "" "\fLquotaoff\fP \(em turn filesystem quotas off"
73 .IX "disk quotas" "quotaoff command" "" "\fLquotaoff\fP \(em turn filesystem quotas off"
74 .IX "quotas" "quotaoff command" "" "\fLquotaoff\fP \(em turn filesystem quotas off"
75 .IX "filesystem" "quotaoff command" "" "\fLquotaoff\fP \(em turn filesystem quotas off"
76 .LP
77 .B quotaoff
78 announces to the system that the specified filesystems should
79 have any disk quotas turned off.
80 .SH OPTIONS
81 .SS quotaon
82 .TP
83 .B -F, --format=\f2format-name\f1
84 Report quota for specified format (ie. don't perform format autodetection).
85 Possible format names are:
86 .B vfsold
87 Original quota format with 16-bit UIDs / GIDs,
88 .B vfsv0
89 Quota format with 32-bit UIDs / GIDs, 64-bit space usage, 32-bit inode usage and limits,
90 .B vfsv1
91 Quota format with 64-bit quota limits and usage,
92 .B xfs
93 (quota on XFS filesystem)
94 .TP
95 .B -a, --all
96 All automatically mounted (no
97 .B noauto
98 option) non-NFS filesystems in
99 .B /etc/fstab
100 with quotas will have their quotas turned on.
101 This is normally used at boot time to enable quotas.
102 .TP
103 .B -v, --verbose
104 Display a message for each filesystem where quotas are turned on.
105 .TP
106 .B -u, --user
107 Manipulate user quotas. This is the default.
108 .TP
109 .B -g, --group
110 Manipulate group quotas.
111 .TP
112 .B -P, --project
113 Manipulate project quotas.
114 .TP
115 .B -p, --print-state
116 Instead of turning quotas on just print state of quotas (ie. whether. quota is on or off)
117 .TP
118 .B -x, --xfs-command enforce
119 Switch on limit enforcement for XFS filesystems. This is the default action for
120 any XFS filesystem. This option is only applicable to XFS, and is silently
121 ignored for other filesystem types.
122 .TP
123 .B -f, --off
124 Make
125 .B quotaon
126 behave like being called as
127 .BR quotaoff .
128 .SS quotaoff
129 .TP
130 .B -F, --format=\f2format-name\f1
131 Report quota for specified format (ie. don't perform format autodetection).
132 Possible format names are:
133 .B vfsold
134 (version 1 quota),
135 .B vfsv0
136 (version 2 quota),
137 .B xfs
138 (quota on XFS filesystem)
139 .TP
140 .B -a, --all
141 Force all filesystems in
142 .B /etc/fstab
143 to have their quotas disabled.
144 .TP
145 .B -v, --verbose
146 Display a message for each filesystem affected.
147 .TP
148 .B -u, --user
149 Manipulate user quotas. This is the default.
150 .TP
151 .B -g, --group
152 Manipulate group quotas.
153 .TP
154 .B -P, --project
155 Manipulate project quotas.
156 .TP
157 .B -p, --print-state
158 Instead of turning quotas off just print state of quotas (ie. whether. quota is on or off)
159 .TP
160 .B -x, --xfs-command delete
161 Free up the space used to hold quota information (maintained
162 internally) within XFS.
163 This option is only applicable to XFS, and is silently
164 ignored for other filesystem types.
165 It can only be used on a filesystem with quota previously turned off.
166 .TP
167 .B -x, --xfs-command enforce
168 Switch off limit enforcement for XFS filesystems (perform quota accounting
169 only). This is the default action for any XFS filesystem. This option is only
170 applicable to XFS, and is silently ignored for other filesystem types.
171 .TP
172 .B -x, --xfs-command account
173 This option can be used to disable quota accounting. It is not possible to
174 enable quota accounting by quota tools. Use
175 .IR mount (8)
176 for that. This option is only applicable to XFS filesystems, and is silently
177 ignored for other filesystem types.
178 .SH "NOTES ON XFS FILESYSTEMS"
179 To enable quotas on an XFS filesystem, use
180 .IR mount (8)
181 or
182 .B /etc/fstab
183 quota option to enable both accounting and limit enforcement.
184 .B quotaon
185 utility cannot be used for this purpose.
186 .PP
187 Turning on quotas on an XFS root filesystem requires the quota mount
188 options be passed into the kernel at boot time through the Linux
189 .B rootflags
190 boot option.
191 .PP
192 To turn off quota limit enforcement on any XFS filesystem, first make
193 sure that quota accounting and enforcement are both turned on using
194 .B "repquota -v"
195 .IR filesystem .
196 Then, use
197 .B "quotaoff -v
198 .I filesystem
199 to disable limit enforcement.
200 This may be done while the filesystem is mounted.
201 .PP
202 Turning on quota limit enforcement on an XFS filesystem is
203 achieved using
204 .B "quotaon -v"
205 .IR filesystem .
206 This may be done while the filesystem is mounted.
207 .SH FILES
208 .PD 0
209 .TP 20
210 .B aquota.user or aquota.group
211 quota file at the filesystem root (version 2 quota, non-XFS filesystems)
212 .TP
213 .B quota.user or quota.group
214 quota file at the filesystem root (version 1 quota, non-XFS filesystems)
215 .TP
216 .B /etc/fstab
217 default filesystems
218 .PD
219 .SH "SEE ALSO"
220 .BR quotactl (2),
221 .BR fstab (5),
222 .BR quota_nld (8),
223 .BR repquota (8),
224 .BR warnquota (8)