1DUMP_FTS(8)                   OpenIB Diagnostics                   DUMP_FTS(8)
2
3
4

NAME

6       DUMP_FTS - dump InfiniBand forwarding tables
7

SYNOPSIS

9       dump_fts [options] [<startlid> [<endlid>]]
10

DESCRIPTION

12       dump_fts  is similar to ibroute but dumps tables for every switch found
13       in an ibnetdiscover scan of the subnet.
14
15       The dump file format is compatible with loading into OpenSM  using  the
16       -R file -U /path/to/dump-file syntax.
17

OPTIONS

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

FILES

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

SEE ALSO

126       dump_lfts(8), dump_mfts(8), ibroute(8), ibswitches(8), opensm(8)
127

AUTHORS

129       Ira Weiny
130              < ira.weiny@intel.com >
131
132
133
134
135                                  2013-03-26                       DUMP_FTS(8)