summaryrefslogtreecommitdiffstats
path: root/upstream/opensuse-leap-15-6/man8/quotaon.8
diff options
context:
space:
mode:
Diffstat (limited to 'upstream/opensuse-leap-15-6/man8/quotaon.8')
-rw-r--r--upstream/opensuse-leap-15-6/man8/quotaon.8224
1 files changed, 224 insertions, 0 deletions
diff --git a/upstream/opensuse-leap-15-6/man8/quotaon.8 b/upstream/opensuse-leap-15-6/man8/quotaon.8
new file mode 100644
index 00000000..0a2d2680
--- /dev/null
+++ b/upstream/opensuse-leap-15-6/man8/quotaon.8
@@ -0,0 +1,224 @@
+.TH QUOTAON 8
+.UC 4
+.SH NAME
+quotaon, quotaoff \- turn filesystem quotas on and off
+.SH SYNOPSIS
+.B quotaon
+[
+.B \-vugfp
+] [
+.B \-F
+.I format-name
+]
+.IR filesystem .\|.\|.
+.br
+.B quotaon
+[
+.B \-avugPfp
+] [
+.B \-F
+.I format-name
+]
+.LP
+.B quotaoff
+[
+.B \-vugPp
+]
+[
+.B \-x
+.I state
+]
+.IR filesystem .\|.\|.
+.br
+.B quotaoff
+[
+.B \-avugp
+]
+.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.
+XFS filesystems require that quota accounting be turned on at mount time.
+It is possible to enable and disable limit enforcement on an 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 -F, --format=\f2format-name\f1
+Report quota for specified format (ie. don't perform format autodetection).
+Possible format names are:
+.B vfsold
+Original quota format with 16-bit UIDs / GIDs,
+.B vfsv0
+Quota format with 32-bit UIDs / GIDs, 64-bit space usage, 32-bit inode usage and limits,
+.B vfsv1
+Quota format with 64-bit quota limits and usage,
+.B xfs
+(quota on XFS filesystem)
+.TP
+.B -a, --all
+All automatically mounted (no
+.B noauto
+option) non-NFS filesystems in
+.B /etc/fstab
+with quotas will have their quotas turned on.
+This is normally used at boot time to enable quotas.
+.TP
+.B -v, --verbose
+Display a message for each filesystem where quotas are turned on.
+.TP
+.B -u, --user
+Manipulate user quotas. This is the default.
+.TP
+.B -g, --group
+Manipulate group quotas.
+.TP
+.B -P, --project
+Manipulate project quotas.
+.TP
+.B -p, --print-state
+Instead of turning quotas on just print state of quotas (ie. whether. quota is on or off)
+.TP
+.B -x, --xfs-command enforce
+Switch on limit enforcement for XFS filesystems. This is the default action for
+any XFS filesystem. This option is only applicable to XFS, and is silently
+ignored for other filesystem types.
+.TP
+.B -f, --off
+Make
+.B quotaon
+behave like being called as
+.BR quotaoff .
+.SS quotaoff
+.TP
+.B -F, --format=\f2format-name\f1
+Report quota for specified format (ie. don't perform format autodetection).
+Possible format names are:
+.B vfsold
+(version 1 quota),
+.B vfsv0
+(version 2 quota),
+.B xfs
+(quota on XFS filesystem)
+.TP
+.B -a, --all
+Force all filesystems in
+.B /etc/fstab
+to have their quotas disabled.
+.TP
+.B -v, --verbose
+Display a message for each filesystem affected.
+.TP
+.B -u, --user
+Manipulate user quotas. This is the default.
+.TP
+.B -g, --group
+Manipulate group quotas.
+.TP
+.B -P, --project
+Manipulate project quotas.
+.TP
+.B -p, --print-state
+Instead of turning quotas off just print state of quotas (ie. whether. quota is on or off)
+.TP
+.B -x, --xfs-command 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, --xfs-command enforce
+Switch off limit enforcement for XFS filesystems (perform quota accounting
+only). This is the default action for any XFS filesystem. This option is only
+applicable to XFS, and is silently ignored for other filesystem types.
+.TP
+.B -x, --xfs-command account
+This option can be used to disable quota accounting. It is not possible to
+enable quota accounting by quota tools. Use
+.IR mount (8)
+for that. This option is only applicable to XFS filesystems, and is silently
+ignored for other filesystem types.
+.SH "NOTES ON XFS FILESYSTEMS"
+To enable quotas on an XFS filesystem, use
+.IR mount (8)
+or
+.B /etc/fstab
+quota option to enable both accounting and limit enforcement.
+.B quotaon
+utility cannot be used for this purpose.
+.PP
+Turning on quotas on an XFS root filesystem requires the quota mount
+options be passed into the kernel at boot time through the Linux
+.B rootflags
+boot option.
+.PP
+To turn off quota limit enforcement on any XFS filesystem, first make
+sure that quota accounting and enforcement are both turned on using
+.B "repquota -v"
+.IR filesystem .
+Then, use
+.B "quotaoff -v
+.I filesystem
+to disable limit enforcement.
+This may be done while the filesystem is mounted.
+.PP
+Turning on quota limit enforcement on an XFS filesystem is
+achieved using
+.B "quotaon -v"
+.IR filesystem .
+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 quota_nld (8),
+.BR repquota (8),
+.BR warnquota (8)