mmlsfs command

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 block size of the file system in bytes. For more information about block size, see the description of the -B BlockSize parameter in mmcrfs command.

-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 (subblock) size of the file system in bytes. The subblock size and the number of subblocks in a block are determined by the block size. For more information, see the description of the -B BlockSize parameter in mmcrfs command.

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

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

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

--subblocks-per-full-block

Displays the number of subblocks in a file system data block.

--file-audit-log

Displays whether file audit logging is enabled or disabled.

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.

See also

Location