| 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) |