4 user space applications (also library support)
5 two categories: host and network
7 Host Oriented Diagnostic Tools
12 ibstatus displays basic information obtained from the local IB driver.
13 -v enables verbose mode. Normal output includes LID, SMLID, port state,
14 link width active, and port physical state. Verbose includes all sysfs
15 supported parameters for that interface and port.
18 ibstatus [-v] [-I mthca0] [-p port]
21 sysfs support in mthca
26 ibroute uses SMPs to display the forwarding tables (unicast
27 (LinearForwardingTable or LFT) or multicast (MulticastForwardingTable or MFT))
28 for the specified LID.
31 ibroute [-multi] [-m mkey] [-pa path] [-I mthca0] [-p port] LID
39 ibtracert uses SMPs to trace the path from a source GID/LID to a
40 destination GID/LID. The source GID/LID must be local to the node.
41 Each hop along the path is displayed until the destination is reached or
42 a hop does not respond. By using -mg and/or -ml options, multicast path
43 tracing can be performed between source and destination nodes.
46 ibtracert [-m mkey] [-pa path] [-sg SGID] [-sl SLID] [-dg DGID] [-dl DLID] \
47 [-mg MGID] [-ml MLID] [-I mthca0] [-p port]
55 smpquery allows a basic subset of standard SMP queries including the following:
56 local information (LID, GID, etc.), node information (from NodeDescription,
57 NodeInfo, and possibly SwitchInfo if node is a switch), port information
58 (port address and state), and port parameters (SLtoVLMappingTable,
59 VLArbitrationTable, HOQLife, ...).
62 smpquery [-m mkey] [-l LID] [-pa path] [-I mthca0] [-p port] \
71 smpdump is a general purpose SMP utility which gets SM attributes from a
72 specified SMA. The result is dumped as hex (-x) or string (-s), with hex
76 smpdump [-m mkey] [-l LID] [-p path] [-I mthca0] [-p port] \
77 [-a attributeID] [-am attributeModifier] [-s] [-x]
80 User MAD access, MAD snooping support
85 perfquery uses PerfMgt GMPs to obtain the PortCounters (basic performance
86 and error counters) from the PMA at the node specified. -r resets these
87 counters after obtaining them.
90 perfquery [-I mthca0] [-p port] [-r] [-g GID] LID
98 ibping uses UD transport to validate connectivity between IB nodes.
99 It is run as client/server (daemon). -v option uses vendor MADs rather than
103 ibping [-d] [-v] [-c count] [-i interval] [-s packetsize] \
104 [-I mthca0] [-p port] [-q qkey] [-g DGID] [-qp dqp] [-dl DLID]
106 -d: run as daemon (server)
112 Network Oriented Diagnostics
117 ibnetdiscover performs IB subnet discovery and outputs a human readable
118 topology file. GUIDs, node types, and port numbers are displayed
119 as well as port LIDs and NodeDescriptions. All nodes (and links) are displayed
123 ibnetdiscover [-I mthca0] [-p port] [-o topology-filename]
128 Future versions of this file will be annotated with additional information
129 including system guid, system type, internal to physical mapping, and physical
130 location information (blade or ASIC number, etc.).
135 ibhosts either walks the IB subnet topology or uses an already saved topology
136 file and extracts the HCA nodes.
139 ibhosts [-I mthca0] [-p port] [-i topology-filename] [-o ibhosts-filename]
142 user MAD access, ibnetdiscover
147 ibswitches either walks the IB subnet topology or uses an already saved
148 topology file and extracts the IB switches.
151 ibswitches [-I mthca0] [-p port] \
152 [-i topology-filename] [-o ibswitches-filename]
155 user MAD access, ibnetdiscover
160 ibnetverify uses a full topology file that was created by ibnetdiscover,
161 scans the network to see if the current topology matches or not displaying
162 any discrepancies, and validates the connectivity and reports errors
163 (from port counters).
166 ibnetverify -f filename [-I mthca0] [-p port]
169 user MAD access, ibnetdiscover