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.
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.
- Block limits:
- quota type (USR or GRP or FILESET)
- current usage
- soft limit
- hard limit
- 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 might show less space usage than expected.
- If you want to check the grace period that is set, specify mmrepquota -t.
- 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
- 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:
The system displays information similar to:mmlsquota
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.
- To show the quotas for user pfs001,
device gpfs2, and fileset fset4,
issue this command:
The system displays information similar to:mmlsquota -u pfs001 gpfs2:fset4
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:
The system displays information similar to:mmlsquota -d gpfs1
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:
The system displays information similar to:mmlsquota -d gpfs1:fset1
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:
The system displays information similar to:mmlsquota -j fset0 fs1 --block-size auto
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