[unix-history] / usr / src / usr.bin / quota / quota.1

.\" Copyright (c) 1983, 1990 The Regents of the University of California.
.\" All rights reserved.
.\"
.\" This code is derived from software contributed to Berkeley by
.\" Robert Elz at The University of Melbourne.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\"    notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\"    notice, this list of conditions and the following disclaimer in the
.\"    documentation and/or other materials provided with the distribution.
.\" 3. All advertising materials mentioning features or use of this software
.\"    must display the following acknowledgement:
.\"	This product includes software developed by the University of
.\"	California, Berkeley and its contributors.
.\" 4. Neither the name of the University nor the names of its contributors
.\"    may be used to endorse or promote products derived from this software
.\"    without specific prior written permission.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\"	@(#)quota.1	6.8 (Berkeley) 7/27/91
.\"
.Dd July 27, 1991
.Dt QUOTA 1
.Os BSD 4.2
.Sh NAME
.Nm quota
.Nd display disk usage and limits
.Sh SYNOPSIS
.Nm quota
.Op Fl g
.Op Fl u
.Op Fl v | Fl q
.Nm quota
.Op Fl u
.Op Fl v | Fl q
.Ar user
.Nm quota
.Op Fl g
.Op Fl v | Fl q
.Ar group
.Sh DESCRIPTION
.Nm Quota
displays users' disk usage and limits.
By default only the user quotas are printed.
.Pp
Options:
.Pp
.Bl -tag -width Ds
.It Fl g
Print group quotas for the group 
of which the user is a member.
The optional
.Fl u
flag is equivalent to the default.
.It Fl v
.Nm quota
will display quotas on filesystems
where no storage is allocated.
.It Fl q
Print a more terse message,
containing only information
on filesystems where usage is over quota.
.El
.Pp
Specifying both
.Fl g
and
.Fl u
displays both the user quotas and the group quotas (for
the user).
.Pp
Only the super-user may use the
.Fl u
flag and the optional
.Ar user
argument to view the limits of other users.
Non-super-users can use the the
.Fl g
flag and optional
.Ar group
argument to view only the limits of groups of which they are members.
.Pp
The
.Fl q
flag takes precedence over the
.Fl v
flag.
.Pp
.Nm Quota
reports the quotas of all the filesystems listed in
.Pa /etc/fstab .
If
.Nm quota
exits with a non-zero status, one or more filesystems
are over quota.
.Sh FILES
.Bl -tag -width quota.group -compact
.It Pa quota.user
located at the filesystem root with user quotas
.It Pa quota.group
located at the filesystem root with group quotas
.It Pa /etc/fstab
to find filesystem names and locations
.El
.Sh HISTORY
The
.Nm quota
command appeared in
.Bx 4.2 .
.Sh SEE ALSO
.Xr quotactl 2 ,
.Xr fstab 5 ,
.Xr edquota 8 ,
.Xr quotacheck 8 ,
.Xr quotaon 8 ,
.Xr repquota 8
Commit	Line	Data
8c20c4b3 KL	1	.\" Copyright (c) 1983, 1990 The Regents of the University of California.
	2	.\" All rights reserved.
	3	.\"
	4	.\" This code is derived from software contributed to Berkeley by
	5	.\" Robert Elz at The University of Melbourne.
	6	.\"
	7	.\" Redistribution and use in source and binary forms, with or without
	8	.\" modification, are permitted provided that the following conditions
	9	.\" are met:
	10	.\" 1. Redistributions of source code must retain the above copyright
	11	.\" notice, this list of conditions and the following disclaimer.
	12	.\" 2. Redistributions in binary form must reproduce the above copyright
	13	.\" notice, this list of conditions and the following disclaimer in the
	14	.\" documentation and/or other materials provided with the distribution.
	15	.\" 3. All advertising materials mentioning features or use of this software
	16	.\" must display the following acknowledgement:
	17	.\" This product includes software developed by the University of
	18	.\" California, Berkeley and its contributors.
	19	.\" 4. Neither the name of the University nor the names of its contributors
	20	.\" may be used to endorse or promote products derived from this software
	21	.\" without specific prior written permission.
	22	.\"
	23	.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
	24	.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
	25	.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
	26	.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
	27	.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
	28	.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
	29	.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
	30	.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
	31	.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
	32	.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
	33	.\" SUCH DAMAGE.
	34	.\"
	35	.\" @(#)quota.1 6.8 (Berkeley) 7/27/91
	36	.\"
	37	.Dd July 27, 1991
	38	.Dt QUOTA 1
	39	.Os BSD 4.2
	40	.Sh NAME
	41	.Nm quota
	42	.Nd display disk usage and limits
	43	.Sh SYNOPSIS
	44	.Nm quota
	45	.Op Fl g
	46	.Op Fl u
	47	.Op Fl v \| Fl q
	48	.Nm quota
	49	.Op Fl u
	50	.Op Fl v \| Fl q
	51	.Ar user
	52	.Nm quota
	53	.Op Fl g
	54	.Op Fl v \| Fl q
	55	.Ar group
	56	.Sh DESCRIPTION
	57	.Nm Quota
	58	displays users' disk usage and limits.
	59	By default only the user quotas are printed.
	60	.Pp
	61	Options:
	62	.Pp
	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.
92	Non-super-users can use the the
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
104	.Nm Quota
105	reports the quotas of all the filesystems listed in
106	.Pa /etc/fstab .
107	If
108	.Nm quota
109	exits with a non-zero status, one or more filesystems
110	are over quota.
111	.Sh FILES
112	.Bl -tag -width quota.group -compact
113	.It Pa quota.user
114	located at the filesystem root with user quotas
115	.It Pa quota.group
116	located at the filesystem root with group quotas
117	.It Pa /etc/fstab
118	to find filesystem names and locations
119	.El
120	.Sh HISTORY
121	The
122	.Nm quota
123	command appeared in
124	.Bx 4.2 .
125	.Sh SEE ALSO
126	.Xr quotactl 2 ,
127	.Xr fstab 5 ,
128	.Xr edquota 8 ,
129	.Xr quotacheck 8 ,
130	.Xr quotaon 8 ,
131	.Xr repquota 8