Displays information about paths to a MultiPath I/O (MPIO) capable device.
lspath [ -dev DeviceName ] [ -pdev Parent ] [ -status Status ] [ -conn Connection ] [ -field FieldName ... ] [ -fmt Delimiter ]
lspath -dev DeviceName -pdev Parent [ -conn Connection ] -lsattr [ -attr Attribute... ] [ -field FieldName ... ] [ -fmt Delimiter ]
lspath -dev DeviceName -pdev Parent [ -conn Connection ] -range Attribute [ -field FieldName ... ] [ -fmt Delimiter ]
The lspath command displays one of three types of information about paths to an MPIO capable device. It either displays the operational status for one or more paths to a single device, or it displays one or more attributes for a single path to a single MPIO capable device. The first syntax shown above displays the operational status for one or more paths to a particular MPIO capable device. The second syntax displays one or more attributes for a single path to a particular MPIO capable device. Finally, the third syntax displays the possible range of values for an attribute for a single path to a particular MPIO capable device.
Flag name | Description |
---|---|
-attr Attribute | Identifies the specific attribute to list. The 'Attribute' is the name of a path specific attribute. When this flag is provided, only the identified attribute is displayed. Multiple instances of this flag may be used to list multiple attributes. If this flag is not specified at all, all attributes associated with the identified path will be listed. |
-lsattr | Displays the attribute names, current values, descriptions, and user-settable flag values for a specific path. |
-dev Name | Specifies the logical device name of the target device whose path information is to be displayed. |
-field FieldNames | Specifies the list of fields to display. The
following fields are supported:
|
-fmt Delimiter | Specifies a delimiter character to separate output fields. |
-pdev Parent | Indicates the logical device name of the parent device of the path(s) to be displayed. |
-range | Displays the legal values for an attribute name.
The -range flag displays the list attribute values in a vertical
column as follows:
The -range flag displays the range attribute values
as x...n(+i) where x is the start of the range, n is the end of the
range, and i is the increment. |
-status Status | The -status Status flag indicates
the status to use in qualifying the paths to be displayed. When displaying
path information, the allowable values for this flag are:
|
-conn Connection | Indicates the connection information to use in qualifying the paths to be displayed. |
Return code | Description |
---|---|
1 | Invalid status value. |
lspath -status disabled
The system will display a message similar to the following:
disabled hdisk1 scsi1
disabled hdisk2 scsi1
disabled hdisk23 scsi8
disabled hdisk25 scsi8
lspath -status failed
The system will display a message similar to the following:
failed hdisk1 scsi1
failed hdisk2 scsi1
failed hdisk23 scsi8
failed hdisk25 scsi8
lspath -dev hdisk10 -pdev scsi0 -conn "5,0" -lsattr
The system will display a message similar to the following:
weight 1 Order of path failover selection true