mmlsfs command

Displays file system attributes.

Synopsis

mmlsfs {Device | all | all_local | all_remote} [-A] [-B] [-d] [-D]
       [-E] [-f] [-i] [-I] [-j] [-k] [-K] [-L] [-m] [-M] [-n] [-o]
       [-P] [-Q] [-r] [-R] [-S] [-t] [-T] [-V] [-z]
       [--create-time] [--encryption] [--fastea] [--filesetdf]
       [--inode-limit] [--is4KAligned] [--log-replicas] [--mount-priority]
       [--perfileset-quota] [--rapid-repair] [--write-cache-threshold]

Availability

Available on all IBM Spectrum Scale™ editions.

Description

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

Depending on your configuration, additional information that is set by GPFS™ may be displayed to assist in problem determination when contacting the IBM® Support Center.

Results

If you do not specify any options, all attributes of the file system are displayed. When you specify 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 the mmlsfs command output, you cannot change them.

Parameters

The following parameter must be the first parameter:

Device | all | all_local | all_remote

Device: Indicates the device name of the file system for which information is displayed. File system names do not need to be fully qualified. fs0 is as acceptable as /dev/fs0.
all: Indicates all file systems that are known to this cluster.
all_local: Indicates all file systems that are owned by this cluster.
all_remote: Indicates all file systems that are owned by another cluster.

This must be the first parameter.

The following optional parameters, when used, must be provided after the Device | all | all_local | all_remote parameter:

-A: Displays if and when the file system is automatically mounted.
-B: Displays the size of the data block, in bytes.
-d: Displays the names of all of the disks in the file system.
-D: Displays the type of file locking semantics that are in effect (nfs4 or posix).
-E: Displays the exact mtime values reported.
-f: Displays the minimum fragment size, in bytes.
-i: Displays the inode size, in bytes.
-I: Displays the indirect block size, in bytes.
-j: Displays the block allocation type.
-k: Displays the type of authorization supported by the file system.
-K: Displays the strict replication enforcement.
-L: Displays the internal log file size.
-m: Displays the default number of metadata replicas.
-M: Displays the maximum number of metadata replicas.
-n: Displays the estimated number of nodes for mounting the file system.
-o: Displays the additional mount options.
-P: Displays the storage pools defined within the file system.
-Q: Displays which quotas are currently enforced on the file system.
-r: Displays the default number of data replicas.
-R: Displays the maximum number of data replicas.
-S: Displays whether the updating of atime is suppressed for the gpfs_stat(), gpfs_fstat(), stat(), and fstat() calls.
-t: Displays the Windows drive letter.
-T: Displays the default mount point.
-V: Displays the current format version of the file system.
-z: Displays whether DMAPI is enabled for this file system.
--create-time: Displays the creation time of the file system.
--encryption: Displays a yes or no value indicating whether encryption is enabled. This value cannot be changed with the mmchfs command. When the cluster is created this value is set to no. When an encryption policy is established for the file system, the value is set to yes.
--fastea: Displays a yes or no value indicating whether fast external attributes is enabled. Displays a migrating value if migration was initiated with mmmigratefs --fastea but is not yet complete.
--filesetdf: Displays a yes or no value indicating whether filesetdf is enabled; if yes, the mmdf command reports numbers based on the quotas for the fileset and not for the total file system.
--inode-limit: Displays the maximum number of files in the file system.
--is4KAligned: Displays whether file systems are formatted to be 4K aligned.
--log-replicas: Displays the number of recovery log replicas. If a value of 0 is displayed, the number of recovery log replicas is the same as the number of metadata replicas currently in effect for the file system.
--mount-priority: Displays the assigned mount priority.
--perfileset-quota: Displays the per-fileset quota.
--rapid-repair: Displays a yes or no value indicating whether the per-block replication tracking and repair feature is enabled.
--write-cache-threshold: Displays the threshold below which synchronous writes will be initially buffered in the highly-available write cache before being written back to primary storage.

Exit status

0

Successful completion.

nonzero

A failure has occurred.

Note:

The command treats the following conditions as failures:

The file system that you specified was not found.
You specified all, all_local, or all_remote and no file systems were found.

Security

If you are a root user, 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.

As root, a user can also issue the mmlsfs on remote file systems.

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

Examples

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

mmlsfs gpfs1

The system displays information similar to this:

flag                value                    description
------------------- ------------------------ -----------------------------------
 -f                 8192                     Minimum fragment size in bytes
 -i                 4096                     Inode size in bytes
 -I                 16384                    Indirect block size in bytes
 -m                 2                        Default number of metadata replicas
 -M                 2                        Maximum number of metadata replicas
 -r                 2                        Default number of data replicas
 -R                 2                        Maximum number of data replicas
 -j                 cluster                  Block allocation type
 -D                 nfs4                     File locking semantics in effect
 -k                 all                      ACL semantics in effect
 -n                 32                       Estimated number of nodes that will mount file system
 -B                 262144                   Block size
 -Q                 user;group;fileset       Quotas accounting enabled
                    user;group;fileset       Quotas enforced
                    none                     Default quotas enabled
 --perfileset-quota no                       Per-fileset quota enforcement
 --filesetdf        no                       Fileset df enabled?
 -V                 14.20 (4.1.1.0)          File system version
 --create-time      Fri Jun 12 18:39:47 2015 File system creation time
 -z                 no                       Is DMAPI enabled?
 -L                 134217728                Logfile size
 -E                 yes                      Exact mtime mount option
 -S                 no                       Suppress atime mount option
 -K                 whenpossible             Strict replica allocation option
 --fastea           yes                      Fast external attributes enabled?
 --encryption       no                       Encryption enabled?
 --inode-limit      607488                   Maximum number of inodes in all inode spaces
 --log-replicas     2                        Number of log replicas
 --is4KAligned      yes                      is4KAligned?
 --rapid-repair     yes                      rapidRepair enabled?
 --write-cache-threshold 65536               HAWC Threshold (max 65536)
 -P                 system                   Disk storage pools in file system
 -d                 nsd20;nsd21;nsd3         Disks in file system
 -A                 yes                      Automatic mount option
 -o                 none                     Additional mount options
 -T                 /gpfs1                   Default mount point
 --mount-priority   0                        Mount priority

If you issue the mmlsfs command with the all option:

mmlsfs all -A

The system displays information similar to:

File system attributes for /dev/fs1:
====================================
flag                value                    description
------------------- ------------------------ -----------------------------------
 -A                 yes                      Automatic mount option

File system attributes for /dev/gpfs1:
======================================
flag                value                    description
------------------- ------------------------ -----------------------------------
 -A                 yes                      Automatic mount option

Location

/usr/lpp/mmfs/bin