Annotation of src/usr.bin/quota/quota.1, Revision 1.5
1.5 ! aaron 1: .\" $OpenBSD: quota.1,v 1.4 1996/12/10 09:06:34 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
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: .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.
1.4 deraadt 93: Non-super-users can use the
1.1 deraadt 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
1.5 ! aaron 105: .Nm quota
1.1 deraadt 106: tries to report the quotas of all mounted filesystems.
1.5 ! aaron 107: If the filesystem is mounted via NFS,
1.1 deraadt 108: it will attempt to contact the
109: .Xr rpc.rquotad 8
110: daemon on the
1.5 ! aaron 111: NFS server.
! 112: For FFS
1.1 deraadt 113: filesystems, quotas must be turned on in
114: .Pa /etc/fstab .
115: If
116: .Nm quota
117: exits with a non-zero status, one or more filesystems
118: are over quota.
119: .Sh FILES
120: .Bl -tag -width quota.group -compact
121: .It Pa quota.user
122: located at the filesystem root with user quotas
123: .It Pa quota.group
124: located at the filesystem root with group quotas
125: .It Pa /etc/fstab
126: to find filesystem names and locations
127: .El
128: .Sh HISTORY
129: The
130: .Nm quota
131: command appeared in
132: .Bx 4.2 .
133: .Sh SEE ALSO
134: .Xr quotactl 2 ,
135: .Xr fstab 5 ,
136: .Xr edquota 8 ,
137: .Xr quotacheck 8 ,
138: .Xr quotaon 8 ,
139: .Xr repquota 8 ,
140: .Xr rpc.rquotad 8