IBM General Parallel File System for AIX: Administration and Programming Reference

mmrepquota Command

Name

mmrepquota - Reports file system user and group quotas.

Synopsis

mmrepquota [-e] [-g] [-q] [-u] [-n] [-v] {Device[ Device ... ] | -a}

Description

The mmrepquota command lists (reports on) users and groups in a file system.

If neither the -g nor the -u option is specified, then both user and group quotas are listed.

If the -a option is not specified, Device must be the last parameter entered.

For each file system in the nodeset when using the -v option, the mmrepquota command displays:

• Block limits:
  • quota type (USR or GROUP)
  • current usage in KB
  • soft limit in KB
  • hard limit in KB
  • space in-doubt
  • grace period
• File limits:
  • current number of files
  • soft limit
  • hard limit
  • files in-doubt
  • grace period
• 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 quotas - the quota limits have been explicitly set via the mmedquota command

  d

  default quotas - the quota limits are the default values set via the mmdefedquota command

  i

  initial quotas - default quotas were not enabled when this initial entry was established. Initial quota limits have a value of zero indicating no limit.

As 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 or the group may be constrained by the in-doubt value. Should the in-doubt value approach a significant percentage of the quota, run the mmcheckquota command to account for the lost space and files.

GPFS quota management takes replication into account when reporting on and determining if quota limits have been exceeded for both block and file usage. In a file system that has either type of replication set to a value of two, the values reported on by both the mmlsquota command and the mmrepquota command and the values used to determine if quota limits have been exceeded will be double the value reported by the ls command.

Parameters

Device[ Device ... ]

The device name of the file system to be listed.

If more than one file system is listed, the names should be delimited by a space. File system names need not be fully qualified. fs0 is just as acceptable as /dev/fs0.

Options

-a

Lists quotas for all file systems in the nodeset from which the command is issued. A header line is printed automatically with this option.

-e

Specifies that mmrepquota 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

List only group quotas.

-n

Displays a numerical user ID.

-q

Show whether quota enforcement is active.

-u

List only user quotas.

-v

Print a header line.

Exit status

0

Successful completion.

1

A failure has occurred.

Security

You must have root authority to run the mmrepquota command.

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

In an SP environment, verify the authentication method set for SP security services:

1. If your authentication method is set to compatibility, Kerberos authentication is required. Issue the k4init command.
2. If your authentication method is set to DCE, dce_login authentication is required.
3. If your authentication method is set to NONE/std, there must be an entry in the /etc/sysctl.mmcmd.acl file on every node in the nodeset for the root user at every other node in the nodeset.

For further information, see the latest IBM Parallel System Support Programs for AIX: Administration Guide, IBM Parallel System Support Programs for AIX: Command and Technical Reference, and RS/6000: Planning Volume 2, Control Workstation and Software Environment manuals at www.rs6000.ibm.com/resource/aix_resource/sp_books/pssp. Search for information on sysctl.

Examples

1. To report on user quotas for file system fs0 and display a header line, enter:

   mmrepquota -u -v fs0
   

   The system displays information similar to:

   *** Report for USR quotas on fs2
                       Block Limits                               |                     File Limits
   Name       type     KB     quota     limit   in_doubt    grace |  files   quota   limit in_doubt    grace entryType
   root       USR       8         0         0          0     none |      1       0       0        0     none default on
   user231    USR    2016       256       512          0    6days |      7      10      20        0     none d         
   user232    USR     104       256       512          0     none |      1      10      20        0     none           
   user233    USR       0       256       512          0     none |      0      10      20        0     none d         
   user234    USR     368       256       512          0  23hours |      5       4      10        0  23hours           
   user235    USR       0       256       512          0     none |      0      10      20        0     none d         
   user236    USR    1024    102400    512000       4096     none |      1       0       0       19     none 
   

2. To report on quota enforcement for fs2, enter:

   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 off  
   

See also

mmcheckquota Command

mmdefedquota Command

mmdefquotaoff Command

mmdefquotaon Command

mmedquota Command

mmlsquota Command

mmquotaoff Command

mmquotaon Command

Location

/usr/lpp/mmfs/bin