manual/quota/original/man8/quotaon.8

   1 .TH QUOTAON 8
   2 .UC 4
   3 .SH NAME
   4 quotaon, quotaoff \- turn filesystem quotas on and off
   5 .SH SYNOPSIS
   6 .B /usr/sbin/quotaon
   7 [
   8 .B \-vugfp
   9 ] [
  10 .B \-F
  11 .I format-name
  12 ]
  13 .IR filesystem .\|.\|.
  14 .br
  15 .B /usr/sbin/quotaon
  16 [
  17 .B \-avugfp
  18 ] [
  19 .B \-F
  20 .I format-name
  21 ]
  22 .LP
  23 .B /usr/sbin/quotaoff
  24 [
  25 .B \-vugp
  26 ]
  27 [
  28 .B \-x
  29 .I state
  30 ]
  31 .IR filesystem .\|.\|.
  32 .br
  33 .B /usr/sbin/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 \-a
  84 All automatically mounted (no
  85 .B noauto
  86 option) non-NFS filesystems in
  87 .B /etc/fstab
  88 with quotas will have their quotas turned on.
  89 This is normally used at boot time to enable quotas.
  90 .TP
  91 .B \-v
  92 Display a message for each filesystem where quotas are turned on.
  93 .TP
  94 .B \-u
  95 Manipulate user quotas. This is the default.
  96 .TP
  97 .B \-g
  98 Manipulate group quotas.
  99 .TP
 100 .B \-p
 101 Instead of turning quotas on just print state of quotas (ie. whether. quota is on or off)
 102 .TP
 103 .B \-f
 104 Make
 105 .B quotaon
 106 behave like being called as
 107 .BR quotaoff .
 108 .SS quotaoff
 109 .TP
 110 .B \-F \f2format-name\f1
 111 Report quota for specified format (ie. don't perform format autodetection).
 112 Possible format names are:
 113 .B vfsold
 114 (version 1 quota),
 115 .B vfsv0
 116 (version 2 quota),
 117 .B xfs
 118 (quota on XFS filesystem)
 119 .TP
 120 .B \-a
 121 Force all filesystems in
 122 .B /etc/fstab
 123 to have their quotas disabled.
 124 .TP
 125 .B \-v
 126 Display a message for each filesystem affected.
 127 .TP
 128 .B \-u
 129 Manipulate user quotas. This is the default.
 130 .TP
 131 .B \-g
 132 Manipulate group quotas.
 133 .TP
 134 .B \-p
 135 Instead of turning quotas off just print state of quotas (ie. whether. quota is on or off)
 136 .TP
 137 .B \-x delete
 138 Free up the space used to hold quota information (maintained
 139 internally) within XFS.
 140 This option is only applicable to XFS, and is silently
 141 ignored for other filesystem types.
 142 It can only be used on a filesystem with quota previously turned off.
 143 .TP
 144 .B \-x enforce
 145 Switch off limit enforcement for XFS filesystems (perform
 146 quota accounting only).
 147 This option is only applicable to XFS, and is silently
 148 ignored for other filesystem types.
 149 .SH "NOTES ON XFS FILESYSTEMS"
 150 To enable quotas on an XFS filesystem, use
 151 .IR mount (8)
 152 or
 153 .B /etc/fstab
 154 quota option to enable both accounting and limit enforcement.
 155 .B quotaon
 156 utility cannot be used for this purpose.
 157 .PP
 158 Turning on quotas on an XFS root filesystem requires the quota mount
 159 options be passed into the kernel at boot time through the Linux
 160 .B rootflags
 161 boot option.
 162 .PP
 163 To turn off quota limit enforcement on any XFS filesystem, first make
 164 sure that quota accounting and enforcement are both turned on using
 165 .BR "repquota -s" .
 166 Then, use
 167 .B "quotaoff -vo"
 168 to disable limit enforcement.
 169 This may be done while the filesystem is mounted.
 170 .PP
 171 Turning on quota limit enforcement on an XFS filesystem is
 172 achieved using
 173 .BR "quotaon -v" .
 174 This may be done while the filesystem is mounted.
 175 .SH FILES
 176 .PD 0
 177 .TP 20
 178 .B aquota.user or aquota.group
 179 quota file at the filesystem root (version 2 quota, non-XFS filesystems)
 180 .TP
 181 .B quota.user or quota.group
 182 quota file at the filesystem root (version 1 quota, non-XFS filesystems)
 183 .TP
 184 .B /etc/fstab
 185 default filesystems
 186 .PD
 187 .SH "SEE ALSO"
 188 .BR quotactl (2),
 189 .BR fstab (5),
 190 .BR repquota (8).