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