Commands Reference, Volume 4

rmpath Command

Purpose

Removes a path from a multipath I/O (MPIO) capable device.

Syntax

rmpath -l Name [ -d [ -c ] ] [ -p Parent ] [ -w Connection ] [ -v Level ]

rmpath -h

The rmpath command undefines, unconfigures, or both undefines and unconfigures a path in the Customized Paths (CuPath) object class for the specified device (-l Name). The set of paths that is removed is indicated by the -p Parent and -w Connection flags. If the command results in all paths associated with the device being unconfigured or undefined, the command exits with an error and without unconfiguring or undefining any path. The rmdev command must be used instead since the device is to be unconfigured or undefined. It is not an error for rmpath to attempt to unconfigure paths that are not configured. The default action unconfigures each specified path while retaining its definition in the CuPath object class.

If the -d flag is specified, the rmpath command deletes (undefines) the path definition from the CuPath object class. The path must already be unconfigured unless the -c flag is also specified. If the -d flag is not specified, the rmpath command unconfigures each specified path and sets its Path_Status to the Path_Defined state.

When unconfiguring multiple paths, this command may only be able to unconfigure some paths and not others. For example, paths that are in the process of doing I/O, cannot be unconfigured. If this happens, the command indicates only that this occurred. To determine which paths are still configured, the lspath command should be executed.

Attention: To protect the Configuration database, the rmpath command cannot be interrupted. Stopping this command before execution is complete could result in a corrupted database.

Flags

-c	Indicates that the path being undefined should first be unconfigured. This flag is only valid when used with the -d flag.
-d	Indicates that a path's definition must be removed from the CuPath object class.
-h	Displays the command usage message.
-l Name	Specifies the logical device name of the device whose path information is to be removed; that is, unconfigured or undefined. The paths to be removed are qualified through 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.
-v Level	Indicates that verbose output at the indicated Level is desired. The only allowable value for this flag is debug. This provides information for diagnosing command problems.
-w Connection	Indicates the connection information associated with the path 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.

Examples

To unconfigure the paths between scsi0 and the hdisk1 device while retaining the path definition in the CuPath object class, type:
```
rmpath -l hdisk1 -p scsi0 
```
The system displays a message similar to the following:
```
hdisk1 paths from parent scsi0 defined
```
To also remove a path definition from the CuPath object class between scsi0 and the hdisk1 disk device, type:
```
rmpath -d -c -l hdisk1 -p scsi0
```
The system displays a message similar to the following:
```
hdisk1 paths from parent scsi0 deleted
```

Files

/usr/sbin/rmpath

Contains the rmpath command.

Related Information

The lspath command, rmdev command.