User Manual

InfiniBand FabricRev 4.3
Mellanox Technologies
67
7.3.8.3 Topology File Format
The topology file format is largely intuitive. Most identifiers are given textual names like ven-
dor ID (vendid), device ID (device ID), GUIDs of various types (sysimgguid, caguid, switch-
guid, etc.). PortGUIDs are shown in parentheses (). For switches, this is shown on the
switchguid line. For CA and router ports, it is shown on the connectivity lines. The IB node is
identified followed by the number of ports and the node GUID. On the right of this line is a com-
ment (#) followed by the NodeDescription in quotes. If the node is a switch, this line also con-
tains whether switch port 0 is base or enhanced, and the LID and LMC of port 0. Subsequent
lines pertaining to this node show the connectivity. On the left is the port number of the current
node. On the right is the peer node (node at other end of link). It is identified in quotes with
nodetype followed by - followed by NodeGUID with the port number in square brackets.
Further on the right is a comment (#). What follows the comment is dependent on the node type.
If it it a switch node, it is followed by the NodeDescription in quotes and the LID of the peer
node. If it is a CA or router node, it is followed by the local LID and LMC and then followed by
the NodeDescription in quotes and the LID of the peer node. The active link width and speed
are then appended to the end of this output line.
Example
Non-Chassis Nodes
When grouping is used, IB nodes are organized into chasses which are numbered. Nodes
which cannot be determined to be in a chassis are displayed as "Non-Chassis Nodes". External
ports are also shown on the connectivity lines.
-usage, -u Usage message
--Ca, -C <ca_name> Use the specified ca_name
--Port, -P <ca_port> Use the specified ca_port
--timeout, -t <timeout_ms> Override the default timeout for the solicited mads
--full, -f show full information (ports' speed and width)
--show, -s show more information
# Topology file: generated on Tue Jun 5 14:15:10 2007
#
# Max of 3 hops discovered
# Initiated from node 0008f10403960558 port 0008f10403960559
vendid=0x8f1
devid=0x5a06
sysimgguid=0x5442ba00003000
switchguid=0x5442ba00003080(5442ba00003080)
Switch 24 "S-005442ba00003080" # "ISR9024 Voltaire" base port 0 lid 6 lmc 0
[22] "H-0008f10403961354"[1](8f10403961355) # "MT23108 InfiniHost Mellanox
Technologies" lid 4 4xSDR
[10] "S-0008f10400410015"[1] # "SW-6IB4 Voltaire" lid 3 4xSDR
Table 11 - ibnetdiscover Flags and Options
Flag Description