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

NAME

6       ibroute - query InfiniBand switch forwarding tables
7

SYNOPSIS

9       ibroute [options] [<dest dr_path|lid|guid> [<startlid> [<endlid>]]]
10

DESCRIPTION

12       ibroute uses SMPs to display the forwarding tables (unicast (LinearFor‐
13       wardingTable or LFT) or multicast  (MulticastForwardingTable  or  MFT))
14       for  the  specified  switch LID and the optional lid (mlid) range.  The
15       default range is all valid entries in the range 1...FDBTop.
16

OPTIONS

18       -a, --all
19              show all lids in range, even invalid entries
20
21       -n, --no_dests
22              do not try to resolve destinations
23
24       -M, --Multicast
25              show multicast forwarding tables In this case, the range parame‐
26              ters are specifying the mlid range.
27
28   Addressing Flags
29       -D, --Direct     The address specified is a directed route
30
31          Examples:
32             [options] -D [options] "0"          # self port
33             [options] -D [options] "0,1,2,1,4"  # out via port 1, then 2, ...
34
35             (Note the second number in the path specified must match the port being
36             used.  This can be specified using the port selection flag '-P' or the
37             port found through the automatic selection process.)
38
39       -G, --Guid     The address specified is a Port GUID
40
41       -L, --Lid   The address specified is a LID
42
43       -s, --sm_port <smlid>     use 'smlid' as the target lid for SA queries.
44
45   Port Selection flags
46       -C, --Ca <ca_name>    use the specified ca_name.
47
48       -P, --Port <ca_port>    use the specified ca_port.
49
50   Local port Selection
51       Multiple  port/Multiple CA support: when no IB device or port is speci‐
52       fied (see the "local umad parameters" below), the libibumad library se‐
53       lects the port to use by the following criteria:
54
55          1. the first port that is ACTIVE.
56
57          2. if not found, the first port that is UP (physical link up).
58
59          If  a  port  and/or  CA name is specified, the libibumad library at‐
60          tempts to fulfill the user request, and will fail if it is not  pos‐
61          sible.
62
63          For example:
64
65              ibaddr                 # use the first port (criteria #1 above)
66              ibaddr -C mthca1       # pick the best port from "mthca1" only.
67              ibaddr -P 2            # use the second (active/up) port from the first available IB device.
68              ibaddr -C mthca0 -P 2  # use the specified port only.
69
70   Debugging flags
71       -d     raise  the  IB debugging level.  May be used several times (-ddd
72              or -d -d -d).
73
74       -e     show send and receive errors (timeouts and others)
75
76       -h, --help      show the usage message
77
78       -v, --verbose
79              increase the application verbosity level.  May be  used  several
80              times (-vv or -v -v -v)
81
82       -V, --version     show the version info.
83
84   Configuration flags
85       -t,  --timeout  <timeout_ms>  override  the default timeout for the so‐
86       licited mads.
87
88       -y, --m_key <key>
89              use the specified M_key for requests. If non-numeric value (like
90              'x') is specified then a value will be prompted for.
91
92       --node-name-map <node-name-map> Specify a node name map.
93          This  file  maps  GUIDs to more user friendly names.  See FILES sec‐
94          tion.
95
96       --config, -z  <config_file> Specify alternate config file.
97          Default: /etc/infiniband-diags/ibdiag.conf
98

FILES

100   CONFIG FILE
101       /etc/infiniband-diags/ibdiag.conf
102
103       A global config file is provided to set some of the common options  for
104       all tools.  See supplied config file for details.
105
106   NODE NAME MAP FILE FORMAT
107       The  node  name map is used to specify user friendly names for nodes in
108       the output.  GUIDs are used to perform the lookup.
109
110       This  functionality  is  provided  by  the  opensm-libs  package.   See
111       opensm(8) for the file location for your installation.
112
113       Generically:
114
115          # comment
116          <guid> "<name>"
117
118       Example:
119
120          # IB1
121          # Line cards
122          0x0008f104003f125c "IB1 (Rack 11 slot 1   ) ISR9288/ISR9096 Voltaire sLB-24D"
123          0x0008f104003f125d "IB1 (Rack 11 slot 1   ) ISR9288/ISR9096 Voltaire sLB-24D"
124          0x0008f104003f10d2 "IB1 (Rack 11 slot 2   ) ISR9288/ISR9096 Voltaire sLB-24D"
125          0x0008f104003f10d3 "IB1 (Rack 11 slot 2   ) ISR9288/ISR9096 Voltaire sLB-24D"
126          0x0008f104003f10bf "IB1 (Rack 11 slot 12  ) ISR9288/ISR9096 Voltaire sLB-24D"
127
128          # Spines
129          0x0008f10400400e2d "IB1 (Rack 11 spine 1   ) ISR9288 Voltaire sFB-12D"
130          0x0008f10400400e2e "IB1 (Rack 11 spine 1   ) ISR9288 Voltaire sFB-12D"
131          0x0008f10400400e2f "IB1 (Rack 11 spine 1   ) ISR9288 Voltaire sFB-12D"
132          0x0008f10400400e31 "IB1 (Rack 11 spine 2   ) ISR9288 Voltaire sFB-12D"
133          0x0008f10400400e32 "IB1 (Rack 11 spine 2   ) ISR9288 Voltaire sFB-12D"
134
135          # GUID   Node Name
136          0x0008f10400411a08 "SW1  (Rack  3) ISR9024 Voltaire 9024D"
137          0x0008f10400411a28 "SW2  (Rack  3) ISR9024 Voltaire 9024D"
138          0x0008f10400411a34 "SW3  (Rack  3) ISR9024 Voltaire 9024D"
139          0x0008f104004119d0 "SW4  (Rack  3) ISR9024 Voltaire 9024D"
140

EXAMPLES

142       Unicast examples
143
144       ::     ibroute  4               # dump all lids with valid out ports of
145              switch with lid 4 ibroute -a 4            # same, but  dump  all
146              lids, even with invalid out ports ibroute -n 4            # sim‐
147              ple dump  format  -  no  destination  resolution  ibroute  4  10
148              #  dump lids starting from 10 (up to FDBTop) ibroute 4 0x10 0x20
149              # dump lid range ibroute -G 0x08f1040023  #  resolve  switch  by
150              GUID ibroute -D 0,1          # resolve switch by direct path
151
152       Multicast examples
153
154       ::     ibroute -M 4                # dump all non empty mlids of switch
155              with lid 4 ibroute -M 4 0xc010 0xc020  # same,  but  with  range
156              ibroute -M -n 4             # simple dump format
157

SEE ALSO

159       ibtracert (8)
160

AUTHOR

162       Hal Rosenstock
163              < halr@voltaire.com >
164
165
166
167
168                                  2017-08-21                        IBROUTE(8)
Impressum