Removes from the system a path to an MPIO capable device.
rmpath [ -l Name ] [ -p Parent ] [ -w Connection ] [ -i PathID ]
rmpath [ -l Name ] [ -p Parent ] [ -w Connection ] [ -d ] [ -g ]
rmpath -h
The rmpath command unconfigures, and possibly undefines, one or more paths associated with the specified target device (-l Name). The set of paths that are removed are determined by the combination of the -l Name, -p Parent, and -w Connection flags. If the command will result in all paths associated with the device being unconfigured or undefined, the command will exit with an error and without unconfiguring or undefining any path. In this situation, rmdev command must be used instead to unconfigure or undefine the target device itself.
The default action unconfigures each specified path, but does not completely remove it from the system. If the -d flag is specified, the rmpath command unconfigures (if necessary) and removes, or deletes, the path definition(s) from the system.
When the rmpath command finishes, it displays a status message. When unconfiguring paths, it is possible for this command to be able to unconfigure some paths and not others (e.g., paths that are in the process of doing I/O cannot be unconfigured).
Item | Description |
---|---|
-d | Indicates that the specified paths are to be deleted from the system. |
-g | Forces the remove path operation to run on a locked device. |
-h | Displays the command usage message. |
-i PathID | Indicates the path ID associated with the path to be removed and is used to uniquely identify a path. |
-l Name | Specifies the logical device name of the target device whose path is to be removed. The paths to be removed are qualified via the -p and -w flags. |
-p Parent | Indicates the logical device name of the parent device to use in qualifying the paths to be removed. Since all paths to a device cannot be removed by this command, either this flag, the -w flag, or both must be specified. |
-w Connection | Indicates the connection information to use in qualifying the paths to be removed. Since all paths to a device cannot be removed by this command, either this flag, the -p flag, or both must be specified. |
Privilege Control: Only the root user and members of the system group have execute access to this command.
Event | Information |
---|---|
DEV_Change | rmpath,Unconfigure,<unconfigure method arguments> |
DEV_Change | rmpath,Undefine,<undefine method arguments> |
rmpath -l hdisk1 -p scsi0 -w "5,0"
The
message generated would be similar to: path defined
rmpath -l hdisk1 -p scsi0
If
all paths were successfully unconfigured, the message generated would
be similar to: paths defined
However, if only
some of the paths were successfully unconfigured, the message would
be similar to: some paths defined
rmpath -d -l hdisk1 -p scsi0 -w "5,0"
The
message generated would be similar to the following: path deleted
rmpath -d -l hdisk1 -p scsi0
The
message generated would be similar to: paths deleted
Item | Description |
---|---|
/usr/sbin/rmpath | Contains the rmpath command. |