rmpath command

Purpose

Removes from the system a path to an MPIO-capable device.

Syntax

rmpath { [ -dev Name ] [ -pdev Parent ] [ -conn Connection ] } [ -rm ]

Description

The rmpath command unconfigures, and possibly undefines, one or more paths associated with the specified target device (-dev Name). The set of paths that is removed is determined by the combination of the -dev Name, -pdev Parent and -conn 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 -rm 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 (for example, paths that are in the process of doing I/O cannot be unconfigured).

The rmpath command provides status messages about the results of operation. Messages in one of the following formats will be generated:

path [ defined | deleted ]: This message is displayed when a single path was successfully unconfigured or undefined. If the path is successfully configured the message path available displays. If the path is not successfully configured and there is no explicit error code returned by the method, the message path defined displays.
paths [defined | deleted]: This message is displayed if multiple paths were identified and all paths were successfully unconfigured or undefined. If the -rm flag is not specified, the message would be paths defined. If the -rm flag is specified, the message would be paths deleted.
some paths [ defined | deleted ]: This message is display if multiple paths were identified, but only some of them were successfully unconfigured or undefined. If the -rm flag is not specified, the message would be some paths defined. If the -rm flag is specified, the message would be some paths deleted.
no paths processed: This message is generated if no paths were found matching the selection criteria.

Flags

-rm	Indicates that the specified paths are to be deleted from the system.
-dev 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 -pdev and -conn flags.
-pdev 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 -conn flag, or both must be specified.
-conn 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 -pdev flag, or both must be specified.

Exit Status

See Exit status for Virtual I/O Server commands.

Examples

1. To unconfigure the path from scsi0 to hdisk1 at connection 5,0, type:
```
rmpath -dev hdisk1 -pdev scsi0 -conn "5,0"
```
The message generated would be similar to:
```
path defined
```
To unconfigure all paths from scsi0 to hdisk1, type:
```
rmpath -dev hdisk1 -pdev 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
```
To undefine the path definition between scsi0 and hdisk1 at connection 5,0, type:
```
rmpath -rm -dev hdisk1 -pdev scsi0 -conn "5,0"
```
The message generated would be similar to the following:
```
path deleted
```
To unconfigure all paths from scsi0 to hdisk1, type:
```
rmpath -rm -dev hdisk1 -pdev scsi0
```
The message generated would be similar to:
```
paths deleted
```

Related Information

The chpath command, the lspath command, and the rmpath command.