mmlsmount command
Lists the nodes that have a given GPFS™ file system mounted.
Synopsis
mmlsmount {Device | all | all_local | all_remote | {-F DeviceFileName}} [-L]
[-C {all | all_remote | ClusterName[,ClusterName...]}]
Availability
Available on all IBM Spectrum Scale™ editions.
Description
The mmlsmount command reports if a file system is in use at the time the command is issued. A file system is considered to be in use if it is explicitly mounted with the mount or mmmount command, or if it is mounted internally for the purposes of running some other GPFS command. For example, when you run the mmrestripefs command, the file system will be internally mounted for the duration of the command. If mmlsmount is issued in the interim, the file system will be reported as being in use by the mmlsmount command but, unless it is explicitly mounted, will not show up in the output of the mount or df commands.
Parameters
- Device | all | all_local | all_remote | {-F DeviceFileName}
- Indicates the file system or file systems for which information
is displayed.
- Device
- Indicates the device name of the file system for which information is displayed. File system names need not be fully-qualified. fs0 is just as acceptable as /dev/fs0.
- all
- Indicates all file systems known to this cluster.
- all_local
- Indicates all file systems owned by this cluster.
- all_remote
- Indicates all file systems owned by another cluster.
- -F DeviceFileName
- Specifies a file containing the device names, one per line, of the file systems for which information is displayed.
This must be the first parameter.
Options
- -C {all | all_remote | ClusterName[,ClusterName...]}
- Specifies the clusters for which mount information is requested.
If one or more ClusterName is specified,
only the names of nodes that belong to these clusters and have the
file system mounted are displayed. The dot character ('.') can be
used in place of the cluster name to denote the local cluster.
Option -C all_remote denotes all clusters other than the one from which the command was issued.
Option -C all refers to all clusters, local and remote, that can have the file system mounted. Option -C all is the default.
- -L
- Specifies to list the nodes that have the file system mounted.
Exit status
- 0
- Successful completion.
- nonzero
- A failure has occurred.
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 file system in IBM Spectrum Scale: Administration and Programming Reference.
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 mmlsmount command was issued.
Examples
- To see how many nodes have file system fs2 mounted,
issue this command:
mmlsmount fs2
The system displays output similar to:File system fs2 is mounted on 3 nodes.
- To display all mounted file systems:
mmlsmount all
The system displays output similar to:File system fs1 is mounted on 17 nodes. File system remotefs1 (remote.cluster:fs1) is mounted on 17 nodes.
- To display all remotely mounted file systems:
mmlsmount all_remote
The system displays output similar to:File system remotefs1 (remote.cluster:fs1) is mounted on 17 nodes.
- To list the nodes having all file systems mounted:
mmlsmount all -L
The system displays output similar to:File system fs1 is mounted on 3 nodes: 192.168.105.32 c6f1c3vp2 192.168.105.31 c6f1c3vp1 192.168.105.34 c6f1c3vp4 File system gpfs1 is not mounted.