xref: /dragonfly/usr.sbin/quotaon/quotaon.8 (revision cfd1aba3)
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.\" $FreeBSD: src/usr.sbin/quotaon/quotaon.8,v 1.4.2.4 2003/03/11 22:31:31 trhodes Exp $
32.\" $DragonFly: src/usr.sbin/quotaon/quotaon.8,v 1.2 2003/06/17 04:30:02 dillon Exp $
33.\"
34.Dd December 11, 1993
35.Dt QUOTAON 8
36.Os
37.Sh NAME
38.Nm quotaon ,
39.Nm quotaoff
40.Nd turn file system quotas on and off
41.Sh SYNOPSIS
42.Nm
43.Op Fl g
44.Op Fl u
45.Op Fl v
46.Ar filesystem Ar ...
47.Nm
48.Op Fl g
49.Op Fl u
50.Op Fl v
51.Fl a
52.Nm quotaoff
53.Op Fl g
54.Op Fl u
55.Op Fl v
56.Ar filesystem Ar ...
57.Nm quotaoff
58.Op Fl g
59.Op Fl u
60.Op Fl v
61.Fl a
62.Sh DESCRIPTION
63The
64.Nm
65utility
66announces to the system that disk quotas should be enabled on one or more
67file systems.
68The
69.Nm quotaoff
70utility announces to the system that the specified
71file systems should have any disk quotas turned off.
72The file systems specified must have entries in
73.Pa /etc/fstab
74and be mounted.
75The
76.Nm
77utility expects each file system to have quota files named
78.Pa quota.user
79and
80.Pa quota.group
81which are located at the root of the associated file system.
82These defaults may be overridden in
83.Pa /etc/fstab .
84By default both user and group quotas are enabled.
85.Pp
86Available options:
87.Bl -tag -width indent
88.It Fl a
89If supplied in place of any file system names,
90.Nm Ns / Ns Nm quotaoff
91will enable/disable all the file systems indicated in
92.Pa /etc/fstab
93to be read-write with disk quotas.
94By default only the types of quotas listed in
95.Pa /etc/fstab
96are enabled.
97.It Fl g
98Only group quotas listed in
99.Pa /etc/fstab
100should be enabled/disabled.
101.It Fl u
102Only user quotas listed in
103.Pa /etc/fstab
104should be enabled/disabled.
105.It Fl v
106Cause
107.Nm
108and
109.Nm quotaoff
110to print a message for each file system where quotas are turned on or off.
111.El
112.Pp
113Specifying both
114.Fl g
115and
116.Fl u
117is equivalent to the default.
118.Sh FILES
119.Bl -tag -width quota.group -compact
120.It Pa quota.user
121at the file system root with user quotas
122.It Pa quota.group
123at the file system root with group quotas
124.It Pa /etc/fstab
125file system table
126.El
127.Sh SEE ALSO
128.Xr quota 1 ,
129.Xr quotactl 2 ,
130.Xr fstab 5 ,
131.Xr edquota 8 ,
132.Xr quotacheck 8 ,
133.Xr repquota 8
134.Sh HISTORY
135The
136.Nm
137utility appeared in
138.Bx 4.2 .
139