Debian Codegraph @

upstream/debian-unstable/man8/repquota.8

raw
1 .TH REPQUOTA 8
2 .UC 4
3 .SH NAME
4 repquota \- summarize quotas for a filesystem
5 .SH SYNOPSIS
6 .B /usr/sbin/repquota
7 [
8 .B \-vspiugP
9 ] [
10 .B \-c
11 |
12 .B \-C
13 ] [
14 .B \-t
15 |
16 .B \-n
17 ] [
18 .B \-F
19 .I format-name
20 ]
21 .IR filesystem .\|.\|.
22 .LP
23 .B /usr/sbin/repquota
24 [
25 .B \-avtpsiugP
26 ] [
27 .B \-c
28 |
29 .B \-C
30 ] [
31 .B \-t
32 |
33 .B \-n
34 ] [
35 .B \-F
36 .I format-name
37 ]
38 .SH DESCRIPTION
39 .IX "repquota command" "" "\fLrepquota\fP \(em summarize quotas"
40 .IX "user quotas" "repquota command" "" "\fLrepquota\fP \(em summarize quotas"
41 .IX "disk quotas" "repquota command" "" "\fLrepquota\fP \(em summarize quotas"
42 .IX "quotas" "repquota command" "" "\fLrepquota\fP \(em summarize quotas"
43 .IX "filesystem" "repquota command" "" "\fLrepquota\fP \(em summarize quotas"
44 .IX "summarize filesystem quotas repquota" "" "summarize filesystem quotas \(em \fLrepquota\fP"
45 .IX "report filesystem quotas repquota" "" "report filesystem quotas \(em \fLrepquota\fP"
46 .IX display "filesystem quotas \(em \fLrepquota\fP"
47 .LP
48 .B repquota
49 prints a summary of the disc usage and quotas for the specified file
50 systems. For each user the current number of files and amount of space
51 (in kilobytes) is printed, along with any quota limits set with
52 .BR edquota (8)
53 or
54 .BR setquota (8).
55 In the second column repquota prints two characters marking which limits are
56 exceeded. If user is over his space softlimit or reaches his space hardlimit in
57 case softlimit is unset, the first character is '+'. Otherwise the character
58 printed is '-'. The second character denotes the state of inode usage
59 analogously.
60
61 .B repquota
62 has to translate ids of all users/groups/projects to names (unless option
63 .B -n
64 was specified) so it may take a while to
65 print all the information. To make translating as fast as possible
66 .B repquota
67 tries to detect (by reading
68 .BR /etc/nsswitch.conf )
69 whether entries are stored in standard plain text file or in a database and either
70 translates chunks of 1024 names or each name individually. You can override this
71 autodetection by
72 .B -c
73 or
74 .B -C
75 options.
76 .SH OPTIONS
77 .TP
78 .B -a, --all
79 Report on all filesystems indicated in
80 .B /etc/mtab
81 to be read-write with quotas.
82 .TP
83 .B -v, --verbose
84 Report all quotas, even if there is no usage. Be also more verbose about quotafile
85 information.
86 .TP
87 .B -c, --cache
88 Cache entries to report and translate uids/gids to names in big chunks by scanning
89 all users (default). This is good (fast) behaviour when using /etc/passwd file.
90 .TP
91 .B -C, --no-cache
92 Translate individual entries. This is faster when you have users stored in database.
93 .TP
94 .B -t, --truncate-names
95 Truncate user/group names longer than 9 characters. This results in nicer output when
96 there are such names.
97 .TP
98 .B -n, --no-names
99 Don't resolve UIDs/GIDs to names. This can speedup printing a lot.
100 .TP
101 .B -s, --human-readable[=\f2units\f1]
102 Try to report used space, number of used inodes and limits in more appropriate
103 units than the default ones. Units can be also specified explicitely by an
104 optional argument in format [
105 .BR kgt
106 ],[
107 .BR kgt
108 ] where the first character specifies space units and the second character
109 specifies inode units.
110 .TP
111 .B -p, --raw-grace
112 When user is in grace period, report time in seconds since epoch when his grace
113 time runs out (or has run out). Field is '0' when no grace time is in effect.
114 This is especially useful when parsing output by a script.
115 .TP
116 .B -i, --no-autofs
117 Ignore mountpoints mounted by automounter.
118 .TP
119 .B \-F, --format=\f2format-name\f1
120 Report quota for specified format (ie. don't perform format autodetection).
121 Possible format names are:
122 .B vfsold
123 Original quota format with 16-bit UIDs / GIDs,
124 .B vfsv0
125 Quota format with 32-bit UIDs / GIDs, 64-bit space usage, 32-bit inode usage and limits,
126 .B vfsv1
127 Quota format with 64-bit quota limits and usage,
128 .B xfs
129 (quota on XFS filesystem)
130 .TP
131 .B -g, --group
132 Report quotas for groups.
133 .TP
134 .B -P, --project
135 Report quotas for projects.
136 .TP
137 .B -u, --user
138 Report quotas for users. This is the default.
139 .TP
140 .B -O, --output=\f2format-name\f1
141 Output quota report in the specified format.
142 Possible format names are:
143 .B default
144 The default format, optimized for console viewing
145 .B csv
146 Comma-separated values, a text file with the columns delimited by commas
147 .B xml
148 Output is XML encoded, useful for processing with XSLT
149 .LP
150 Only the super-user may view quotas which are not their own.
151 .SH FILES
152 .PD 0
153 .TP 20
154 .BR aquota.user " or " aquota.group
155 quota file at the filesystem root (version 2 quota, non-XFS filesystems)
156 .TP
157 .BR quota.user " or " quota.group
158 quota file at the filesystem root (version 1 quota, non-XFS filesystems)
159 .TP
160 .B /etc/mtab
161 default filesystems
162 .TP
163 .B /etc/passwd
164 default set of users
165 .TP
166 .B /etc/group
167 default set of groups
168 .PD
169 .SH SEE ALSO
170 .BR quota (1),
171 .BR quotactl (2),
172 .BR edquota (8),
173 .BR quotacheck (8),
174 .BR quotaon (8),
175 .BR quota_nld (8),
176 .BR setquota (8),
177 .BR warnquota (8)