mmrepquota command

Displays file system user, group, and fileset quotas.

Synopsis

mmrepquota [-u] [-g] [-e] [-n] [-v] 
           [--block-size {BlockSize | auto} | -Y] {-a | Device:Fileset ...}

or

mmrepquota-j [-e] [-q] [-n] [-v] [-t]
           [--block-size {BlockSize | auto}] {-a | Device...}

or

mmrepquota[-q] [-t] {-a | Device...}

Availability

Available on all IBM Storage 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.

Important: Quota limits are not enforced for root users (by default). For information on managing quotas, see Managing GPFS quotas.

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:
  1. Block limits (displayed in number of data blocks in 1 KB units or a unit that is 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 1 KB 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 1 KB 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 1 KB units or a unit defined by the --block-size parameter)
    • Space in doubt
    • Grace period
  2. 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 extra block that is allocated for them, quota usage might show less space usage than expected.
  3. 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 are set by using the mmedquota command.
    d_fsys
    The quota limits are the default file system values set by using the mmdefedquota command.
    d_fset
    The quota limits are the default fileset-level values set by 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 must not exceed the hard limit, the actual block space and number of files available to the user, group, or fileset might 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 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 -e is not specified then incorrect usage values might be displayed as the quota server may process a combination of current and dated information from quota clients. The incorrect values that are displayed are temporary and are updated subsequently through quota management protocols.
Note: Avoid using this option in busy systems as this causes load on the network and might affect performance.
-g
Lists only group quotas.
-j
Lists only fileset quotas.
-n
Displays a numerical user ID.
-q
Shows whether file system quota enforcement and default quota enforcement are active.
-t
Lists global user, group, and fileset block and inode grace times.
-u
Lists only user quotas.
-v
Prints a header line for the file systems that are being queried and adds an entryType description for each quota entry. Additionally, it shows quota usage entries for users and groups that currently have no block and file usage.
--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 - 1023. The default is 1 K. 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

  1. To report on user quotas for file system fs2 and display a header line, issue this command: 
    mmrepquota -u -v fs2
    The system displays information similar to: 
    *** 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
  2. To report on quota enforcement for fs2, issue this command: 
    mmrepquota -q fs2
    The system displays information similar to: 
    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
  3. To report on user quotas for file system gpfs2, issue this command: 
    mmrepquota -u gpfs2
    The system displays information similar to: 
             Block 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
  4. To report on user quotas for file system gpfs2 in fileset fset4, issue this command:
    mmrepquota -u gpfs2:fset4
    The system displays information similar to: 
              Block 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
  5. To list global user, group, and fileset block and inode grace times, issue this command:
    mmrepquota -u -t gpfs_s
    The system displays information similar to: 
    User:    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
  6. To report on fileset quotas in file system fs1, issue this command:
    mmrepquota -j fs1 --block-size auto
    The system displays information similar to: 
                           
                                 Block 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, and fset1 in this example), and the value for the fileset column heading (root, in this example) can be ignored.

See also

Location

/usr/lpp/mmfs/bin