mmlsfileset command

Displays attributes and status for GPFS filesets.

Synopsis

mmlsfileset Device
      [[Fileset[,Fileset...]] [-J Junction[,Junction...]] | -F FileName]
      [-d [--block-size {BlockSize | auto}]] [-i] [-L] [-X] [-Y]
      [--afm] [--deleted] [--iam-mode]

Availability

Available on all IBM Spectrum Scale editions.

Description

Use the mmlsfileset command to display information for the filesets that belong to a given GPFS file system. The default is to display information for all filesets in the file system. You may choose to display information for only a subset of the filesets.

The operation of the -L flag omits the attributes listed without it, namely status and junction path. In addition, if the fileset has status Deleted, then -L also displays the name of the latest snapshot that includes the fileset in place of the root inode number and parent fileset identifier.

The attributes displayed are:

Name of the fileset
Status of the fileset (when the -L flag is omitted)
Junction path to the fileset (when the -L flag is omitted)
Fileset identifier (when the -L flag is included)
Root inode number, if not deleted (when the -L flag is included)
Parent fileset identifier, if not deleted (when the -L flag is included)
Latest including snapshot, if deleted (when the -L flag is included)
Creation time (when the -L flag is included)
Inode space (when the -L flag is included)
Number of inodes in use (when the -i flag is included)
Data size (when the -d flag is included)
Comment (when the -L flag is included)
Caching-related information (when the --afm flag is included)
Value of the permission change flag (when the -X flag is used to generate stanza output)
Integrated archive manger (IAM) mode information

For information on GPFS filesets, see the IBM Spectrum Scale: Administration Guide.

Parameters

Device

The device name of the file system that contains the fileset.

File system names need not be fully-qualified. fs0 is as acceptable as /dev/fs0.

This must be the first parameter.

Fileset

Specifies a comma-separated list of fileset names.

-J Junction

Specifies a comma-separated list of path names. They are not restricted to fileset junctions, but may name any file or directory within the filesets to be listed.

-F FileName

Specifies the name of a file containing either fileset names or path names. Each line must contain a single entry. All path names must be fully-qualified.

-d

Displays the amount of storage in use for the fileset.

This operation requires an amount of time that is proportional to the size of the file system; therefore, it can take several minutes or even hours on a large and heavily-loaded file system.

This optional parameter can impact overall system performance. Avoid running the mmlsfileset command with this parameter frequently or during periods of high file system activity.

This option is not valid if the Device parameter is a remote file system.

--block-size {BlockSize | auto}

Specifies the unit in which the number of blocks is displayed. The value must be of the form [n]K, [n]M, [n]G or [n]T, where n is an optional integer in the range 1 to 1023. The default is 1K. If auto is specified, the number of blocks is automatically scaled to an easy-to-read value.

-i

Displays the number of inodes in use for the fileset.

This option is not valid if the Device parameter is a remote file system.

This operation requires an amount of time that is proportional to the number of inodes in the file system; therefore, it can take several minutes or even hours on a large and heavily-loaded file system.

Information about the number of inodes in the fileset can be retrieved more efficiently with the following command, if quota management has been enabled for the file system:

mmrepquota -j FileSystem

-L

Displays additional information for the fileset. This includes:

Fileset identifier
Root inode number
Parent identifier
Fileset creation time
Inode space
User defined comments, if any

If the fileset is a dependent fileset, dpnd will be displayed next to the inode space identifier.

-X

Generates stanza output containing the following:

The same information presented by the -L flag
The value of the permission change flag
The same information presented by the --afm flag

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

--afm

Displays caching-related information for the fileset.

--deleted

Displays only the filesets with a status of Deleted.

--iam-mode

Displays integrated archive manager (IAM) mode information. For more information, see mmchfileset command.

Exit status

0: Successful completion.
nonzero: A failure has occurred.

Security

Fileset owners can run the mmlsfileset command with the -L, -d, and -i options.

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.