| 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) |