source: gpfs_3.1_ker2.6.20/share/man/man8/mmrepquota.8 @ 126

.TH mmrepquota 03/02/06
mmrepquota Command
.SH "Name"
.PP
\fBmmrepquota\fR - Reports file system user, group, and fileset quotas.
.SH "Synopsis"
.PP
\fBmmrepquota\fR [\fB-e\fR] [\fB-g\fR]
[\fB-q\fR] [\fB-u\fR] [\fB-n\fR]
[\fB-v\fR] [\fB-j\fR] {\fIDevice\fR
[\fIDevice\fR...] | \fB-a\fR}
.SH "Description"
.PP
The \fBmmrepquota\fR command reports file system usage and quota
information for a user, group, and fileset.
.PP
If neither the \fB-g\fR, \fB-j\fR nor \fB-u\fR option is
specified, then user, group and fileset quotas are listed.
.PP
If the \fB-a\fR option is not specified, \fIDevice\fR must be the
last parameter entered.
.PP
For each file system in the cluster, the \fBmmrepquota\fR command
displays:
.RS +3
.HP 3
1. Block limits:
.RS +3
.HP 3
\(bu quota type (USR, GRP or FILESET)
.HP 3
\(bu current usage in KB
.HP 3
\(bu soft limit in KB
.HP 3
\(bu hard limit in KB
.HP 3
\(bu space in doubt
.HP 3
\(bu grace period
.RE
.HP 3
2. File limits:
.RS +3
.HP 3
\(bu current number of files
.HP 3
\(bu soft limit
.HP 3
\(bu hard limit
.HP 3
\(bu files in doubt
.HP 3
\(bu grace period
.RE
.HP 3
3. Entry Type
.sp
.RS +3
\fBdefault on
\fR
.RE
.RS +9
Default quotas are enabled for this file system
.RE
.sp
.RS +3
\fBdefault off
\fR
.RE
.RS +9
Default quotas are not enabled for this file system
.RE
.sp
.RS +3
\fBe
\fR
.RE
.RS +9
Explicit quotas - the quota limits have been explicitly set using
the
\fBmmedquota\fR command
.RE
.sp
.RS +3
\fBd
\fR
.RE
.RS +9
Default quotas - the quota limits are the default values set using
the
\fBmmdefedquota\fR command
.RE
.sp
.RS +3
\fBi
\fR
.RE
.RS +9
Initial quotas - default quotas were not enabled when this initial
entry was established. Initial quota limits have a value of zero
indicating no limit.
.RE
.RE
.PP
Because the sum of the in-doubt value and the current usage may not exceed the
hard limit, the actual block space and number of files available to the user,  
group, or fileset may be constrained by the \fIin-doubt\fR value. If the
\fIin-doubt\fR value approach a significant percentage of the quota, run
the
\fBmmcheckquota\fR command to account for the
lost space and files.
.PP
GPFS quota management takes replication into account when reporting on and
determining if quota limits have been exceeded for both block and file
usage. In a file system that has either type of replication set to a
value of two, the values reported on by both the \fBmmlsquota\fR command and the \fBmmrepquota\fR
command are double the value reported by the \fBls\fR command.
.PP
When issuing the \fBmmrepquota\fR command on a mounted file system,
negative in-doubt values may be reported if the quota server processes a
combination of up-to-date and back-level information. This is a
transient situation and may be ignored.
.PP
When a quota management enabled file system is SANergy exported, the block
usage accounting of a file accessed through SANergy include the blocks
actually used by the file and the extra blocks temporarily allocated (hyper
allocation) by SANergy. Hyper allocation is a SANergy performance
feature and can be tuned using SANergy configuration tools. For more
information, see \fITivoli SANergy: Administrator's Guide\fR at
publib.boulder.ibm.com/tividd/td/SANergy2.2.4.html.
.SH "Parameters"
.PP
.RS +3
\fB\fIDevice\fR[ \fIDevice\fR...]
\fR
.RE
.RS +9
The device name of the file system to be listed.
.PP
If more than one file system is listed, the names must be delimited by a
space. File system names need not be fully-qualified.
\fBfs0\fR is just as acceptable as \fB/dev/fs0\fR.
.RE
.SH "Options"
.PP
.RS +3
\fB-a
\fR
.RE
.RS +9
Lists quotas for all file systems in the cluster. A header line is
printed automatically with this option.
.RE
.PP
.RS +3
\fB-e
\fR
.RE
.RS +9
Specifies that the \fBmmrepquota\fR command is to collect updated quota
usage data from all nodes before displaying results. If this option is
not specified, there is the potential to display negative usage values as the
quota server may process a combination of up-to-date and back-level
information.
.RE
.PP
.RS +3
\fB-g
\fR
.RE
.RS +9
List only group quotas.
.RE
.PP
.RS +3
\fB-j
\fR
.RE
.RS +9
List only fileset quotas.
.RE
.PP
.RS +3
\fB-n
\fR
.RE
.RS +9
Displays a numerical user ID.
.RE
.PP
.RS +3
\fB-q
\fR
.RE
.RS +9
Show whether quota enforcement is active.
.RE
.PP
.RS +3
\fB-u
\fR
.RE
.RS +9
List only user quotas.
.RE
.PP
.RS +3
\fB-v
\fR
.RE
.RS +9
Print a header line.
.RE
.SH "Exit status"
.PP
.PP
.RS +3
\fB0
\fR
.RE
.RS +9
Successful completion.
.RE
.PP
.RS +3
\fBnonzero
\fR
.RE
.RS +9
A failure has occurred.
.RE
.SH "Security"
.PP
You must have root authority to run the \fBmmrepquota\fR command.
.PP
GPFS must be running on the node from which the \fBmmrepquota\fR command
is issued.
.SH "Examples"
.RS +3
.HP 3
1. To report on user quotas for file system \fBfs2\fR and display a header
line, issue this command:
.sp
.nf
mmrepquota -u -v fs2
.fi
.sp
The system displays information similar to:
.sp
.nf
*** Report for USR quotas on fs2
                Block Limits        |        File Limits
                           in                            in       entry
Name type KB quota limit doubt grace|files quota limit doubt grace Type
root  USR    8   0    0    0   none |  1     0   0   0  none default
                                                                on
user2 USR 2016 256  512    0  6days |  7    10  20   0   none d
user3 USR  104 256  512    0   none |  1    10  20   0   none d
user4 USR    0 256  512    0   none |  0    10  20   0   none d
user5 USR  368 256  512    0 23hours|  5     4  10   0 23hours d
user6 USR    0 256  512    0   none |  0    10  20   0   none d
user7 USR 1024 1024 5120 4096  none |  1     0   0  19   none e
.fi
.sp
.HP 3
2. To report on quota enforcement for \fBfs2\fR, issue this command:
.sp
.nf
mmrepquota -q fs2
.fi
.sp
 The system displays information similar to:
.sp
.nf
fs2: USR quota is on; default quota is on
fs2: GRP quota is on; default quota is on
fs2: FILESET quota is on; default quota is off\ 
.fi
.sp
.RE
.SH "See also"
.PP
mmcheckquota Command
.PP
mmdefedquota Command
.PP
mmdefquotaoff Command
.PP
mmdefquotaon Command
.PP
mmedquota Command
.PP
mmlsquota Command
.PP
mmquotaoff Command
.PP
mmquotaon Command
.SH "Location"
.PP
\fB/usr/lpp/mmfs/bin\fR
.PP