1Diagnostic Tools
211/29/04
3
4user space applications (also library support)
5two categories: host and network
6
7Host Oriented Diagnostic Tools
8
91. ibstatus
10
11Description:
12ibstatus displays basic information obtained from the local IB driver.
13-v enables verbose mode. Normal output includes LID, SMLID, port state,
14link width active, and port physical state. Verbose includes all sysfs
15supported parameters for that interface and port.
16
17Syntax:
18ibstatus [-v] [-I mthca0] [-p port]
19
20Dependencies:
21sysfs support in mthca
22
232. ibroute
24
25Description:
26ibroute uses SMPs to display the forwarding tables (unicast
27(LinearForwardingTable or LFT) or multicast (MulticastForwardingTable or MFT))
28for the specified LID.
29
30Syntax:
31ibroute [-multi] [-m mkey] [-pa path] [-I mthca0] [-p port] LID
32
33Dependencies:
34user MAD access, SMA
35
363. ibtracert
37
38Description:
39ibtracert uses SMPs to trace the path from a source GID/LID to a
40destination GID/LID. The source GID/LID must be local to the node.
41Each hop along the path is displayed until the destination is reached or
42a hop does not respond. By using -mg and/or -ml options, multicast path
43tracing can be performed between source and destination nodes.
44
45Syntax:
46ibtracert [-m mkey] [-pa path] [-sg SGID] [-sl SLID] [-dg DGID] [-dl DLID] \
47		[-mg MGID] [-ml MLID] [-I mthca0] [-p port]
48
49Dependencies:
50user MAD access, SMA
51
524. smpquery
53
54Description:
55smpquery allows a basic subset of standard SMP queries including the following:
56local information (LID, GID, etc.), node information (from NodeDescription,
57NodeInfo, and possibly SwitchInfo if node is a switch), port information
58(port address and state), and port parameters (SLtoVLMappingTable,
59VLArbitrationTable, HOQLife, ...).
60
61Syntax:
62smpquery [-m mkey] [-l LID] [-pa path] [-I mthca0] [-p port] \
63	 	[-l] [-n] [-pi] [-pp]
64
65Dependencies:
66User MAD access
67
685. smpdump
69
70Description:
71smpdump is a general purpose SMP utility which gets SM attributes from a
72specified SMA. The result is dumped as hex (-x) or string (-s), with hex
73as the default.
74
75Syntax:
76smpdump [-m mkey] [-l LID] [-p path]  [-I mthca0] [-p port] \
77		[-a attributeID] [-am attributeModifier] [-s] [-x]
78
79Dependencies:
80User MAD access, MAD snooping support
81
826. perfquery
83
84Description:
85perfquery uses PerfMgt GMPs to obtain the PortCounters (basic performance
86and error counters) from the PMA at the node specified. -r resets these
87counters after obtaining them.
88
89Syntax:
90perfquery [-I mthca0] [-p port] [-r] [-g GID] LID
91
92Dependencies:
93User MAD access, PMA
94
957. ibping
96
97Description:
98ibping uses UD transport to validate connectivity between IB nodes.
99It is run as client/server (daemon). -v option uses vendor MADs rather than
100normal UD transport.
101
102Syntax:
103ibping [-d] [-v] [-c count] [-i interval] [-s packetsize] \
104		[-I mthca0] [-p port] [-q qkey] [-g DGID] [-qp dqp] [-dl DLID]
105
106-d: run as daemon (server)
107
108Dependencies:
109user MAD access
110
111
112Network Oriented Diagnostics
113
1148. ibnetdiscover
115
116Description:
117ibnetdiscover performs IB subnet discovery and outputs a human readable
118topology file. GUIDs, node types, and port numbers are displayed
119as well as port LIDs and NodeDescriptions. All nodes (and links) are displayed
120(full topology).
121
122Syntax:
123ibnetdiscover [-I mthca0] [-p port] [-o topology-filename]
124
125Dependencies:
126user MAD access
127
128Future versions of this file will be annotated with additional information
129including system guid, system type, internal to physical mapping, and physical
130location information (blade or ASIC number, etc.).
131
1329. ibhosts
133
134Description:
135ibhosts either walks the IB subnet topology or uses an already saved topology
136file and extracts the HCA nodes.
137
138Syntax:
139ibhosts [-I mthca0] [-p port] [-i topology-filename] [-o ibhosts-filename]
140
141Dependencies:
142user MAD access, ibnetdiscover
143
14410. ibswitches
145
146Description:
147ibswitches either walks the IB subnet topology or uses an already saved
148topology file and extracts the IB switches.
149
150Syntax:
151ibswitches [-I mthca0] [-p port] \
152		[-i topology-filename] [-o ibswitches-filename]
153
154Dependencies:
155user MAD access, ibnetdiscover
156
15711. ibnetverify
158
159Description:
160ibnetverify uses a full topology file that was created by ibnetdiscover,
161scans the network to see if the current topology matches or not displaying
162any discrepancies, and validates the connectivity and reports errors
163(from port counters).
164
165Syntax:
166ibnetverify -f filename [-I mthca0] [-p port]
167
168Dependencies:
169user MAD access, ibnetdiscover
170