Mon Jan 20 21:35:41 2020 UTC ()
Document the actual behavior of -g; clarify the optional user/group args.


(dholland)
diff -r1.20 -r1.21 src/usr.bin/quota/quota.1
cvs diff -r1.20 -r1.21 src/usr.bin/quota/quota.1 (expand / switch to unified diff)

--- src/usr.bin/quota/quota.1 2020/01/20 21:30:41 1.20
+++ src/usr.bin/quota/quota.1 2020/01/20 21:35:41 1.21
@@ -1,14 +1,14 @@ @@ -1,14 +1,14 @@
1.\" $NetBSD: quota.1,v 1.20 2020/01/20 21:30:41 dholland Exp $ 1.\" $NetBSD: quota.1,v 1.21 2020/01/20 21:35:41 dholland Exp $
2.\" 2.\"
3.\" Copyright (c) 1983, 1990, 1993 3.\" Copyright (c) 1983, 1990, 1993
4.\" The Regents of the University of California. All rights reserved. 4.\" The Regents of the University of California. All rights reserved.
5.\" 5.\"
6.\" This code is derived from software contributed to Berkeley by 6.\" This code is derived from software contributed to Berkeley by
7.\" Robert Elz at The University of Melbourne. 7.\" Robert Elz at The University of Melbourne.
8.\" 8.\"
9.\" Redistribution and use in source and binary forms, with or without 9.\" Redistribution and use in source and binary forms, with or without
10.\" modification, are permitted provided that the following conditions 10.\" modification, are permitted provided that the following conditions
11.\" are met: 11.\" are met:
12.\" 1. Redistributions of source code must retain the above copyright 12.\" 1. Redistributions of source code must retain the above copyright
13.\" notice, this list of conditions and the following disclaimer. 13.\" notice, this list of conditions and the following disclaimer.
14.\" 2. Redistributions in binary form must reproduce the above copyright 14.\" 2. Redistributions in binary form must reproduce the above copyright
@@ -56,57 +56,58 @@ @@ -56,57 +56,58 @@
56.Op Fl v | Fl q 56.Op Fl v | Fl q
57.Sh DESCRIPTION 57.Sh DESCRIPTION
58.Nm 58.Nm
59displays users' disk usage and limits. 59displays users' disk usage and limits.
60By default only the user quotas are printed. 60By default only the user quotas are printed.
61.Pp 61.Pp
62Options: 62Options:
63.Pp 63.Pp
64.Bl -tag -width Ds 64.Bl -tag -width Ds
65.It Fl d 65.It Fl d
66Query the kernel for default user or group quota instead of a specific 66Query the kernel for default user or group quota instead of a specific
67user or group. 67user or group.
68.It Fl g 68.It Fl g
69Print group quotas for the group of which the user is a member. 69Print group quotas.
 70By default, print group quotas for all groups the user belongs to.
70.It Fl h 71.It Fl h
71Numbers are displayed in a human readable format. 72Numbers are displayed in a human readable format.
72.It Fl q 73.It Fl q
73Print a more terse message, containing only information 74Print a more terse message, containing only information
74on file systems where usage is over quota. 75on file systems where usage is over quota.
75.It Fl u 76.It Fl u
76Print user quotas. 77Print user quotas.
77This is the default. 78This is the default.
78.It Fl v 79.It Fl v
79.Nm 80.Nm
80will display quotas on file systems where no storage is allocated. 81will display quotas on file systems where no storage is allocated.
81.El 82.El
82.Pp 83.Pp
83Specifying both 84Specifying both
84.Fl g 85.Fl g
85and 86and
86.Fl u 87.Fl u
87displays both the user quotas and the group quotas (for 88displays both the user quotas and the group quotas (for
88the user). 89the user).
89.Pp 90.Pp
90Only the super-user may use the 91Only the super-user may use the optional
91.Fl u 
92flag and the optional 
93.Ar user 92.Ar user
94argument to view the limits of other users. 93argument with the
95Non-super-users can use the 94.Fl u
96.Fl g 95flag to view quotas for other users.
97flag and optional 96Non-super-users can use the optional
98.Ar group 97.Ar group
99argument to view only the limits of groups of which they are members. 98argument with the
 99.Fl g
 100flag to view only the limits of groups they belong to.
100.Pp 101.Pp
101Only the super-user may use the 102Only the super-user may use the
102.Fl d 103.Fl d
103flag. 104flag.
104.Pp 105.Pp
105The 106The
106.Fl q 107.Fl q
107flag takes precedence over the 108flag takes precedence over the
108.Fl v 109.Fl v
109flag. 110flag.
110.Pp 111.Pp
111.Nm 112.Nm
112tries to report the quotas of all mounted file systems. 113tries to report the quotas of all mounted file systems.