mmunlinkfileset command
Removes the junction to a GPFS™ fileset.
Synopsis
mmunlinkfileset Device {FilesetName | -J JunctionPath} [-f]
Availability
Available with IBM Spectrum Scale™ Standard Edition or higher.
Description
The mmunlinkfileset command removes the junction to the fileset. The junction can be specified by path or by naming the fileset that is its target. The unlink fails if there are files open in the fileset, unless the -f flag is specified. The root fileset may not be unlinked.
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.
- FilesetName
- Specifies the name of the fileset to be removed.
- -J JunctionPath
- Specifies the name of the junction to be removed.
A junction is a special directory entry that connects a name in a directory of one fileset to the root directory of another fileset.
- -f
- Forces the unlink to take place even though there may be open files. This option forcibly closes any open files, causing an errno of ESTALE on their next use of the file.
Exit status
- 0
- Successful completion.
- nonzero
- A failure has occurred.
Security
You must have root authority to run the mmunlinkfileset command.
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.
Examples
- This command indicates the current configuration of filesets for
file system gpfs1:
The system displays output similar to:mmlsfileset gpfs1
Filesets in file system 'gpfs1': Name Status Path root Linked /gpfs1 fset1 Linked /gpfs1/fset
This command unlinks fileset fset1 from file system gpfs1:
The system displays output similar to:mmunlinkfileset gpfs1 fset1
Fileset 'fset1' unlinked.
To confirm the change, issue this command:
The system displays output similar to:mmlsfileset gpfs1
Filesets in file system 'gpfs1': Name Status Path root Linked /gpfs1 fset1 Unlinked --
- This command indicates the current configuration of filesets for
file system gpfs1:
The system displays output similar to:mmlsfileset gpfs1
Filesets in file system 'gpfs1': Name Status Path root Linked /gpfs1 fset1 Linked /gpfs1/fset1
This command unlinks junction path /gpfs1/fset1 from file system gpfs1:
The system displays output similar to:mmunlinkfileset gpfs1 -J /gpfs1/fset1
Fileset 'fset1' unlinked.
To confirm the change, issue this command:
The system displays output similar to:mmlsfileset gpfs1
Filesets in file system 'gpfs1': Name Status Path root Linked /gpfs1 fset1 Unlinked --