Annotation of src/usr.bin/quota/quota.1, Revision 1.6
1.6 ! aaron 1: .\" $OpenBSD: quota.1,v 1.5 1998/09/27 16:57:50 aaron 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
1.5 aaron 58: .Nm quota
1.1 deraadt 59: displays users' disk usage and limits.
60: By default only the user quotas are printed.
61: .Pp
62: Options:
63: .Bl -tag -width Ds
64: .It Fl g
65: Print group quotas for the group
66: of which the user is a member.
67: The optional
68: .Fl u
69: flag is equivalent to the default.
70: .It Fl v
71: .Nm quota
72: will display quotas on filesystems
73: where no storage is allocated.
74: .It Fl q
75: Print a more terse message,
76: containing only information
77: on filesystems where usage is over quota.
78: .El
79: .Pp
80: Specifying both
81: .Fl g
82: and
83: .Fl u
84: displays both the user quotas and the group quotas (for
85: the user).
86: .Pp
87: Only the super-user may use the
88: .Fl u
89: flag and the optional
90: .Ar user
91: argument to view the limits of other users.
1.4 deraadt 92: Non-super-users can use the
1.1 deraadt 93: .Fl g
94: flag and optional
95: .Ar group
96: argument to view only the limits of groups of which they are members.
97: .Pp
98: The
99: .Fl q
100: flag takes precedence over the
101: .Fl v
102: flag.
103: .Pp
1.5 aaron 104: .Nm quota
1.1 deraadt 105: tries to report the quotas of all mounted filesystems.
1.5 aaron 106: If the filesystem is mounted via NFS,
1.1 deraadt 107: it will attempt to contact the
108: .Xr rpc.rquotad 8
109: daemon on the
1.5 aaron 110: NFS server.
111: For FFS
1.1 deraadt 112: filesystems, quotas must be turned on in
113: .Pa /etc/fstab .
114: If
115: .Nm quota
116: exits with a non-zero status, one or more filesystems
117: are over quota.
118: .Sh FILES
119: .Bl -tag -width quota.group -compact
120: .It Pa quota.user
121: located at the filesystem root with user quotas
122: .It Pa quota.group
123: located at the filesystem root with group quotas
124: .It Pa /etc/fstab
125: to find filesystem names and locations
126: .El
127: .Sh HISTORY
128: The
129: .Nm quota
130: command appeared in
131: .Bx 4.2 .
132: .Sh SEE ALSO
133: .Xr quotactl 2 ,
134: .Xr fstab 5 ,
135: .Xr edquota 8 ,
136: .Xr quotacheck 8 ,
137: .Xr quotaon 8 ,
138: .Xr repquota 8 ,
139: .Xr rpc.rquotad 8