mmrepquota command
Displays file system user, group, and fileset quotas.
Synopsis
mmrepquota [-u] [-g] [-e] [-q] [-n] [-v] [-t]
[--block-size {BlockSize | auto}] {-a | Device:Fileset ...}or
mmrepquota[-u] [-g] [-j] [-e] [-q] [-n] [-v] [-t]
[--block-size {BlockSize | auto}] {-a | Device...}Availability
Available on all IBM Spectrum Scale™ editions.
Description
The mmrepquota command reports file system usage and quota information for a user, group, or fileset.
This command cannot be run from a Windows node.
If -g, -j, or -u are not specified, then user, group, and fileset quotas are listed.
If -a is not specified, Device must be the last parameter entered.
For each file system in the cluster, the mmrepquota command
displays:
- Block limits (displayed in number of data blocks in 1KB units
or a unit defined by the --block-size parameter):
- quota type (USR, GRP or FILESET)
- current usage (the amount of disk space used by this user, group, or fileset, in 1KB units or a unit defined by the --block-size parameter)
- soft limit (the amount of disk space that this user, group, or fileset is allowed to use during normal operation, in 1KB units or a unit defined by the --block-size parameter)
- hard limit (the total amount of disk space that this user, group, or fileset is allowed to use during the grace period, in 1KB units or a unit defined by the --block-size parameter)
- space in doubt
- grace period
- File limits:
- current number of files
- soft limit
- hard limit
- files in doubt
- grace period
Note: In cases where small files do not have an additional block allocated for them, quota usage may show less space usage than expected. - Entry Type
- default on
- Default quotas are enabled for this file system.
- default off
- Default quotas are not enabled for this file system.
- e
- Explicit quota limits have been set using the mmedquota command.
- d_fsys
- The quota limits are the default file system values set using the mmdefedquota command.
- d_fset
- The quota limits are the default fileset-level values set using the mmdefedquota command.
- i
- Default quotas were not enabled when this initial entry was established. Initial quota limits have a value of zero indicating no limit.
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 in-doubt value. If the in-doubt values approach a significant percentage of the quota, run the mmcheckquota command to account for the lost space and files.
For more information, see Listing quotas.
Parameters
- Device
- The device name of the file system to be listed.
If more than one file system is listed, the names must be delimited by a space. File system names need not be fully-qualified. fs0 is just as acceptable as /dev/fs0.
- Fileset
- Specifies an optional fileset to be listed.
- -a
- Lists quotas for all file systems in the cluster. A header line is printed automatically with this option.
- -e
- Specifies that the mmrepquota 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.
- -g
- Lists only group quotas.
- -j
- Lists only fileset quotas.
- -n
- Displays a numerical user ID.
- -q
- Shows whether quota enforcement is active.
- -t
- Lists global user, group, and fileset block and inode grace times.
- -u
- Lists only user quotas.
- -v
- Prints a header line.
- --block-size {BlockSize | auto}
- Specifies the unit in which the number of blocks is displayed. The value must be of the form [n]K, [n]M, [n]G or [n]T, where n is an optional integer in the range 1 to 1023. The default is 1K. If auto is specified, the number of blocks is automatically scaled to an easy-to-read value.
Exit status
- 0
- Successful completion.
- nonzero
- A failure has occurred.
Security
You must have root authority to run the mmrepquota command.
The node on which the command is issued must be able to execute remote shell commands on any other node in the cluster without the use of a password and without producing any extraneous messages. For more information, see Requirements for administering a GPFS file system.
GPFS must be running on the node from which the mmrepquota command is issued.
Examples
- To report on user quotas for file system fs2 and
display a header line, issue this command:
The system displays information similar to:mmrepquota -u -v fs2*** 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_fsys user3 USR 104 256 512 0 none | 1 10 20 0 none d_fsys user4 USR 0 256 512 0 none | 0 10 20 0 none d_fsys user5 USR 368 256 512 0 23hours | 5 4 10 0 23hours d_fsys user6 USR 0 256 512 0 none | 0 10 20 0 none d_fsys user7 USR 1024 1024 5120 4096 none | 1 0 0 19 none e - To report on quota enforcement for fs2,
issue this command:
The system displays information similar to:mmrepquota -q fs2fs2: 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 - To report on user quotas for file system gpfs2,
issue this command:
The system displays information similar to:mmrepquota -u gpfs2Block Limits | File Limits in in Name fileset type KB quota limit doubt grace | files quota limit doubt grace root root USR 0 0 0 0 none | 1 0 0 0 none root fset3 USR 8 0 0 0 none | 1 0 0 0 none root fset4 USR 8192 0 0 0 none | 1 0 0 0 none pfs001 root USR 0 10240 0 0 none | 0 1000 5000 0 none pfs001 fset3 USR 0 10240 0 0 none | 0 1000 5000 0 none pfs001 fset4 USR 4104 10240 153600 0 none | 2 1000 5000 0 none - To report on user quotas for file system gpfs2 in
fileset fset4, issue this command:
The system displays information similar to:mmrepquota -u gpfs2:fset4Block Limits | File Limits in in Name fileset type KB quota limit doubt grace | files quota limit doubt grace root fset4 USR 8192 0 0 0 none | 1 0 0 0 none pfs001 fset4 USR 4104 10240 153600 0 none | 2 1000 5000 0 none - To list global user, group, and fileset block and inode grace
times, issue this command:
The system displays information similar to:mmrepquota -u -t gpfs_sUser: block default grace time 7days, inode default grace time 7days Group: block default grace time 7days, inode default grace time 7days Fileset: block default grace time 7days, inode default grace time 7days Block Limits | File Limits Name type KB quota limit in_doubt grace | files quota limit in_doubt grace root USR 0 0 0 0 none | 50 0 0 0 none ftp USR 0 0 0 0 none | 50 0 0 0 none - To report on fileset quotas in file system fs1, issue this command:
The system displays information similar to:mmrepquota -j fs1 --block-size autoBlock Limits | File Limits Name fileset type blocks quota limit in_doubt grace | files quota limit in_doubt grace root root FILESET 256K 0 0 0 none | 1 0 0 0 none fset0 root FILESET 89.25G 100G 200G 89.99M none | 13729 4000 5000 0 7 days fset1 root FILESET 0 100G 200G 0 none | 1 4000 5000 0 none
Note: In any mmrepquota listing, when the 'type' is
FILESET, the 'Name' column heading is meant to indicate the fileset
name (root, fset0, fset1, in this example), and the value for the
'fileset' column heading (root, in this example) can be ignored.