source: gpfs_3.1_ker2.6.20/share/man/man8/mmumount.8 @ 219

.TH mmumount 12/04/06
mmumount Command
.SH "Name"
.PP
\fBmmumount\fR - Unmounts GPFS file systems on one or more nodes in
the cluster.
.SH "Synopsis"
.PP
\fBmmumount\fR \fB{\fR\fIDevice\fR\fB |
\fR\fIMountPoint\fR\fB | all | all_local | all_remote}\fR \fB[-f
]\fR \fB[-a | -N
\fR\fB{\fR\fINode\fR\fB[,\fR\fINode\fR\fB...]
| \fR\fINodeFile\fR\fB | \fR\fINodeClass\fR\fB}]\fR
.PP
Or,
.PP
\fBmmumount \fR\fIDevice\fR\fB -f -C {all_remote |
\fR\fIClusterName\fR\fB} [-N
\fR\fINode\fR\fB[,\fR\fINode\fR\fB...]]\fR
.SH "Description"
.PP
Another name for the \fBmmumount\fR command is the \fBmmunmount\fR
command. Either name can be used.
.PP
The \fBmmumount\fR command unmounts a previously mounted GPFS file
system on one or more nodes in the cluster. If no nodes are specified,
the file systems are unmounted only on the node from which the command was
issued. The file system can be specified using its device name or the
mount point where it is currently mounted.
.PP
The first form of the command should be used to unmount file systems on
nodes that belong to the local cluster.
.PP
The second form of the command (-C option) should be used when it is
necessary to internally force unmount file systems that are owned by this
cluster but are mounted on nodes that belong to another cluster.
.PP
When a file system is internally force unmounted with the second form of
the \fBmmumount\fR command, the affected nodes may still show the file
system as mounted but the data will not be accessible. It is the
responsibility of the system administrator to clear the mount state by issuing
the \fBumount\fR command.
.SH "Parameters"
.PP
.RS +3
\fB\fIDevice\fR | all | all_local | all_remote
\fR
.RE
.RS +9
.PP
.RS +3
\fB\fIDevice\fR
\fR
.RE
.RS +9
The device name of the file system to be unmounted. File system
names do not need to be fully-qualified. \fBfs0\fR is just as
acceptable as \fB/dev/fs0\fR.
.RE
.PP
.RS +3
\fBall
\fR
.RE
.RS +9
Indicates all file systems known to this cluster
.RE
.PP
.RS +3
\fBall_local
\fR
.RE
.RS +9
Indicates all file systems owned by this cluster
.RE
.PP
.RS +3
\fBall_remote
\fR
.RE
.RS +9
Indicates all files systems owned by another cluster to which this cluster
has access
.RE
.PP
This must be the first parameter.
.RE
.PP
.RS +3
\fB\fIMountPoint\fR
\fR
.RE
.RS +9
The location where the GPFS file system to be unmounted is currently
mounted.
.RE
.SH "Options"
.PP
.RS +3
\fB-a
\fR
.RE
.RS +9
Unmount the file system on all nodes in the GPFS cluster.
.RE
.PP
.RS +3
\fB-f
\fR
.RE
.RS +9
Forces the unmount to take place even though the file system may be still
in use.
.PP
Use this flag with \fIextreme caution\fR. Using this flag may
cause outstanding write operations to be lost. Because of this, forcing
an unmount can cause data integrity failures and should be used with
caution.
.RE
.PP
.RS +3
\fB-C {all_remote | \fIClusterName\fR}
\fR
.RE
.RS +9
Specifies the cluster on which the file system is to be
force-unmounted. all_remote denotes all clusters other than the one
from which the command was issued.
.RE
.PP
.RS +3
\fB-N {\fINode\fR[,\fINode\fR...] |
\fINodeFile\fR | \fINodeClass\fR}
\fR
.RE
.RS +9
Specifies the nodes on which the file system is to be unmounted.
.PP
This command does not support a \fINodeClass\fR of
\fBmount\fR.
.PP
When the \fB-N\fR parameter is specified in conjunction with
\fB-C\fR \fIClusterName\fR, the specified node names are assumed
to refer to nodes that belong to the specified remote cluster (as identified
by the \fBmmlsmount\fR command). The \fBmmumount\fR command
cannot verify the accuracy of this information. \fINodeClass\fR and
\fINodeFile\fR are not supported in conjunction with the \fB-C\fR
option.
.RE
.SH "Exit status"
.PP
.PP
.RS +3
\fB0
\fR
.RE
.RS +9
Successful completion.
.RE
.PP
.RS +3
\fBnonzero
\fR
.RE
.RS +9
A failure has occurred.
.RE
.SH "Security"
.PP
You must have root authority to run the \fBmmumount\fR command.
.PP
You may issue the \fBmmumount\fR command from any node in the GPFS
cluster.
.SH "Examples"
.RS +3
.HP 3
1. To unmount file system \fBfs1\fR on all nodes in the cluster, issue
this command: 
.sp
.nf
mmumount fs1 -a
.fi
.sp
The system displays output similar to: 
.sp
.nf
Fri Feb 10 15:51:25 EST 2006: mmumount: Unmounting file systems ...
.fi
.sp
.HP 3
2. To force unmount file system \fBfs2\fR on the local node, issue this
command: 
.sp
.nf
mmumount fs2 -f
.fi
.sp
The system displays output similar to:
.sp
.nf
Fri Feb 10 15:52:20 EST 2006: mmumount: Unmounting file systems ...
forced unmount of /fs2
.fi
.sp
.RE
.SH "See also"
.PP
mmmount Command
.PP
mmlsmount Command
.SH "Location"
.PP
\fB/usr/lpp/mmfs/bin\fR