Debian Codegraph @

infiniband-diags/man/common/sec_topology-file.rst

raw
1 .. Common text to describe the Topology file.
2
3 TOPOLOGY FILE FORMAT
4 --------------------
5
6 The topology file format is human readable and largely intuitive.
7 Most identifiers are given textual names like vendor ID (vendid), device ID
8 (device ID), GUIDs of various types (sysimgguid, caguid, switchguid, etc.).
9 PortGUIDs are shown in parentheses (). For switches, this is shown on the
10 switchguid line. For CA and router ports, it is shown on the connectivity
11 lines. The IB node is identified followed by the number of ports and a quoted
12 the node GUID. On the right of this line is a comment (#) followed by the
13 NodeDescription in quotes. If the node is a switch, this line also contains
14 whether switch port 0 is base or enhanced, and the LID and LMC of port 0.
15 Subsequent lines pertaining to this node show the connectivity. On the
16 left is the port number of the current node. On the right is the peer node
17 (node at other end of link). It is identified in quotes with nodetype
18 followed by - followed by NodeGUID with the port number in square brackets.
19 Further on the right is a comment (#). What follows the comment is
20 dependent on the node type. If it it a switch node, it is followed by
21 the NodeDescription in quotes and the LID of the peer node. If it is a
22 CA or router node, it is followed by the local LID and LMC and then
23 followed by the NodeDescription in quotes and the LID of the peer node.
24 The active link width and speed are then appended to the end of this
25 output line.
26
27 An example of this is:
28
29 ::
30
31 #
32 # Topology file: generated on Tue Jun 5 14:15:10 2007
33 #
34 # Max of 3 hops discovered
35 # Initiated from node 0008f10403960558 port 0008f10403960559
36
37 Non-Chassis Nodes
38
39 vendid=0x8f1
40 devid=0x5a06
41 sysimgguid=0x5442ba00003000
42 switchguid=0x5442ba00003080(5442ba00003080)
43 Switch 24 "S-005442ba00003080" # "ISR9024 Voltaire" base port 0 lid 6 lmc 0
44 [22] "H-0008f10403961354"[1](8f10403961355) # "MT23108 InfiniHost Mellanox Technologies" lid 4 4xSDR
45 [10] "S-0008f10400410015"[1] # "SW-6IB4 Voltaire" lid 3 4xSDR
46 [8] "H-0008f10403960558"[2](8f1040396055a) # "MT23108 InfiniHost Mellanox Technologies" lid 14 4xSDR
47 [6] "S-0008f10400410015"[3] # "SW-6IB4 Voltaire" lid 3 4xSDR
48 [12] "H-0008f10403960558"[1](8f10403960559) # "MT23108 InfiniHost Mellanox Technologies" lid 10 4xSDR
49
50 vendid=0x8f1
51 devid=0x5a05
52 switchguid=0x8f10400410015(8f10400410015)
53 Switch 8 "S-0008f10400410015" # "SW-6IB4 Voltaire" base port 0 lid 3 lmc 0
54 [6] "H-0008f10403960984"[1](8f10403960985) # "MT23108 InfiniHost Mellanox Technologies" lid 16 4xSDR
55 [4] "H-005442b100004900"[1](5442b100004901) # "MT23108 InfiniHost Mellanox Technologies" lid 12 4xSDR
56 [1] "S-005442ba00003080"[10] # "ISR9024 Voltaire" lid 6 1xSDR
57 [3] "S-005442ba00003080"[6] # "ISR9024 Voltaire" lid 6 4xSDR
58
59 vendid=0x2c9
60 devid=0x5a44
61 caguid=0x8f10403960984
62 Ca 2 "H-0008f10403960984" # "MT23108 InfiniHost Mellanox Technologies"
63 [1](8f10403960985) "S-0008f10400410015"[6] # lid 16 lmc 1 "SW-6IB4 Voltaire" lid 3 4xSDR
64
65 vendid=0x2c9
66 devid=0x5a44
67 caguid=0x5442b100004900
68 Ca 2 "H-005442b100004900" # "MT23108 InfiniHost Mellanox Technologies"
69 [1](5442b100004901) "S-0008f10400410015"[4] # lid 12 lmc 1 "SW-6IB4 Voltaire" lid 3 4xSDR
70
71 vendid=0x2c9
72 devid=0x5a44
73 caguid=0x8f10403961354
74 Ca 2 "H-0008f10403961354" # "MT23108 InfiniHost Mellanox Technologies"
75 [1](8f10403961355) "S-005442ba00003080"[22] # lid 4 lmc 1 "ISR9024 Voltaire" lid 6 4xSDR
76
77 vendid=0x2c9
78 devid=0x5a44
79 caguid=0x8f10403960558
80 Ca 2 "H-0008f10403960558" # "MT23108 InfiniHost Mellanox Technologies"
81 [2](8f1040396055a) "S-005442ba00003080"[8] # lid 14 lmc 1 "ISR9024 Voltaire" lid 6 4xSDR
82 [1](8f10403960559) "S-005442ba00003080"[12] # lid 10 lmc 1 "ISR9024 Voltaire" lid 6 1xSDR
83
84
85 When grouping is used, IB nodes are organized into chassis which are
86 numbered. Nodes which cannot be determined to be in a chassis are
87 displayed as "Non-Chassis Nodes". External ports are also shown on the
88 connectivity lines.
89