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

mmlsfs Command

Name

mmlsfs - Displays file system attributes.

Synopsis

mmlsfs Device [-a] [-A] [-B] [-C] [-d] [-f] [-F] [-i] [-I] [-m] [-M] [-n] [-Q] [-r] [-R] [-V] [-z]

Description

Use the mmlsfs command to list the attributes of a file system.

Results

If you do not specify any options, all attributes of the file system are listed. When you use options, only those attributes specified are listed, in the order issued in the command. Some parameters are preset for optimum performance and, although they display in mmlsfs output, you cannot change them.

Parameters

Device

The device name of the file system for which the attributes are listed. File system names need not be fully qualified. fs0 is as acceptable as /dev/fs0.

This must be the first parameter.

Options

-a

Estimated average file size, in bytes

-A

Automatically mount the file system when the GPFS daemon starts

-B

Size of data block, in bytes

-C

Identifier of the GPFS nodeset to which the file system belongs

-d

Names of all of the disks in the file system

-f

Minimum fragment size, in bytes

-F

Maximum number of files currently supported

-i

Inode size, in bytes

-I

Indirect block size, in bytes

-m

Default number of metadata replicas

-M

Maximum number of metadata replicas

-n

Estimated number of nodes for mounting the file system

-Q

Which quotas are currently enforced on the file system

-r

Default number of data replicas

-R

Maximum number of data replicas

-V

Current format version of the file system

-z

Whether or not DMAPI is enabled for this file system

Exit status

0

Successful completion.

1

A failure has occurred.

Security

In an SP environment:

• If you are a root user:
  • You may issue the mmlsfs command from any node running GPFS or the CWS.
  • 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.

• If you are executing the mmlsfs command from the CWS on a multi-partitioned system, the SP_NAME environment variable must be properly set. It is suggested that you use a separate window for each partition and set the environment variable accordingly. For further information, see the IBM Parallel System Support Programs for AIX: Administration Guide and search for understanding system partitioning.

In an HACMP environment:

1. If you are a root user, when using rcp and rsh for remote communication, a properly configured /.rhosts file must exist in the root user's home directory on each node in the GPFS cluster. If you have designated the use of a different remote communication program on either the mmcrcluster or the mmchcluster command, you must insure:
   1. Proper authorization is granted to all nodes in the GPFS cluster.
   2. The nodes in the GPFS cluster can communicate without the use of a password.
2. You may issue the mmlsfs command from any node in the GPFS cluster.

If you are a non-root user, you may only specify file systems that belong to the same nodeset as the node on which the mmlsfs command was issued.

Examples

If you issue the mmlsfs command with no options for the file system gpfssa:

mmlsfs gpfssa

The system displays information similar to (output appears in the order the option were specified in the command):

flag value          description
---- -------------- -----------------------------------------------------
 -f  8192           Minimum fragment size in bytes
 -i  512            Inode size in bytes
 -I  16384          Indirect block size in bytes
 -m  1              Default number of metadata replicas
 -M  1              Maximum number of metadata replicas
 -r  1              Default number of data replicas
 -R  1              Maximum number of data replicas
 -a  1048576        Estimated average file size
 -n  64             Estimated number of nodes that will mount file system
 -B  262144         Block size
 -Q  user           Quotas enforced
     user           Default quotas enabled 
 -F  1529094        Maximum number of inodes
 -V  5.01           File system version. Highest supported version: 5.01
 -z  no             Is DMAPI enabled?
 -d  gpfs0vsd;gpfs1vsd;gpfs2vsd;gpfs3vsd;gpfs4vsd;gpfs5vsd;gpfs6vsd;gpfs7vsd;gpfs8vsd;gpfs9vsd;
gpfs10vsd;gpfs11vsd;gpfs12vsd;gpfs13vsd;gpfs14vsd;gpfs15vsd;gpfs16vsd;gpfs17vsd;gpfs18vsd;gpfs19vsd;
gpfs20vsd;gpfs21vsd  Disks in file system
 -C  1              GPFS nodeset identifier
 

See also

mmcrfs Command

mmchfs Command

mmdelfs Command

IBM General Parallel File System for AIX: Data Management API Guide

Location

/usr/lpp/mmfs/bin