1 .TH IBROUTE 8 "July 25, 2006" "OpenIB" "OpenIB Diagnostics"
4 ibroute \- query InfiniBand switch forwarding tables
8 [\-d(ebug)] [-a(ll)] [-n(o_dests)] [-v(erbose)] [\-D(irect)] [\-G(uid)] [-M(ulticast)] [-s smlid] [\-C ca_name] [\-P ca_port] [\-t(imeout) timeout_ms] [\-V(ersion)] [\-h(elp)] [<dest dr_path|lid|guid> [<startlid> [<endlid>]]]
12 ibroute uses SMPs to display the forwarding tables (unicast
13 (LinearForwardingTable or LFT) or multicast (MulticastForwardingTable or MFT))
14 for the specified switch LID and the optional lid (mlid) range.
15 The default range is all valid entries in the range 1...FDBTop.
21 \fB\-a\fR, \fB\-\-all\fR
22 show all lids in range, even invalid entries
24 \fB\-n\fR, \fB\-\-no_dests\fR
25 do not try to resolve destinations
27 \fB\-M\fR, \fB\-\-Multicast\fR
28 show multicast forwarding tables
29 In this case, the range parameters are specifying the mlid range.
33 Most OpenIB diagnostics take the following common flags. The exact list of
34 supported flags per utility can be found in the usage message and can be shown
35 using the util_name -h syntax.
39 \-d raise the IB debugging level.
40 May be used several times (-ddd or -d -d -d).
42 \-e show send and receive errors (timeouts and others)
44 \-h show the usage message
46 \-v increase the application verbosity level.
47 May be used several times (-vv or -v -v -v)
49 \-V show the version info.
53 \-D use directed path address arguments. The path
54 is a comma separated list of out ports.
57 "0,1,2,1,4" # out via port 1, then 2, ...
59 \-G use GUID address argument. In most cases, it is the Port GUID.
63 \-s <smlid> use 'smlid' as the target lid for SM/SA queries.
67 \-C <ca_name> use the specified ca_name.
69 \-P <ca_port> use the specified ca_port.
71 \-t <timeout_ms> override the default timeout for the solicited mads.
73 Multiple CA/Multiple Port Support
75 When no IB device or port is specified, the port to use is selected
76 by the following criteria:
78 1. the first port that is ACTIVE.
80 2. if not found, the first port that is UP (physical link up).
82 If a port and/or CA name is specified, the user request is
83 attempted to be fulfilled, and will fail if it is not possible.
90 ibroute 4 # dump all lids with valid out ports of switch with lid 4
92 ibroute -a 4 # same, but dump all lids, even with invalid out ports
94 ibroute -n 4 # simple dump format - no destination resolution
96 ibroute 4 10 # dump lids starting from 10 (up to FDBTop)
98 ibroute 4 0x10 0x20 # dump lid range
100 ibroute -G 0x08f1040023 # resolve switch by GUID
102 ibroute -D 0,1 # resolve switch by direct path
107 ibroute -M 4 # dump all non empty mlids of switch with lid 4
109 ibroute -M 4 0xc010 0xc020 # same, but with range
111 ibroute -M -n 4 # simple dump format
119 .RI < halr@voltaire.com >