1 | .\" $Id: quota.1,v 1.12 1999-03-29 19:14:19 danw Exp $ |
---|
2 | .\" |
---|
3 | .\" Copyright 1997 by the Massachusetts Institute of Technology. |
---|
4 | .\" |
---|
5 | .\" Permission to use, copy, modify, and distribute this |
---|
6 | .\" software and its documentation for any purpose and without |
---|
7 | .\" fee is hereby granted, provided that the above copyright |
---|
8 | .\" notice appear in all copies and that both that copyright |
---|
9 | .\" notice and this permission notice appear in supporting |
---|
10 | .\" documentation, and that the name of M.I.T. not be used in |
---|
11 | .\" advertising or publicity pertaining to distribution of the |
---|
12 | .\" software without specific, written prior permission. |
---|
13 | .\" M.I.T. makes no representations about the suitability of |
---|
14 | .\" this software for any purpose. It is provided "as is" |
---|
15 | .\" without express or implied warranty. |
---|
16 | .\" |
---|
17 | .TH QUOTA 1 |
---|
18 | .SH NAME |
---|
19 | quota \- display disk usage and limits |
---|
20 | .SH SYNOPSIS |
---|
21 | .TP 8 |
---|
22 | quota [\-v] [\-a | \-f filesystem [\-f filesystem ...]] [\-u] [user] |
---|
23 | .SH DESCRIPTION |
---|
24 | .I Quota |
---|
25 | displays a user's disk usage and limits on local and NFS mounted file |
---|
26 | systems, as well as AFS lockers that have been attached. If a user is |
---|
27 | specified (by name or by id), \fIquota\fP will return information on |
---|
28 | disk usage and limits for that user. Normal users can only check their |
---|
29 | own quotas. The super-user may check any quota on local filesystems. |
---|
30 | .PP |
---|
31 | \fIQuota\fP, without the \fB\-a\fP or \fB\-f\fP options, only |
---|
32 | processes local and NFS filesystems on which the user has an assigned |
---|
33 | quota, and those AFS filesystems that the user has attached and to |
---|
34 | which the user has write access at the filesystem's top-level |
---|
35 | directory. Without any options, \fIquota\fP displays warnings about |
---|
36 | those filesystems where usage is over quota. With AFS filesystems, |
---|
37 | warnings are displayed when 90% of the volume's quota has been |
---|
38 | reached. |
---|
39 | .SH OPTIONS |
---|
40 | .IP \fB\-a\fP |
---|
41 | This option specifies that all attached filesystems should be processed, |
---|
42 | regardless of who attached them and the user's ability to write to the |
---|
43 | filesystem. Warnings or status messages that may result from the use of |
---|
44 | this option do not necessarily indicate that the user may be able to |
---|
45 | alter the usage or otherwise affect the situation. Quota information is |
---|
46 | a representation of a user's limits should he have write access; it does |
---|
47 | not indicate that such write access exists. |
---|
48 | .IP \fB\-v\fP |
---|
49 | This option will display usages and limits for the user on all |
---|
50 | processed file systems where quotas exist. On NFS or local file |
---|
51 | systems, everyone has a "soft" limit for disk space usage (given in |
---|
52 | the first |
---|
53 | .B quota |
---|
54 | column) and a |
---|
55 | "hard" limit (given in the first |
---|
56 | .B limit |
---|
57 | column). The amount of space |
---|
58 | currently in use is shown in the |
---|
59 | .B usage |
---|
60 | column. These values |
---|
61 | are measured in kilobytes. |
---|
62 | .IP |
---|
63 | When the "soft" limit is exceeded, the |
---|
64 | .B limit |
---|
65 | column will be marked with \fB<<\fP. If the higher "hard" limit is |
---|
66 | reached, you will no longer be able to write anything into the |
---|
67 | directory. |
---|
68 | .IP |
---|
69 | In addition, there is a quota and limit on the number of inodes (files and |
---|
70 | directories) that may exist. Each file or directory counts as a single inode |
---|
71 | (the sum total of which is listed in the |
---|
72 | .B files |
---|
73 | column). The soft and hard |
---|
74 | limits for inodes are similar to those for disk space usage, except that when |
---|
75 | the "hard" limit is reached, you will not be able to create new subdirectories |
---|
76 | or files within that filesystem. |
---|
77 | .IP |
---|
78 | If no quotas for the user (or groups that the user is a member of) exist |
---|
79 | on any mounted file systems, nothing will be displayed. |
---|
80 | .IP |
---|
81 | In an AFS locker, there is no quota on the number of files you can |
---|
82 | create as long as your disk usage remains under quota. |
---|
83 | .PP |
---|
84 | .IP \fB\-f\fP filesystem |
---|
85 | With this option, quota information will be returned on any specified |
---|
86 | filesystems. The filesystem must be specified as the mount-point or as |
---|
87 | the Hesiod name by which it was attached. A single filesystem name |
---|
88 | must be present with each \fB\-f\fP option. For example, a typical |
---|
89 | command to check one's home directory quota would be: |
---|
90 | .PP |
---|
91 | .RS 16 |
---|
92 | quota -v -f $USER |
---|
93 | .RE |
---|
94 | .IP |
---|
95 | Up to 16 `\fB\-f\fP filesystem' pairs may be specified. If the given |
---|
96 | filesystem name doesn't match any mounted filesystems, a suitable |
---|
97 | error message to that effect is printed. |
---|
98 | .IP |
---|
99 | Note that the user will always be warned about quota problems on lockers |
---|
100 | that are explicitly specified with -f, whether or not they have write |
---|
101 | access to the filesystem. Quota is a representation of limits that the |
---|
102 | user would have should he have write access; it does not indicate if |
---|
103 | such write access exists. |
---|
104 | .PP |
---|
105 | .IP \fB\-u\fP |
---|
106 | This option indicates that user quotas, and not group quotas, are to |
---|
107 | be reported verbosely. Group quotas are no longer supported, so this |
---|
108 | option is now equivalent to the \fB\-v\fP option. |
---|
109 | .SH FILES |
---|
110 | /var/athena/attachtab/ |
---|
111 | .SH "SEE ALSO" |
---|
112 | quotactl(2), quotaon(1m), edquota(1m), rquotad(1m) |
---|