1 .\" Man page generated from reStructuredText.
3 .TH DUMP_FTS 8 "" "" "OpenIB Diagnostics"
5 DUMP_FTS \- dump InfiniBand forwarding tables
7 .nr rst2man-indent-level 0
11 level \\n[rst2man-indent-level]
12 level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
19 .\" .rstReportMargin pre:
21 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
22 . nr rst2man-indent-level +1
23 .\" .rstReportMargin post:
27 .\" indent \\n[an-margin]
28 .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
29 .nr rst2man-indent-level -1
30 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
31 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
35 dump_fts [options] [<startlid> [<endlid>]]
38 dump_fts is similar to ibroute but dumps tables for every switch found in an
39 ibnetdiscover scan of the subnet.
41 The dump file format is compatible with loading into OpenSM using
42 the \-R file \-U /path/to/dump\-file syntax.
47 show all lids in range, even invalid entries
49 .B \fB\-n, \-\-no_dests\fP
50 do not try to resolve destinations
52 .B \fB\-M, \-\-Multicast\fP
53 show multicast forwarding tables
54 In this case, the range parameters are specifying the mlid range.
56 .SS Port Selection flags
57 .\" Define the common option -C
60 \fB\-C, \-\-Ca <ca_name>\fP use the specified ca_name.
61 .\" Define the common option -P
64 \fB\-P, \-\-Port <ca_port>\fP use the specified ca_port.
65 .\" Explanation of local port selection
67 .SS Local port Selection
69 Multiple port/Multiple CA support: when no IB device or port is specified
70 (see the "local umad parameters" below), the libibumad library
71 selects the port to use by the following criteria:
76 the first port that is ACTIVE.
78 if not found, the first port that is UP (physical link up).
81 If a port and/or CA name is specified, the libibumad library attempts
82 to fulfill the user request, and will fail if it is not possible.
90 ibaddr # use the first port (criteria #1 above)
91 ibaddr \-C mthca1 # pick the best port from "mthca1" only.
92 ibaddr \-P 2 # use the second (active/up) port from the first available IB device.
93 ibaddr \-C mthca0 \-P 2 # use the specified port only.
101 .\" Define the common option -d
106 raise the IB debugging level.
107 May be used several times (\-ddd or \-d \-d \-d).
109 .\" Define the common option -e
114 show send and receive errors (timeouts and others)
116 .\" Define the common option -h
119 \fB\-h, \-\-help\fP show the usage message
120 .\" Define the common option -v
124 .B \fB\-v, \-\-verbose\fP
125 increase the application verbosity level.
126 May be used several times (\-vv or \-v \-v \-v)
128 .\" Define the common option -V
131 \fB\-V, \-\-version\fP show the version info.
132 .SS Configuration flags
133 .\" Define the common option -t
136 \fB\-t, \-\-timeout <timeout_ms>\fP override the default timeout for the solicited mads.
137 .\" Define the common option -y
141 .B \fB\-y, \-\-m_key <key>\fP
142 use the specified M_key for requests. If non\-numeric value (like \(aqx\(aq)
143 is specified then a value will be prompted for.
145 .\" Define the common option --node-name-map
148 \fB\-\-node\-name\-map <node\-name\-map>\fP Specify a node name map.
151 This file maps GUIDs to more user friendly names. See FILES section.
154 .\" Define the common option -z
157 \fB\-\-config, \-z <config_file>\fP Specify alternate config file.
160 Default: /etc/infiniband-diags/ibdiag.conf
164 .\" Common text for the config file
168 /etc/infiniband-diags/ibdiag.conf
170 A global config file is provided to set some of the common options for all
171 tools. See supplied config file for details.
172 .\" Common text to describe the node name map file.
174 .SS NODE NAME MAP FILE FORMAT
176 The node name map is used to specify user friendly names for nodes in the
177 output. GUIDs are used to perform the lookup.
179 This functionality is provided by the opensm\-libs package. See \fBopensm(8)\fP
180 for the file location for your installation.
203 0x0008f104003f125c "IB1 (Rack 11 slot 1 ) ISR9288/ISR9096 Voltaire sLB\-24D"
204 0x0008f104003f125d "IB1 (Rack 11 slot 1 ) ISR9288/ISR9096 Voltaire sLB\-24D"
205 0x0008f104003f10d2 "IB1 (Rack 11 slot 2 ) ISR9288/ISR9096 Voltaire sLB\-24D"
206 0x0008f104003f10d3 "IB1 (Rack 11 slot 2 ) ISR9288/ISR9096 Voltaire sLB\-24D"
207 0x0008f104003f10bf "IB1 (Rack 11 slot 12 ) ISR9288/ISR9096 Voltaire sLB\-24D"
210 0x0008f10400400e2d "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D"
211 0x0008f10400400e2e "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D"
212 0x0008f10400400e2f "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D"
213 0x0008f10400400e31 "IB1 (Rack 11 spine 2 ) ISR9288 Voltaire sFB\-12D"
214 0x0008f10400400e32 "IB1 (Rack 11 spine 2 ) ISR9288 Voltaire sFB\-12D"
217 0x0008f10400411a08 "SW1 (Rack 3) ISR9024 Voltaire 9024D"
218 0x0008f10400411a28 "SW2 (Rack 3) ISR9024 Voltaire 9024D"
219 0x0008f10400411a34 "SW3 (Rack 3) ISR9024 Voltaire 9024D"
220 0x0008f104004119d0 "SW4 (Rack 3) ISR9024 Voltaire 9024D"
227 \fBdump_lfts(8), dump_mfts(8), ibroute(8), ibswitches(8), opensm(8)\fP
232 < \fI\%ira.weiny@intel.com\fP >
234 .\" Generated by docutils manpage writer.