Annotation of src/usr.bin/quota/quota.1, Revision 1.10
1.10 ! aaron 1: .\" $OpenBSD: quota.1,v 1.9 2000/03/06 03:17:39 aaron Exp $
! 2: .\"
1.1 deraadt 3: .\" Copyright (c) 1983, 1990, 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: .\"
9: .\" Redistribution and use in source and binary forms, with or without
10: .\" modification, are permitted provided that the following conditions
11: .\" are met:
12: .\" 1. Redistributions of source code must retain the above copyright
13: .\" notice, this list of conditions and the following disclaimer.
14: .\" 2. Redistributions in binary form must reproduce the above copyright
15: .\" notice, this list of conditions and the following disclaimer in the
16: .\" documentation and/or other materials provided with the distribution.
17: .\" 3. All advertising materials mentioning features or use of this software
18: .\" must display the following acknowledgement:
19: .\" This product includes software developed by the University of
20: .\" California, Berkeley and its contributors.
21: .\" 4. Neither the name of the University nor the names of its contributors
22: .\" may be used to endorse or promote products derived from this software
23: .\" without specific prior written permission.
24: .\"
25: .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
26: .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
27: .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
28: .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
29: .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
30: .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
31: .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
32: .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
33: .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
34: .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
35: .\" SUCH DAMAGE.
36: .\"
37: .\" from: @(#)quota.1 8.1 (Berkeley) 6/6/93
38: .\"
39: .Dd June 6, 1993
40: .Dt QUOTA 1
1.7 aaron 41: .Os
1.1 deraadt 42: .Sh NAME
43: .Nm quota
44: .Nd display disk usage and limits
45: .Sh SYNOPSIS
46: .Nm quota
47: .Op Fl g
48: .Op Fl u
49: .Op Fl v | Fl q
50: .Nm quota
51: .Op Fl u
52: .Op Fl v | Fl q
53: .Ar user
54: .Nm quota
55: .Op Fl g
56: .Op Fl v | Fl q
57: .Ar group
58: .Sh DESCRIPTION
1.5 aaron 59: .Nm quota
1.1 deraadt 60: displays users' disk usage and limits.
61: By default only the user quotas are printed.
62: .Pp
1.8 aaron 63: The options are as follows:
1.1 deraadt 64: .Bl -tag -width Ds
65: .It Fl g
1.7 aaron 66: Print group quotas for the group
1.1 deraadt 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 SEE ALSO
129: .Xr quotactl 2 ,
130: .Xr fstab 5 ,
131: .Xr edquota 8 ,
132: .Xr quotacheck 8 ,
133: .Xr quotaon 8 ,
134: .Xr repquota 8 ,
135: .Xr rpc.rquotad 8
1.9 aaron 136: .Sh HISTORY
137: The
138: .Nm quota
139: command appeared in
140: .Bx 4.2 .