1IBTRACERT(8)                  Open IB Diagnostics                 IBTRACERT(8)
2
3
4

NAME

6       ibtracert - trace InfiniBand path
7

SYNOPSIS

9       ibtracert [options] [<lid|guid> [<startlid> [<endlid>]]]
10

DESCRIPTION

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

OPTIONS

19       -n, --no_info
20              simple format; don't show additional information
21
22       -m     show the multicast trace of the specified mlid
23
24       -f, --force
25              force route to destination port
26
27   Addressing Flags
28       -G, --Guid     The address specified is a Port GUID
29
30       -L, --Lid   The address specified is a LID
31
32       -s, --sm_port <smlid>     use 'smlid' as the target lid for SA queries.
33
34       --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
38   Port Selection flags
39       -C, --Ca <ca_name>    use the specified ca_name.
40
41       -P, --Port <ca_port>    use the specified ca_port.
42
43   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
48          1. the first port that is ACTIVE.
49
50          2. if not found, the first port that is UP (physical link up).
51
52          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
56          For example:
57
58              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
63   Debugging flags
64       -d     raise the IB debugging level.  May be used several  times  (-ddd
65              or -d -d -d).
66
67       -e     show send and receive errors (timeouts and others)
68
69       -h, --help      show the usage message
70
71       -v, --verbose
72              increase  the  application verbosity level.  May be used several
73              times (-vv or -v -v -v)
74
75       -V, --version     show the version info.
76
77   Configuration flags
78       -t,  --timeout  <timeout_ms>  override  the  default  timeout  for  the
79       solicited mads.
80
81       --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
85       -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
89       --config, -z  <config_file> Specify alternate config file.
90          Default: /etc/infiniband-diags/ibdiag.conf
91

FILES

93   CONFIG FILE
94       /etc/infiniband-diags/ibdiag.conf
95
96       A  global config file is provided to set some of the common options for
97       all tools.  See supplied config file for details.
98
99   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
103       This  functionality  is  provided  by  the  opensm-libs  package.   See
104       opensm(8) for the file location for your installation.
105
106       Generically:
107
108          # comment
109          <guid> "<name>"
110
111       Example:
112
113          # 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
121          # 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
128          # 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
134   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
139       Generically:
140
141          # comment
142          <src> <dst>
143
144       Example:
145
146          73 207
147          203 657
148          531 101
149
150          > OR <
151
152          0x0008f104003f125c 0x0008f104003f133d
153          0x0008f1040011ab07 0x0008f104004265c0
154          0x0008f104007c5510 0x0008f1040099bb08
155

EXAMPLES

157       Unicast examples
158
159       ::     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
164       Multicast example
165
166       ::     ibtracert -m 0xc000 4 16    # show multicast path of mlid 0xc000
167              between lids 4 and 16
168

SEE ALSO

170       ibroute (8)
171

AUTHOR

173       Hal Rosenstock
174              <hal.rosenstock@gmail.com>
175
176       Ira Weiny
177              < ira.weiny@intel.com >
178
179
180
181
182                                  2018-04-02                      IBTRACERT(8)
Impressum