Commands Reference, Volume 3

lspath Command

Purpose

Displays the status of paths to multipath I/O (MPIO) capable devices.

Syntax

lspath [ -F Format ] [ -H ] [ -I ] [ -l Name ] [ -p Parent ] [ -s Status ] [ -w Connection ] [ -v Level ]

lspath -h

The lspath command displays the status of paths to MPIO-capable devices. The set of paths to display is obtained by first taking the paths in the Customized Paths (CuPath) object class and matching the objects' Name, Parent, Connection, and Path_Status descriptors against any -l Name, -p Parent, -w Connection, and -s Status flags specified. If the -s Status flag is specified with an operation status such as enabled or disabled, the value of Path_Available is used when searching the CuPath object class and the set of paths obtained there then further qualifies after retrieving the operational status for each path from the device driver.

If the -I flag is specified, any path whose status is enabled or disabled also displays a count of the number of outstanding I/O operations for that path. The count is displayed as a decimal number within parenthesis after the state, such as enabled (2). A non-zero value can be displayed for a disabled path due to the semantics of disabled. A disabled path means that the path is not used for future I/O; there may still be outstanding I/O that was started prior to the path being disabled which has not completed.

By default, this command displays the information in columnar form. When no flags are specified that qualify the paths to display, the format of the output is as follows:

DEVICE     STATUS     PARENT     CONNECTION

When flags are specified that qualify the paths to display, the associated column is not output; that is, using the -l Name flag causes the DEVICE column to not be displayed. The exception to this is if the -s Status flag is specified with an operational status and the -I flag is also specified, the STATUS field is still displayed.

The default display format can be overridden by using the -F Format flag. The -F Format flag displays the output in a user-specified format where the Format parameter is a quoted list of column names (listed above) separated by, and may end with, non-numeric characters or white space.

Note: The column names above are not translated into other languages, either when output as column headings or when input as part of the Format of the -F flag.

Flags

-F Format	Displays the output of the command in a user-specified format where the Format parameter is a quoted list of column names, which are the column names output when headers are displayed. They are separated by, and may end with, non-numeric characters or white spaces.
-h	Displays the command usage message.
-H	Displays headers over the column output.
-I	Displays outstanding I/O counts for any path being displayed whose STATUS is either disabled or enabled.
-l Name	Specifies the logical device name of the device whose path status is to be displayed. The paths to be displayed are additionally qualified by the -p, -s, and -w flags.
-p Parent	Indicates the logical device name of the parent device to use in qualifying the paths to be displayed.
-s Status	Indicates the status to use in qualifying the paths to be displayed. The allowable values for these flags are as follows: *available* Displays paths whose Path_Status is Path_Available; that is, paths that are configured in the system, including enabled and disabled paths. *defined* Displays paths whose Path_Status is Path_Defined. *detected* Displays paths whose Path_Status is Path_Detected. *disable* Displays the paths that are disabled from MPIO path selection. *enable* Displays the paths that are enabled for MPIO path selection. *missing* Displays paths whose Path_Status is Path_Missing.
-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 to use in qualifying the paths to be displayed.

Examples

To display the status of all paths to hdisk1 with column headers and I/O counts, type:

lspath -l hdisk1 -H

The system displays a message similar to the following:

STATUS          PARENT          CONNECTION
enabled   (4)   scsi0           5,0
disabled  (0)   scsi1           5,0
missing         scsi2           5,0

To display without column headers, the set of paths whose operational status is disabled, type:
```
lspath -s disabled
```
The system displays a message similar to the following:
```
hdisk1        scsi1        5, 0
hdisk2        scsi1        6, 0
hdisk23       scsi8        3, 0
hdisk25       scsi8        4, 0
```
To display in a user-specified format, without column headers, the set of paths to hdisk1 whose status is available, type:
```
lspath -l hdisk1 -s available -f"CONNECTION:PARENT:STATUS\T[]"
```
The system displays a message similar to the following:
```
5,0:scsi0:enabled       [ ]
5,0:scsi1:disabled      [ ]
```

Files

/usr/sbin/lspath

Contains the lspath command.