Debian Codegraph @

upstream/debian-unstable/man1/quota.1

raw
1 .TH QUOTA 1
2 .SH NAME
3 quota \- display disk usage and limits
4 .SH SYNOPSIS
5 .B quota
6 [
7 .B -F
8 .I format-name
9 ] [
10 .B -guqvswi
11 ] [
12 .BR -l \ |
13 [
14 .BR -QAm
15 ]]
16 .br
17 .B quota
18 [
19 .B -F
20 .I format-name
21 ] [
22 .B -qvswi
23 ] [
24 .BR -l \ |
25 [
26 .BR -QAm
27 ]]
28 .B -u
29 .IR user ...
30 .br
31 .B quota
32 [
33 .B -F
34 .I format-name
35 ] [
36 .B -qvswi
37 ] [
38 .BR -l \ |
39 [
40 .BR -QAm
41 ]]
42 .B -g
43 .IR group ...
44 .br
45 .B quota
46 [
47 .B -F
48 .I format-name
49 ] [
50 .B -qvswi
51 ] [
52 .BR -l \ |
53 [
54 .BR -QAm
55 ]]
56 .B -P
57 .IR project ...
58 .br
59 .B quota
60 [
61 .B -F
62 .I format-name
63 ] [
64 .B -qvswugQm
65 ]
66 .B -f
67 .IR filesystem ...
68 .SH DESCRIPTION
69 .B quota
70 displays users' disk usage and limits.
71 By default only the user quotas are printed. By default space usage and limits
72 are shown in kbytes (and are named blocks for historical reasons).
73 .PP
74 .B quota
75 reports the quotas of all the filesystems listed in
76 .BR /etc/mtab .
77 For filesystems that are NFS-mounted a call to the rpc.rquotad on
78 the server machine is performed to get the information.
79 .SH OPTIONS
80 .TP
81 .B -F, --format=\f2format-name\f1
82 Show quota for specified format (ie. don't perform format autodetection).
83 Possible format names are:
84 .B vfsold
85 Original quota format with 16-bit UIDs / GIDs,
86 .B vfsv0
87 Quota format with 32-bit UIDs / GIDs, 64-bit space usage, 32-bit inode usage and limits,
88 .B vfsv1
89 Quota format with 64-bit quota limits and usage,
90 .B rpc
91 (quota over NFS),
92 .B xfs
93 (quota on XFS filesystem)
94 .TP
95 .B -g, --group
96 Print group quotas for the group
97 of which the user is a member.
98 The optional
99 .B group
100 argument(s) restricts the display to the specified group(s).
101 .TP
102 .B -u, --user
103 flag is equivalent to the default.
104 .TP
105 .B -P, --project
106 Print project quotas for the specified project.
107 .TP
108 .B -v, --verbose
109 will display quotas on filesystems
110 where no storage is allocated.
111 .TP
112 .B -s, --human-readable[=\f2units\f1]
113 option will make
114 .BR quota (1)
115 try to choose units for showing limits, used space and used inodes. Units can
116 be also specified explicitely by an optional argument in format [
117 .BR kgt
118 ],[
119 .BR kgt
120 ] where the first character specifies space units and the second character
121 specifies inode units.
122 .TP
123 .B --always-resolve
124 Always try to translate user / group name to uid / gid even if the name
125 is composed of digits only.
126 .TP
127 .B -p, --raw-grace
128 When user is in grace period, report time in seconds since epoch when his grace
129 time runs out (or has run out). Field is '0' when no grace time is in effect.
130 This is especially useful when parsing output by a script.
131 .TP
132 .B -i, --no-autofs
133 ignore mountpoints mounted by automounter
134 .TP
135 .B -l, --local-only
136 report quotas only on local filesystems (ie. ignore NFS mounted filesystems).
137 .TP
138 .B -A, --all-nfs
139 report quotas for all NFS filesystems even if they report to be on the same
140 device.
141 .TP
142 .B -f, --filesystem-list
143 report quotas only for filesystems specified on command line.
144 .TP
145 .B --filesystem=\f2path\f1
146 report quotas only for filesystem
147 .BR path .
148 This option can be specified multiple types and quota will be reported for each
149 specified filesystem. Unlike command line option
150 .B -f
151 remaining command like arguments are still treated as user / group / project names
152 to report.
153 .TP
154 .B -m, --no-mixed-pathnames
155 Currently, pathnames of NFSv4 mountpoints are sent without leading slash in the path.
156 .BR rpc.rquotad
157 uses this to recognize NFSv4 mounts and properly prepend pseudoroot of NFS filesystem
158 to the path. If you specify this option,
159 .BR quota
160 will always send paths with a leading slash. This can be useful for legacy reasons but
161 be aware that quota over RPC will stop working if you are using new
162 .BR rpc.rquotad .
163 .TP
164 .B -q, --quiet
165 Print a more terse message,
166 containing only information
167 on filesystems where usage is over quota.
168 .TP
169 .B -Q, --quiet-refuse
170 Do not print error message if connection to
171 .BR rpc.rquotad
172 is refused (usually this happens when
173 .BR rpc.rquotad
174 is not running on the server).
175 .TP
176 .B -w, --no-wrap
177 Do not wrap the line if the device name is too long. This can be useful when parsing
178 the output of
179 .BR quota (1)
180 by a script.
181 .TP
182 .B --show-mntpoint
183 Show also mount point as a filesystem identification.
184 .TP
185 .B --hide-device
186 Do not show device name in a filesystem identification.
187 .LP
188 Specifying both
189 .B \-g
190 and
191 .B \-u
192 displays both the user quotas and the group quotas (for
193 the user).
194 .LP
195 Only the super-user may use the
196 .B \-u
197 flag and the optional
198 .B user
199 argument to view the limits of other users. Also viewing of project quota
200 usage and limits is limited to super-user only.
201 Non-super-users can use the
202 .B \-g
203 flag and optional
204 .B group
205 argument to view only the limits of groups of which they are members.
206 .LP
207 The
208 .B \-q
209 flag takes precedence over the
210 .B \-v
211 flag.
212 .SH DIAGNOSTICS
213 If
214 .B quota
215 exits with a non-zero status, one or more filesystems
216 are over quota.
217 .SH FILES
218 .PD 0
219 .TP 20
220 .B aquota.user " or " aquota.group
221 quota file at the filesystem root (version 2 quota, non-XFS filesystems)
222 .TP 20
223 .B quota.user " or " quota.group
224 quota file at the filesystem root (version 1 quota, non-XFS filesystems)
225 .TP
226 .B /etc/mtab
227 default filesystems
228 .PD
229 .SH SEE ALSO
230 .BR quotactl (2),
231 .BR fstab (5),
232 .BR edquota (8),
233 .BR quotacheck (8),
234 .BR quotaon (8),
235 .BR quota_nld (8),
236 .BR repquota (8),
237 .BR warnquota (8),
238 .BR setquota (8)