mmlsquota command

Displays quota information for a user, group, or fileset.

Synopsis

mmlsquota [-u User | -g Group] [-v | -q] [-e] [-C ClusterName]
          [-Y] [--block-size {BlockSize | auto}] [Device[:Fileset] ...]

or

mmlsquota -j Fileset [-v | -q] [-e] [-C ClusterName]
          [-Y] [--block-size {BlockSize | auto}] Device ...

or

mmlsquota -d {[-u] [-g] [-j]} [-C ClusterName]
          [-Y] [--block-size {BlockSize | auto}] [Device ...]

or

mmlsquota -d [-C ClusterName] [-Y] [--block-size {BlockSize | auto}] [Device[:Fileset] ...]

Availability

Available on all IBM Spectrum Scale editions.

Description

For the specified User, Group, or Fileset the mmlsquota command displays information about quota limits and current usage on each file system in the cluster. This information is displayed only if quota limits have been established and the user has consumed some amount of storage. If you want quota information for a User, Group, or Fileset that has no file system storage allocated at the present time, you must specify -v.
Important: Quota limits are not enforced for root users (by default). For information on managing quotas, see Managing GPFS quotas.

If neither the -g, -u, or -j option is specified, the default is to display only user quotas for the user who issues the command.

For each file system in the cluster, the mmlsquota command displays:
  1. Block limits:
    • quota type (USR or GRP or FILESET)
    • current usage
    • soft limit
    • hard limit
    • 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 additional block allocated for them, quota usage might show less space usage than expected.
    • If you want to check the grace period that is set, specify mmrepquota -t.
  3. Remarks

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 value approaches a significant percentage of the quota, run the mmcheckquota command to account for the lost space and files.

For more information, see Listing quotas.

This command cannot be run from a Windows node.

Parameters

-C ClusterName
Specifies the name of the cluster from which the quota information is obtained (from the file systems within that cluster). If -C is omitted, the local cluster is assumed. The cluster name specified by the -C flag must be part of the same multicluster group as the node issuing the mmlsquota command. A node that is part of a remote cluster can only see the file systems that it has been given authority to mount from the local cluster.
Device
Specifies the device name of the file system for which quota information is to be displayed. File system names need not be fully-qualified. fs0 is as acceptable as /dev/fs0.
Fileset
Specifies the name of a fileset located on Device for which quota information is to be displayed.
-d
Displays the default quota limits for user, group, or fileset quotas. When specified in combination with the -u, -g, or -j options, default file system quotas are displayed. When specified without any of the -u, -g, or -j options, default fileset-level quotas are displayed.
-e
Specifies that mmlsquota is to collect updated quota usage data from all nodes before displaying results. If -e 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 Group
Displays quota information for the user group or group ID specified in the Group parameter.
-j Fileset
Displays quota information for the named fileset.
-q
Prints a terse message containing information only about file systems with usage over quota.
-u User
Displays quota information for the user name or user ID specified in the User parameter.
-v
Displays quota information on file systems where the User, Group or Fileset limit has been set, but the storage has not been allocated.
--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.
-Y
Displays the command output in a parseable format with a colon (:) as a field delimiter. Each column is described by a header.
Note:
  • Fields that have a colon (:) are encoded to prevent confusion. For the set of characters that might be encoded, see the command documentation of mmclidecode. Use the mmclidecode command to decode the field.
  • -Y disregards the value of --block-size and returns the results in KB.

Exit status

0
Successful completion.
nonzero
A failure has occurred.

Security

If you are a root user:
  • You may view quota information for all users, groups, and filesets.
  • 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.

If you are a non-root user, you may view only fileset quota information, your own quota information, and quota information for any groups to which you belong.

You must be a root user to use the -d option.

GPFS must be running on the node from which the mmlsquota command is issued.

Examples

  1. The user ID paul issues this command: 
    mmlsquota
    The system displays information similar to: 
                            Block Limits            |     File Limits
Filesystem type KB  quota  limit in_doubt grace |files quota limit in_doubt grace
fsn        USR 728 100096 200192  4880     none |   35    30    50    10   6days

    This output shows the quotas for user paul in file system fsn set to a soft limit of 100096 KB, and a hard limit of 200192 KB. 728 KB is currently allocated to paul. 4880 KB is also in doubt, meaning that the quota system has not yet been updated as to whether this space has been used by the nodes, or whether it is still available. No grace period appears because paul has not exceeded his quota. If he exceeds the soft limit, the grace period is set and he has that amount of time to bring his usage below the quota values. If he fails to do so, he can not allocate any more space.

    The soft limit for files (inodes) is set at 30 and the hard limit is 50. 35 files are currently allocated to this user, and the quota system does not yet know whether the 10 in doubt have been used or are still available. A grace period of six days appears because the user has exceeded his quota. The user would have this amount of time to bring his usage below the quota values. If the user fails to do so, the user is not allocated any more space.

  2. To show the quotas for user pfs001, device gpfs2, and fileset fset4, issue this command:
    mmlsquota -u pfs001 gpfs2:fset4
    The system displays information similar to: 
                            Block Limits                  |     File Limits
                                           in                              in
Filesystem Fileset type   KB quota  limit doubt grace | files quota limit doubt grace  Remarks
gpfs2      fset4   USR  4104 10240 153600     0  none |     1  1000  5000     0  none
  3. To show user and group default quotas for all filesets in the gpfs1 file system, issue this command:
    mmlsquota -d gpfs1
    The system displays information similar to: 
             Default Block Limits(KB)                 |  Default File Limits
Filesystem Fileset    type      quota      limit  |     quota    limit  entryType
gpfs1      root       USR           0          0  |         0        0  default off
gpfs1      root       GRP           0          0  |         0        0  default off
gpfs1      fset1      USR           0          0  |         0        0  default off
gpfs1      fset1      GRP           0          0  |         0        0  default off
gpfs1      fset2      USR           0          0  |         0        0  default off
gpfs1      fset2      GRP           0          0  |         0        0  default off
  4. To show user and group default quotas for fileset fset1 in the gpfs1 file system, issue this command:
    mmlsquota -d gpfs1:fset1
    The system displays information similar to: 
             Default Block Limits(KB)       |  Default File Limits
Filesystem Fileset    type      quota      limit  |     quota    limit  entryType
gpfs1      fset1      USR           0          0  |         0        0  default off
gpfs1      fset1      GRP           0          0  |         0        0  default off
  5. To show the quotas for fileset fset0 in file system fs1, issue this command:
    mmlsquota -j fset0 fs1 --block-size auto
    The system displays information similar to:
        
                      Block Limits                              |     File Limits
Filesystem type      blocks   quota   limit   in_doubt    grace |  files   quota    limit  in_doubt   grace  Remarks
fs1        FILESET   89.25G    100G    200G     89.99M     none |  13729    4000     5000         0  7 days

See also

Location

/usr/lpp/mmfs/bin