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