Initial commit to Gerrit
[profile/ivi/quota.git] / repquota.8
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 \-vspiug
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 \-avtpsiug
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 quotas created with
52 .BR edquota (8).
53 As
54 .B repquota
55 has to translate ids of all users/groups to names (unless option
56 .B -n
57 was specified) it may take a while to
58 print all the information. To make translating as fast as possible
59 .B repquota
60 tries to detect (by reading
61 .BR /etc/nsswitch.conf )
62 whether entries are stored in standard plain text file or in database and either
63 translates chunks of 1024 names or each name individually. You can override this
64 autodetection by
65 .B -c
66 or
67 .B -C
68 options.
69 .SH OPTIONS
70 .TP
71 .B -a, --all
72 Report on all filesystems indicated in
73 .B /etc/mtab
74 to be read-write with quotas.
75 .TP
76 .B -v, --verbose
77 Report all quotas, even if there is no usage. Be also more verbose about quotafile
78 information.
79 .TP
80 .B -c, --batch-translation
81 Cache entries to report and translate uids/gids to names in big chunks by scanning
82 all users (default). This is good (fast) behaviour when using /etc/passwd file.
83 .TP
84 .B -C, --no-batch-translation
85 Translate individual entries. This is faster when you have users stored in database.
86 .TP
87 .B -t, --truncate-names
88 Truncate user/group names longer than 9 characters. This results in nicer output when
89 there are such names.
90 .TP
91 .B -n, --no-names
92 Don't resolve UIDs/GIDs to names. This can speedup printing a lot.
93 .TP
94 .B -s, --human-readable
95 Try to report used space, number of used inodes and limits in more appropriate units
96 than the default ones.
97 .TP
98 .B -p, --raw-grace
99 When user is in grace period, report time in seconds since epoch when his grace
100 time runs out (or has run out). Field is '0' when no grace time is in effect.
101 This is especially useful when parsing output by a script.
102 .TP
103 .B -i, --no-autofs
104 Ignore mountpoints mounted by automounter.
105 .TP
106 .B \-F, --format=\f2format-name\f1
107 Report quota for specified format (ie. don't perform format autodetection).
108 Possible format names are:
109 .B vfsold
110 Original quota format with 16-bit UIDs / GIDs,
111 .B vfsv0
112 Quota format with 32-bit UIDs / GIDs, 64-bit space usage, 32-bit inode usage and limits,
113 .B vfsv1
114 Quota format with 64-bit quota limits and usage,
115 .B xfs
116 (quota on XFS filesystem)
117 .TP
118 .B -g, --group
119 Report quotas for groups.
120 .TP
121 .B -u, --user
122 Report quotas for users. This is the default.
123 .LP
124 Only the super-user may view quotas which are not their own.
125 .SH FILES
126 .PD 0
127 .TP 20
128 .BR aquota.user " or " aquota.group
129 quota file at the filesystem root (version 2 quota, non-XFS filesystems)
130 .TP
131 .BR quota.user " or " quota.group
132 quota file at the filesystem root (version 1 quota, non-XFS filesystems)
133 .TP
134 .B /etc/mtab
135 default filesystems
136 .TP
137 .B /etc/passwd
138 default set of users
139 .TP
140 .B /etc/group
141 default set of groups
142 .PD
143 .SH SEE ALSO
144 .BR quota (1),
145 .BR quotactl (2),
146 .BR edquota (8),
147 .BR quotacheck (8),
148 .BR quotaon (8),
149 .BR quota_nld (8),
150 .BR setquota (8),
151 .BR warnquota (8)