source: gpfs_3.1_ker2.6.20/share/man/man8/mmedquota.8 @ 123

.TH mmedquota 03/02/06
mmedquota Command
.SH "Name"
.PP
\fBmmedquota\fR - Sets quota limits.
.SH "Synopsis"
.PP
\fBmmedquota\fR {\fB-u\fR [\fB-p\fR
\fIProtoUser\fR] \fIUser\fR...| \fB-g\fR
[\fB-p\fR \fIProtoGroup\fR]
\fIGroup\fR... | \fB-j\fR [\fB-p\fR
\fIProtoFileset\fR ] \fIFileset\fR... |
\fB-d\fR {\fB-u\fR \fIUser\fR...| \fB-g\fR
\fIGroup\fR... | \fB-j\fR \fIFileset\fR...} |
\fB-t\fR {\fB-u\fR | \fB-g\fR | \fB-j\fR}}
.SH "Description"
.PP
The \fBmmedquota\fR command serves two purposes:
.RS +3
.HP 3
1. Sets or changes quota limits or grace periods for users, groups, and filesets  in the
cluster from which the command is issued.
.HP 3
2. Reestablishes user, group, or fileset default quotas for all file systems with
default quotas enabled in the cluster.
.RE
.PP
The \fBmmedquota\fR command displays the current values for these
limits, if any, and prompts you to enter new values using your default
editor:
.RS +3
.HP 3
\(bu Current block usage (display only)
.HP 3
\(bu Current inode usage (display only)
.HP 3
\(bu Inode soft limit
.HP 3
\(bu Inode hard limit
.HP 3
\(bu Block soft limit
.sp
Displayed in \fBKB\fR, but may be specified using \fBg\fR,
\fBG\fR, \fBk\fR, \fBK\fR, \fBm\fR, or \fBM\fR. If no
suffix is provided, the number is assumed to be in \fBbytes\fR.
.HP 3
\(bu Block hard limit 
.sp
Displayed in \fBKB\fR, but may be specified using \fBg\fR,
\fBG\fR, \fBk\fR, \fBK\fR, \fBm\fR, or \fBM\fR. If no
suffix is provided, the number is assumed to be in \fBbytes\fR.
.RE
.RS +3
\fBNote:\fR
.RE
.RS +9
A block or inode limit of 0 indicates no limit.
.RE
.PP
The \fBmmedquota\fR command waits for the edit window to be closed
before checking and applying new values. If an incorrect entry is made,
you must reissue the command and enter the correct values.
.PP
You can also use the \fBmmedquota\fR command to change the file
system-specific grace periods for block and file usage if the default of one
week is unsatisfactory. The grace period is the time during which users
can exceed the soft limit. If the user, group, or fileset does not show reduced usage
below the soft limit before the grace period expires, the soft limit becomes
the new hard limit.
.PP
When setting quota limits for a file system, replication within the file
system should be considered. 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 by both
the
\fBmmlsquota\fR command and the \fBmmrepquota\fR command are double the value reported
by the \fBls\fR command.
.PP
The EDITOR environment variable must contain a complete path name, for
example:
.sp
.nf
export EDITOR=/bin/vi
.fi
.sp
.SH "Parameters"
.PP
.RS +3
\fB\fIUser\fR
\fR
.RE
.RS +9
Name or user ID of target user for quota editing.
.RE
.PP
.RS +3
\fB\fIGroup\fR
\fR
.RE
.RS +9
Name or group ID of target group for quota editing.
.RE
.SH "Options"
.PP
.RS +3
\fB-d
\fR
.RE
.RS +9
Reestablish default quota limits for a specific user, group, or
fileset that has had an explicit quota limit set by a previous invocation of
the \fBmmedquota\fR command.
.RE
.PP
.RS +3
\fB-g
\fR
.RE
.RS +9
Sets quota limits or grace times for groups.
.RE
.PP
.RS +3
\fB-j
\fR
.RE
.RS +9
Sets quota limits or grace times for filesets.
.RE
.PP
.RS +3
\fB-p
\fR
.RE
.RS +9
Applies already-established limits to a particular user, group or
fileset. 
.PP
When invoked with the \fB-u\fR option, \fIProtoUser\fR limits are
automatically applied to the specified \fIUser\fR or space-delimited list
of users.
.PP
When invoked with the \fB-g\fR option, \fIProtoGroup\fR limits are
automatically applied to the specified \fIGroup\fR or space-delimited list
of groups.
.PP
When invoked with the \fB-j\fR option, \fIProtoFileset\fR limits are
automatically applied to the specified fileset or space-delimited list of
fileset names.
.PP
You can specify any user as a \fIProtoUser\fR for another \fIUser\fR,
or any group as a \fIProtoGroup\fR for another \fIGroup\fR, or any
fileset as a \fIProtoFileset\fR for another \fIFileset\fR.
.RE
.PP
.RS +3
\fB-t
\fR
.RE
.RS +9
Sets grace period during which quotas can exceed the soft limit before it
is imposed as a hard limit. The default grace period is one
week.
.PP
This flag is followed by one of the following flags: \fB-u\fR,
\fB-g\fR or \fB-j\fR, to specify whether the changes apply to users,
groups, or filesets respectively.
.RE
.PP
.RS +3
\fB-u 
\fR
.RE
.RS +9
Sets quota limits or grace times for users.
.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 \fBmmedquota\fR command.
.PP
GPFS must be running on the node from which the \fBmmedquota\fR command
is issued.
.SH "Examples"
.RS +3
.HP 3
1. To set user quotas for userid \fBpaul\fR, issue this command:
.sp
.nf
mmedquota -u paul
.fi
.sp
The system displays information in your default editor similar to:
.sp
.nf
*** Edit quota limits for USR paul:
NOTE: block limits will be rounded up to the next multiple of
the block size.  block units may be: K, M, or G
gpfs0: blocks in use: 864K, limits (soft = 2500K , hard = 10M)
inodes in use: 9, limits (soft = 100, hard = 1000)
.fi
.sp
.HP 3
2. To reset default group quota values for the group
blueteam, issue this command:
.sp
.nf
mmedquota -d -g blueteam
.fi
.sp
To verify the change, issue this command:
.sp
.nf
mmrepquota -q fs1
.fi
.sp
The system displays information similar to:
.sp
.nf
fs1: USR quota is on; default quota is on
fs1: GRP quota is on; default quota is on
fs1: FILESET quota is on; default quota is off
.fi
.sp
.HP 3
3. To change the grace periods for all users, issue this command:
.sp
.nf
mmedquota -t -u
.fi
.sp
The system displays information in your default editor similar to:
.sp
.nf
*** Edit grace times:
Time units may be : days, hours, minutes, or seconds
Grace period before enforcing soft limits for USRs:
gpfs0: block grace period: 7 days, file grace period: 7 days
.fi
.sp
.RE
.SH "See also"
.PP
mmcheckquota Command
.PP
mmdefedquota Command
.PP
mmdefquotaoff Command
.PP
mmdefquotaon Command
.PP
mmlsquota Command
.PP
mmquotaon Command
.PP
mmquotaoff Command
.PP
mmrepquota Command
.SH "Location"
.PP
\fB/usr/lpp/mmfs/bin\fR
.PP