ibtracert(8)

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

NAME

6       IBTRACERT -
7

TRACE INFINIBAND PATH

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