Annotation of src/usr.bin/quota/quota.1, Revision 1.3
1.3 ! deraadt 1: .\" $OpenBSD: quota.1,v 1.2 1995/11/25 16:46:23 deraadt Exp $
1.1 deraadt 2: .\" Copyright (c) 1983, 1990, 1993
3: .\" The Regents of the University of California. All rights reserved.
4: .\"
5: .\" This code is derived from software contributed to Berkeley by
6: .\" Robert Elz at The University of Melbourne.
7: .\"
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. All advertising materials mentioning features or use of this software
17: .\" must display the following acknowledgement:
18: .\" This product includes software developed by the University of
19: .\" California, Berkeley and its contributors.
20: .\" 4. Neither the name of the University nor the names of its contributors
21: .\" may be used to endorse or promote products derived from this software
22: .\" without specific prior written permission.
23: .\"
24: .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
25: .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
26: .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
27: .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
28: .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
29: .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
30: .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
31: .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
32: .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
33: .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
34: .\" SUCH DAMAGE.
35: .\"
36: .\" from: @(#)quota.1 8.1 (Berkeley) 6/6/93
37: .\"
38: .Dd June 6, 1993
39: .Dt QUOTA 1
40: .Os BSD 4.2
41: .Sh NAME
42: .Nm quota
43: .Nd display disk usage and limits
44: .Sh SYNOPSIS
45: .Nm quota
46: .Op Fl g
47: .Op Fl u
48: .Op Fl v | Fl q
49: .Nm quota
50: .Op Fl u
51: .Op Fl v | Fl q
52: .Ar user
53: .Nm quota
54: .Op Fl g
55: .Op Fl v | Fl q
56: .Ar group
57: .Sh DESCRIPTION
58: .Nm Quota
59: displays users' disk usage and limits.
60: By default only the user quotas are printed.
61: .Pp
62: Options:
63: .Pp
64: .Bl -tag -width Ds
65: .It Fl g
66: Print group quotas for the group
67: of which the user is a member.
68: The optional
69: .Fl u
70: flag is equivalent to the default.
71: .It Fl v
72: .Nm quota
73: will display quotas on filesystems
74: where no storage is allocated.
75: .It Fl q
76: Print a more terse message,
77: containing only information
78: on filesystems where usage is over quota.
79: .El
80: .Pp
81: Specifying both
82: .Fl g
83: and
84: .Fl u
85: displays both the user quotas and the group quotas (for
86: the user).
87: .Pp
88: Only the super-user may use the
89: .Fl u
90: flag and the optional
91: .Ar user
92: argument to view the limits of other users.
93: Non-super-users can use the the
94: .Fl g
95: flag and optional
96: .Ar group
97: argument to view only the limits of groups of which they are members.
98: .Pp
99: The
100: .Fl q
101: flag takes precedence over the
102: .Fl v
103: flag.
104: .Pp
105: .Nm Quota
106: tries to report the quotas of all mounted filesystems.
107: If the filesystem is mounted via
108: .Nm NFS ,
109: it will attempt to contact the
110: .Xr rpc.rquotad 8
111: daemon on the
112: .Nm NFS
113: server.
114: For
1.2 deraadt 115: .Nm FFS
1.1 deraadt 116: filesystems, quotas must be turned on in
117: .Pa /etc/fstab .
118: If
119: .Nm quota
120: exits with a non-zero status, one or more filesystems
121: are over quota.
122: .Sh FILES
123: .Bl -tag -width quota.group -compact
124: .It Pa quota.user
125: located at the filesystem root with user quotas
126: .It Pa quota.group
127: located at the filesystem root with group quotas
128: .It Pa /etc/fstab
129: to find filesystem names and locations
130: .El
131: .Sh HISTORY
132: The
133: .Nm quota
134: command appeared in
135: .Bx 4.2 .
136: .Sh SEE ALSO
137: .Xr quotactl 2 ,
138: .Xr fstab 5 ,
139: .Xr edquota 8 ,
140: .Xr quotacheck 8 ,
141: .Xr quotaon 8 ,
142: .Xr repquota 8 ,
143: .Xr rpc.rquotad 8