summaryrefslogtreecommitdiff
path: root/quotaon.8
blob: c24376307a25fe80f671b5d7d93e142a29b8c9ab (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
.TH QUOTAON 8
.UC 4
.SH NAME
quotaon, quotaoff \- turn filesystem quotas on and off
.SH SYNOPSIS
.B /usr/sbin/quotaon
[
.B \-vug
]
.IR filesystem .\|.\|.
.br
.B /usr/sbin/quotaon
[
.B \-avug
]
.LP
.B /usr/sbin/quotaoff
[
.B \-vugdo
]
[
.B \-x
.I state
]
.IR filesystem .\|.\|.
.br
.B /usr/sbin/quotaoff
[
.B \-avugdo
]
.SH DESCRIPTION
.SS quotaon
.IX  "quotaon command"  ""  "\fLquotaon\fP \(em turn filesystem quotas on"
.IX  "user quotas"  "quotaon command"  ""  "\fLquotaon\fP \(em turn filesystem quotas on"
.IX  "disk quotas"  "quotaon command"  ""  "\fLquotaon\fP \(em turn filesystem quotas on"
.IX  "quotas"  "quotaon command"  ""  "\fLquotaon\fP \(em turn filesystem quotas on"
.IX  "filesystem"  "quotaon command"  ""  "\fLquotaon\fP \(em turn filesystem quotas on"
.LP
.B quotaon
announces to the system that disk quotas should be enabled on one or
more filesystems. The filesystem quota files must be present in the root
directory of the specified filesystem and be named either
.IR aquota.user
(for version 2 user quota),
.IR quota.user
(for version 1 user quota),
.IR aquota.group
(for version 2 group quota), or
.IR quota.group
(for version 1 group quota).
.PP
XFS filesystems are a special case - XFS considers quota
information as filesystem metadata and uses journaling to provide
a higher level guarantee of consistency.
There are two components to the XFS disk quota system:
accounting and limit enforcement.
Except in the case of the root filesystem, XFS filesystems require
that quota accounting be turned on at mount time.
It is possible to enable and disable limit enforcement on any XFS
filesystem after quota accounting is already turned on.
The default is to turn on both accounting and enforcement.
.PP
The XFS quota implementation does not maintain quota information in
user-visible files, but rather stores this information internally.
.SS quotaoff
.IX  "quotaoff command"  ""  "\fLquotaoff\fP \(em turn filesystem quotas off"
.IX  "user quotas"  "quotaoff command"  ""  "\fLquotaoff\fP \(em turn filesystem quotas off"
.IX  "disk quotas"  "quotaoff command"  ""  "\fLquotaoff\fP \(em turn filesystem quotas off"
.IX  "quotas"  "quotaoff command"  ""  "\fLquotaoff\fP \(em turn filesystem quotas off"
.IX  "filesystem"  "quotaoff command"  ""  "\fLquotaoff\fP \(em turn filesystem quotas off"
.LP
.B quotaoff
announces to the system that the specified filesystems should
have any disk quotas turned off.
.SH OPTIONS
.SS quotaon
.TP
.B \-a
All filesystems in
.B /etc/fstab
marked read-write with quotas will have their quotas turned on.
This is normally used at boot time to enable quotas.
.TP
.B \-v
Display a message for each filesystem where quotas are turned on.
.TP
.B \-u
Manipulate user quotas. This is the default.
.TP
.B \-g
Manipulate group quotas.
.SS quotaoff
.TP
.B \-a
Force all filesystems in
.B /etc/fstab
to have their quotas disabled.
.TP
.B \-v
Display a message for each filesystem affected.
.TP
.B \-u
Manipulate user quotas. This is the default.
.TP
.B \-g
Manipulate group quotas.
.TP
.B \-x delete
Free up the space used to hold quota information (maintained
internally) within XFS.
This option is only applicable to XFS, and is silently
ignored for other filesystem types.
It can only be used on a filesystem with quota previously turned off.
.TP
.B \-x enforce
Switch off limit enforcement for XFS filesystems (perform
quota accounting only).
This option is only applicable to XFS, and is silently
ignored for other filesystem types.
.LP
.SH "XFS EXAMPLES"
.TP 0
.B "Turning on quotas on a non-root XFS filesystem"
Use
.IR mount (8)
or
.B /etc/fstab
option quota to enable both accounting and limit enforcement.
.B quotaon
utility cannot be used for this purpose.
.TP
.B "Turning on quotas on an XFS root filesystem"
Use
.BR "quotaon -v /" ,
and
.IR reboot (8).
This procedure will enable both accounting and limit enforcement.
.TP
.B "Turning off quota limit enforcement on any XFS filesystem"
Make sure that quota accounting and enforcement are both turned on using
.BR "repquota -s" .
Use
.B "quotaoff -vo"
to disable limit enforcement.
This may be done while the filesystem is mounted.
.TP
.BR "Turning on quota limit enforcement on any XFS filesystem"
Make sure that quota accounting is turned on using
.BR "repquota -s" .
Use
.BR "quotaon -v" .
This may be done while the filesystem is mounted.
.SH FILES
.PD 0
.TP 20
.B aquota.user or aquota.group
quota file at the filesystem root (version 2 quota, non-XFS filesystems)
.TP
.B quota.user or quota.group
quota file at the filesystem root (version 1 quota, non-XFS filesystems)
.TP
.B /etc/fstab
default filesystems
.PD
.SH "SEE ALSO"
.BR quotactl (2),
.BR fstab (5),
.BR repquota (8).