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] ...]

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

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

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

Availability

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

Replication:

Replicated data is included in data block current usage. See the note under "Current usage" in the "Block limits" list later in this topic.
Data replication and metadata replication do not affect the current number of files that are reported for quotas. See the note under "Current number of files" in the "File limits" list later in this topic.

For each file system in the cluster, the mmlsquota command displays:

Block limits:
- Quota type (USR or GRP or FILESET)
- Current usage
  Note: If data replication is enabled, the data block current usage includes the replicated data. For more information, see Listing quotas.
- Soft limit
- Hard limit
- Space in doubt
- Grace period
File limits:
- Current number of files
  Note: The current number of files is not increased by data replication or metadata replication. For more information, see Listing quotas.
- 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.

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 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 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

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 are 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 in doubt, meaning that the quota system has not yet been updated to reflect whether this space has been used by the nodes, or is still available. No grace period appears because paul has not exceeded the allocated quota. If paul exceeds the soft limit, the grace period is set and the user has time equal to the grace period to bring the usage below the quota values. If paul fails to do so, additional space cannot be allocated.

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 is not yet updated with the information on the availability of the 10 in doubt. A grace period of six days appears because the user has exceeded the allocated quota. The user would have this amount of time to bring the usage below the quota values. If the user fails to do so, the user is not allocated anymore space.

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

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

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

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

Location

/usr/lpp/mmfs/bin

mmlsquota command

Synopsis

Availability

Description

Parameters

Exit status

Security

Examples

See also

Location