Pathinfo - Brocade Communications Systems 8 Command Reference Manual

2

pathInfo

pathInfo
Displays routing information and statistics along a path covering multiple switches.
Synopsis pathinfo
pathinfo -f FID destination_switch [destination_port] [-r] [-t]
pathinfo destination_switch [source_port[destination_port]] [-r] [-t]
Description Use this command to display routing information from a source port on the local switch to a
destination port on another switch. The command output describes the exact data path between
these ports, including all intermediate switches.
When using pathInfo across fabrics connected through an FC router, the command represents
backbone information as a single hop. The command captures details about the FC router to which
ingress and egress EX_Ports are connected, but it hides the details about the path the frame
traverses between the ingress EX_Ports to the egress EX_Ports in the backbone.
To use pathInfo across remote fabrics, you must specify both the fabric ID (FID) and the domain ID
of the remote switch. You cannot use the command to obtain source port information across
remote FCR fabrics. When obtaining path info across remote fabrics, the destination switch must
be identified by its Domain ID. Identifying the switch by name or WWN is not accepted.
The command does not retry if there is a timeout or failure. It may fail if a switch along the path is
busy or does not support this feature.
If the advanced performance tuning (APT) policy in effect on the intermediate switches is not a
port-based policy, subsequent data streams may 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 describes the path that would be taken if the ports were active. If
you specify a destination port that is not active, this command uses the embedded port as the
destination.
The ingress and egress points above 256 are specified as port index. Use switchShow for a listing
of valid port index numbers.
In addition, pathInfo can provide statistics on every traversed interswitch link (ISL) that is part of
the path. This feature is available only in the interactive command mode.
The routing and statistics information are provided by every switch along the path, based on the
current routing table information and statistics calculated continuously in real-time. Each switch
represents one hop of the total path.
In a Virtual Fabric environment, pathInfo displays port numbers beyond physical port numbers
while displaying information for a hop that corresponds to a path in the base fabric. The cost for
this hop is the cost of the corresponding path in the base fabric plus a small offset. Refer to the
example section for an illustration.
Other command options allow the collection of information on the reverse path, or on a
user-selected path (source route).
For each hop, this command displays the following fields:
Hop
548
The hop number. The local switch is hop 0.
Fabric OS Command Reference
53-1001764-02