1IBTRACERT(8) Open IB Diagnostics IBTRACERT(8)
2
6 ibtracert - trace InfiniBand path
7
9 ibtracert [options] [<lid|guid> [<startlid> [<endlid>]]]
10
12 ibtracert uses SMPs to trace the path from a source GID/LID to a desti‐
13 nation GID/LID. Each hop along the path is displayed until the destina‐
14 tion is reached or a hop does not respond. By using the -m option, mul‐
15 ticast path tracing can be performed between source and destination
16 nodes.
17
19 -n, --no_info
20 simple format; don't show additional information
21 -m show the multicast trace of the specified mlid
23 -f, --force
25 force route to destination port
26 Addressing Flags
28 -G, --Guid The address specified is a Port GUID
29 -L, --Lid The address specified is a LID
31 -s, --sm_port <smlid> use 'smlid' as the target lid for SA queries.
33 --ports-file <ports-file> Specify a ports file.
35 This file contains multiple source and destination lid or guid
36 pairs. See FILES section.
37 Port Selection flags
39 -C, --Ca <ca_name> use the specified ca_name.
40 -P, --Port <ca_port> use the specified ca_port.
42 Local port Selection
44 Multiple port/Multiple CA support: when no IB device or port is speci‐
45 fied (see the "local umad parameters" below), the libibumad library
46 selects the port to use by the following criteria:
47 1. the first port that is ACTIVE.
49 2. if not found, the first port that is UP (physical link up).
51 If a port and/or CA name is specified, the libibumad library
53 attempts to fulfill the user request, and will fail if it is not
54 possible.
55 For example:
57 ibaddr # use the first port (criteria #1 above)
59 ibaddr -C mthca1 # pick the best port from "mthca1" only.
60 ibaddr -P 2 # use the second (active/up) port from the first available IB device.
61 ibaddr -C mthca0 -P 2 # use the specified port only.
62 Debugging flags
64 -d raise the IB debugging level. May be used several times (-ddd
65 or -d -d -d).
66 -e show send and receive errors (timeouts and others)
68 -h, --help show the usage message
70 -v, --verbose
72 increase the application verbosity level. May be used several
73 times (-vv or -v -v -v)
74 -V, --version show the version info.
76 Configuration flags
78 -t, --timeout <timeout_ms> override the default timeout for the
79 solicited mads.
80 --node-name-map <node-name-map> Specify a node name map.
82 This file maps GUIDs to more user friendly names. See FILES sec‐
83 tion.
84 -y, --m_key <key>
86 use the specified M_key for requests. If non-numeric value (like
87 'x') is specified then a value will be prompted for.
88 --config, -z <config_file> Specify alternate config file.
90 Default: /etc/infiniband-diags/ibdiag.conf
91
93 CONFIG FILE
94 /etc/infiniband-diags/ibdiag.conf
95 A global config file is provided to set some of the common options for
97 all tools. See supplied config file for details.
98 NODE NAME MAP FILE FORMAT
100 The node name map is used to specify user friendly names for nodes in
101 the output. GUIDs are used to perform the lookup.
102 This functionality is provided by the opensm-libs package. See
104 opensm(8) for the file location for your installation.
105 Generically:
107 # comment
109 <guid> "<name>"
110 Example:
112 # IB1
114 # Line cards
115 0x0008f104003f125c "IB1 (Rack 11 slot 1 ) ISR9288/ISR9096 Voltaire sLB-24D"
116 0x0008f104003f125d "IB1 (Rack 11 slot 1 ) ISR9288/ISR9096 Voltaire sLB-24D"
117 0x0008f104003f10d2 "IB1 (Rack 11 slot 2 ) ISR9288/ISR9096 Voltaire sLB-24D"
118 0x0008f104003f10d3 "IB1 (Rack 11 slot 2 ) ISR9288/ISR9096 Voltaire sLB-24D"
119 0x0008f104003f10bf "IB1 (Rack 11 slot 12 ) ISR9288/ISR9096 Voltaire sLB-24D"
120 # Spines
122 0x0008f10400400e2d "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB-12D"
123 0x0008f10400400e2e "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB-12D"
124 0x0008f10400400e2f "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB-12D"
125 0x0008f10400400e31 "IB1 (Rack 11 spine 2 ) ISR9288 Voltaire sFB-12D"
126 0x0008f10400400e32 "IB1 (Rack 11 spine 2 ) ISR9288 Voltaire sFB-12D"
127 # GUID Node Name
129 0x0008f10400411a08 "SW1 (Rack 3) ISR9024 Voltaire 9024D"
130 0x0008f10400411a28 "SW2 (Rack 3) ISR9024 Voltaire 9024D"
131 0x0008f10400411a34 "SW3 (Rack 3) ISR9024 Voltaire 9024D"
132 0x0008f104004119d0 "SW4 (Rack 3) ISR9024 Voltaire 9024D"
133 PORTS FILE FORMAT
135 The ports file can be used to specify multiple source and destination
136 pairs. They can be lids or guids. If guids, use the -G option to
137 indicate that.
138 Generically:
140 # comment
142 <src> <dst>
143 Example:
145 73 207
147 203 657
148 531 101
149 > OR <
151 0x0008f104003f125c 0x0008f104003f133d
153 0x0008f1040011ab07 0x0008f104004265c0
154 0x0008f104007c5510 0x0008f1040099bb08
155
157 Unicast examples
158 :: ibtracert 4 16 # show path
160 between lids 4 and 16 ibtracert -n 4 16
161 # same, but using simple output format ibtracert -G
162 0x8f1040396522d 0x002c9000100d051 # use guid addresses
163 Multicast example
165 :: ibtracert -m 0xc000 4 16 # show multicast path of mlid 0xc000
167 between lids 4 and 16
168
170 ibroute (8)
171
173 Hal Rosenstock
174 <hal.rosenstock@gmail.com>
175 Ira Weiny
177 < ira.weiny@intel.com >
178 2018-04-02 IBTRACERT(8)