usr.sbin/quotaon/quotaon.8

   1 .\" Copyright (c) 1983, 1990, 1991, 1993
   2 .\"     The Regents of the University of California.  All rights reserved.
   3 .\"
   4 .\" This code is derived from software contributed to Berkeley by
   5 .\" Robert Elz at The University of Melbourne.
   6 .\" Redistribution and use in source and binary forms, with or without
   7 .\" modification, are permitted provided that the following conditions
   8 .\" are met:
   9 .\" 1. Redistributions of source code must retain the above copyright
  10 .\"    notice, this list of conditions and the following disclaimer.
  11 .\" 2. Redistributions in binary form must reproduce the above copyright
  12 .\"    notice, this list of conditions and the following disclaimer in the
  13 .\"    documentation and/or other materials provided with the distribution.
  14 .\" 3. Neither the name of the University nor the names of its contributors
  15 .\"    may be used to endorse or promote products derived from this software
  16 .\"    without specific prior written permission.
  17 .\"
  18 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  19 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  20 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  21 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  22 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  23 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  24 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  25 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  26 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  27 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  28 .\" SUCH DAMAGE.
  29 .\"
  30 .\"     @(#)quotaon.8   8.2 (Berkeley) 12/11/93
  31 .\"
  32 .Dd December 11, 1993
  33 .Dt QUOTAON 8
  34 .Os
  35 .Sh NAME
  36 .Nm quotaon ,
  37 .Nm quotaoff
  38 .Nd turn file system quotas on and off
  39 .Sh SYNOPSIS
  40 .Nm
  41 .Op Fl g
  42 .Op Fl u
  43 .Op Fl v
  44 .Ar filesystem Ar ...
  45 .Nm
  46 .Op Fl g
  47 .Op Fl u
  48 .Op Fl v
  49 .Fl a
  50 .Nm quotaoff
  51 .Op Fl g
  52 .Op Fl u
  53 .Op Fl v
  54 .Ar filesystem Ar ...
  55 .Nm quotaoff
  56 .Op Fl g
  57 .Op Fl u
  58 .Op Fl v
  59 .Fl a
  60 .Sh DESCRIPTION
  61 The
  62 .Nm
  63 utility
  64 announces to the system that disk quotas should be enabled on one or more
  65 file systems.
  66 The
  67 .Nm quotaoff
  68 utility announces to the system that the specified
  69 file systems should have any disk quotas turned off.
  70 The file systems specified must have entries in
  71 .Pa /etc/fstab
  72 and be mounted.
  73 The
  74 .Nm
  75 utility expects each file system to have quota files named
  76 .Pa quota.user
  77 and
  78 .Pa quota.group
  79 which are located at the root of the associated file system.
  80 These defaults may be overridden in
  81 .Pa /etc/fstab .
  82 By default both user and group quotas are enabled.
  83 .Pp
  84 Available options:
  85 .Bl -tag -width indent
  86 .It Fl a
  87 If supplied in place of any file system names,
  88 .Nm Ns / Ns Nm quotaoff
  89 will enable/disable all the file systems indicated in
  90 .Pa /etc/fstab
  91 to be read-write with disk quotas.
  92 By default only the types of quotas listed in
  93 .Pa /etc/fstab
  94 are enabled.
  95 .It Fl g
  96 Only group quotas listed in
  97 .Pa /etc/fstab
  98 should be enabled/disabled.
  99 .It Fl u
 100 Only user quotas listed in
 101 .Pa /etc/fstab
 102 should be enabled/disabled.
 103 .It Fl v
 104 Cause
 105 .Nm
 106 and
 107 .Nm quotaoff
 108 to print a message for each file system where quotas are turned on or off.
 109 .El
 110 .Pp
 111 Specifying both
 112 .Fl g
 113 and
 114 .Fl u
 115 is equivalent to the default.
 116 .Sh FILES
 117 .Bl -tag -width quota.group -compact
 118 .It Pa quota.user
 119 at the file system root with user quotas
 120 .It Pa quota.group
 121 at the file system root with group quotas
 122 .It Pa /etc/fstab
 123 file system table
 124 .El
 125 .Sh SEE ALSO
 126 .Xr quota 1 ,
 127 .Xr quotactl 2 ,
 128 .Xr fstab 5 ,
 129 .Xr edquota 8 ,
 130 .Xr quotacheck 8 ,
 131 .Xr repquota 8
 132 .Sh HISTORY
 133 The
 134 .Nm
 135 utility appeared in
 136 .Bx 4.2 .