HP StorageWorks Fabric OS 5.0.0 Command Reference Guide (AA-RW1MA-TE, May 2005)

362 Fabric OS commands
Display routing and statistics information along a path, covering multiple switches.
Synopsis
pathinfo [domain] [src_portnumber] [dst_portnumber] [-r]
Availability
admin
Description
Use this command to display detailed routing information from a source port or area on the local switch to
a destination port or area on another switch. This routing information describes the exact path that a user
data stream takes to go from the source port to the destination port, including all intermediate switches.
The command does not make any retry attempts if there is a timeout or failure. It might fail if a switch
along the path is busy; for instance, performing a warm recovery.
NOTE: If the advanced performance tuning (APT) policy in effect on the intermediate switches is not a
port-based policy, subsequent data streams might not take the same path as displayed in the pathInfo
output.
Refer to aptPolicy for more information on advanced performance tuning policies.
If you specify an inactive port or a path through a switch that does not have active routing tables to the
destination, this command displays the path that would be used if the ports were active. If you specify a
destination port that is not active, this command uses the embedded port as the destination.
For bladed systems, the ingress and egress points are specified as area numbers. For nonbladed systems,
ingress and egress points are specified as ports. This agrees with the representation displayed by the
switchShow command.
In addition, pathInfo can provide, upon request, statistics on every traversed Inter-Switch Link (ISL) that is
part of the path. This feature is available in interactive mode only.
The routing and statistics information are provided by every switch along the path, based on the current
routing-tables information and statistics calculated continuously in real-time. Each switch represents one
hop of the total path.
Other options allow the collection of information on the reverse path, or on a user selected path (source
route).
For each hop, the routing information output includes the following:
pathInfo
Hop The hop number. The local switch is hop 0.
In Port The port or area from which the switch receives frames. For hop 0,
this is src_portnumber. For bladed systems, this is specified as the
area number; otherwise, it is the port number.
Domain ID The domain ID of the switch.
Name The name of the switch.
Out Port The output port that the frames use to reach the next hop. For the last
hop, this is dst_portnumber. For bladed systems, this is specified as
the area number; otherwise, it is the port number.