mmlsfs command

Availability

Available on all IBM Storage Scale editions.

Description

Use the mmlsfs command to list the attributes of a file system. You can issue the mmlsfs command for file systems that belong to the current cluster or for file systems that are owned by other clusters.

Depending on your configuration, additional information that is set by GPFS can be displayed to help 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 that are specified are listed, in the order issued in the command. Some parameters are preset for optimum performance and, although they are displayed 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 that is 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 that are 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 to indicate 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 to indicate whether fast external attributes are enabled. Displays a migrating value if migration was initiated with mmmigratefs --fastea but is not yet complete.

--file-audit-log

Displays whether file audit logging is enabled or disabled.

--filesetdf

Displays a yes or no value to indicate whether filesetdf is enabled. If yes, the df command reports either quota limit and usage or inode space capacity and usage for the fileset and not for the total file system. This option affects the df command behavior only on Linux® nodes.

The df command reports quota limit and quota usage if quota is enabled for the fileset. If quota is disabled and filesetdf is enabled in IBM Storage Scale 5.1.1 or later with file system version 5.1.1 or later, then the df command reports inode space capacity and inode usage at the independent fileset level. However, the df command reports the block space at the file system level because the block space is shared with the whole file system.

Note: In IBM Storage Scale 5.1.3 or later with the file system version 5.1.1 or later, if quota is enabled but the limits are not defined then the df command reports inode space capacity and inode space usage at the independent fileset level.

--flush-on-close

Displays whether the automatic flushing of disk buffers is enabled when closing files that were opened for write operations.

--inode-limit

Displays the maximum number of files in the file system.

--auto-inode-limit

Displays whether the automatic increase in the maximum number of inodes is enabled.

--inode-segment-mgr

Displays whether Inode Segment Manager is enabled.

Note: To enable this feature, the format version of the file system must be 5.2.0 (34.00) or later.

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

--maintenance-mode

Displays a yes or no value to indicate whether file system maintenance mode is on or off:

• The value yes indicates that file system maintenance mode is on.
• The value no, which is the default, indicates that file system maintenance mode is off.

For more information on file system maintenance mode, see File system maintenance mode.

Note: Another possible output value can be request in progress. This output value means that the file system is asked to enable or disable file system maintenance mode, and that request is in progress.

--mount-priority

Displays the assigned mount priority.

--nfs4-owner-write-acl

Displays whether object owners are given implicit NFSv4 WRITE_ACL permission.

Note: The minimum release level of the cluster must be 5.1.5 or later and the file system format version must be at 5.1.5 (29.00) or later to enable this feature.

--perfileset-quota

Displays the per-fileset quota.

--rapid-repair

Displays a yes or no indicating whether the per-block replication tracking and repair feature is enabled.

--write-cache-threshold

Displays the threshold value below which synchronous writes are 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.

--uid

Displays the file system unique identifier.

Exit status

0

Successful completion.

nonzero

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

See also

Location