[DOCS] trunk\docs\Manual.htm
authorstansmith <stansmith@ad392aa1-c5ef-ae45-8dd8-e69d62a5ef86>
Wed, 10 Jun 2009 17:11:17 +0000 (17:11 +0000)
committerstansmith <stansmith@ad392aa1-c5ef-ae45-8dd8-e69d62a5ef86>
Wed, 10 Jun 2009 17:11:17 +0000 (17:11 +0000)
Document new winof dapl providers: socket-cm & rdma-cm
Explain dat.conf dapl provider device specification.
Incorporate BLOCKQUOTES so selected links appear at the top of the window
Document OFED Diagnostic tools - OFED man pages reworked.
Clarify Winverbs transition from technology preview to standard WinOF/IBcore component.

git-svn-id: svn://openib.tc.cornell.edu/gen1/trunk@2242 ad392aa1-c5ef-ae45-8dd8-e69d62a5ef86

docs/Manual.htm

index b01b505..fbeca2b 100644 (file)
@@ -15,7 +15,7 @@ div.Section1
 <h1 align="center">User's Manual</h1>\r
 <h2 align="center">Release 2.1</h2>\r
 <h3 align="center">\r
-<!--webbot bot="Timestamp" S-Type="EDITED" S-Format="%m/%d/%Y" startspan -->03/17/2009<!--webbot bot="Timestamp" endspan i-checksum="12620" --></h3>\r
+<!--webbot bot="Timestamp" S-Type="EDITED" S-Format="%m/%d/%Y" startspan -->06/10/2009<!--webbot bot="Timestamp" endspan i-checksum="12514" --></h3>\r
 <h2 align="left"><u>Overview</u></h2>\r
 <p align="left"><span style="FONT-SIZE: 12pt; FONT-FAMILY: 'Times New Roman'">\r
 The Windows OpenFabrics (WinOF) package is composed of software modules intended \r
@@ -42,7 +42,7 @@ style='background-position: 0% 0%; mso-highlight:yellow; background-image:none;
 <li>\r
 <p align="left">Infiniband Core modules: IB verbs and IB access layer</li>\r
 <li>\r
-<p align="left">Upper Layer Protocols: IPoIB, WSD, Network Direct, VNIC, SRP Initiator and uDAPL</li>\r
+<p align="left">Upper Layer Protocols: IPoIB, WSD, NetworkDirect, VNIC, SRP Initiator and uDAPL</li>\r
 </ul>\r
 <p align="left">OpenFabrics utilities:</p>\r
 <ul>\r
@@ -64,7 +64,7 @@ style='background-position: 0% 0%; mso-highlight:yellow; background-image:none;
 <h2 align="left"><u><a name="TOP"></a>WinOF Features</u></h2>\r
 <ul>\r
        <li>\r
-       <h3 align="left"><a href="#Tools">Tools</a></h3></li>\r
+       <h3 align="left"><a href="#Tools">Tools &amp; Diagnostics</a></h3></li>\r
 </ul>\r
 <ul>\r
        <li>\r
@@ -74,7 +74,7 @@ style='background-position: 0% 0%; mso-highlight:yellow; background-image:none;
        <h3 align="left"><a href="#winsockdirect">Winsock Direct Service Provider</a></h3>\r
        </li>\r
        <li>\r
-       <h3 align="left"><a href="#Network_Direct_Service_Provider">Network Direct \r
+       <h3 align="left"><a href="#Network_Direct_Service_Provider">NetworkDirect \r
        Service Provider</a></h3>\r
        </li>\r
        <li>\r
@@ -102,6 +102,7 @@ style='background-position: 0% 0%; mso-highlight:yellow; background-image:none;
 <h3 align="left">&nbsp;</h3>\r
 <p align="left">&nbsp;</p>\r
 <p align="left">&nbsp;</p>\r
+<BLOCKQUOTE></BLOCKQUOTE>\r
 <h2 align="left"><a name="verbs_benchmarks0"></a><a name="Tools">Tools</a></h2>\r
 <hr>\r
 <blockquote>\r
@@ -136,7 +137,7 @@ style='background-position: 0% 0%; mso-highlight:yellow; background-image:none;
                        <p align="left"><a href="#qlgcvnicconfig">qlgcvnic_config</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Configuration \r
                        utility used to configure IB Stack to create VNIC child devices as per user's requirement.</li>\r
                </ul>\r
-               <h4 align="left"><a href="#verbs_benchmarks">Performance</a></h4>\r
+               <h4 align="left"><a href="#verbs_benchmarks"><font color="#000000">Performance</font></a></h4>\r
                <ul>\r
                        <li>\r
                        <p align="left"><a href="#ibsend_lat">ib_send_lat</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Infiniband send \r
@@ -154,24 +155,71 @@ measurement</li>
                        <p align="left"><a href="#ttcp">ttcp</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; \r
 TCP performance measurements</li>\r
                </ul>\r
-               <h4 align="left"><a href="#diags">Diagnostics</a></h4>\r
+               <h4 align="left"><a href="#diags"><font color="#000000">Diagnostics</font></a></h4>\r
                <ul>\r
                        <li>\r
-                       <p align="left"><a href="#ibstat">ibstat</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; \r
-                       Display HCA stats.</li>\r
+                       <p align="left"><a href="#cmtest">cmtest&nbsp;</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Connection Manager tests</li>\r
                        <li>\r
-                       <p align="left"><a href="#ibv_devinfo">ibv_devinfo</a>&nbsp;&nbsp; \r
-                       Display HCA device information.</li>\r
+                       <p align="left"><a href="#iblimits">ib_limits</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; \r
+       InfiniBand verb tests</li>\r
+                       <li>\r
+                       <p align="left"><a href="#printip">printIP</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Display \r
+an Internet Protocol address associated with an IB GUID.</li>\r
                        <li>\r
                        <p align="left"><a href="#vstat">vstat</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Display HCA attributes (lids), statistics and error counters.</li>\r
+               </ul>\r
+               <h4 align="left"><u><font color="#0000FF"><a href="#diags">\r
+               <font color="#000000">OFED </font> </a> </font></u>\r
+               <a href="#diags"><font color="#000000">Diagnostics</font></a></h4>\r
+               <ul>\r
                        <li>\r
-                       <p align="left"><a href="#iblimits">ib_limits</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; \r
-       Infiniband verb tests</li>\r
+                       <p align="left"><a href="#IBADDR">ibaddr</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; \r
+                       Query InfiniBand address(es)</li>\r
                        <li>\r
-                       <p align="left"><a href="#cmtest">cmtest&nbsp;</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Connection Manager tests</li>\r
+                       <p align="left"><a href="#IBLINKINFO">iblinkinfo</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; \r
+                       Report link info for all links in the fabric</li>\r
                        <li>\r
-                       <p align="left"><a href="#printip">PrintIP</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Display \r
-an Internet Protocol address associated with an IB GUID.</li>\r
+                       <p align="left"><a href="#IBNETDISCOVER">ibnetdiscover&nbsp;</a>&nbsp;&nbsp; Generate a fabric \r
+                       topology.</li>\r
+                       <li>\r
+                       <p align="left"><a href="#IBPING">ibping</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; \r
+                       Ping an InfiniBand address</li>\r
+                       <li>\r
+                       <p align="left"><a href="#IBPORTSTATE">ibportstate</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; \r
+                       Display InfiniBand port specific information.</li>\r
+                       <li>\r
+                       <p align="left"><a href="#IBQUERYERRORS">ibqueryerrors</a>&nbsp;&nbsp;&nbsp; Query and report \r
+                       non-zero IB port counters</li>\r
+                       <li>\r
+                       <p align="left"><a href="#IBROUTE">ibroute</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; \r
+                       Query InfiniBand switch forwarding tables</li>\r
+                       <li>\r
+                       <p align="left"><a href="#ibstat">ibstat</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Display HCA stats.</li>\r
+                       <li>\r
+                       <p align="left"><a href="#IBSYSSTAT">ibsysstat</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; \r
+                       System status for an InfiniBand address</li>\r
+                       <li>\r
+                       <p align="left"><a href="#IBTRACERT">ibtracert</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; \r
+                       Trace InfiniBand path</li>\r
+                       <li>\r
+                       <p align="left"><a href="#ibv_devinfo">ibv_devinfo</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; \r
+                       Display HCA device information.</li>\r
+                       <li>\r
+                       <p align="left"><a href="#PERFQUERY">perfquery </a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; \r
+                       Query InfiniBand performance counters</li>\r
+                       <li>\r
+                       <p align="left"><a href="#SAQUERY">saquery</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; SA (Subnet Administrator) query test</li>\r
+                       <li>\r
+                       <p align="left"><a href="#SMINFO">sminfo</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; \r
+                       Query InfiniBand SMInfo attributes</li>\r
+                       <li>\r
+                       <p align="left"><a href="#SMPDUMP">smpdump</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; \r
+                       Dump InfiniBand subnet management attributes</li>\r
+                       <li>\r
+                       <p align="left"><a href="#SMPQUERY">smpquery</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; \r
+                       Query InfiniBand subnet management attributes</li>\r
+                       <li>\r
+                       <p align="left"><a href="#VENDSTAT">vendstat&nbsp;</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Query InfiniBand vendor specific functions</li>\r
                </ul>\r
        </blockquote>\r
 </blockquote>\r
@@ -192,6 +240,7 @@ tuning and/or functional testing.</p>
        <br>larger samples only marginally help. The default (1000) is pretty good.<br>Note that an array of cycles_t (typically unsigned long) is allocated<br>once to collect samples and again to store the difference between them.<br>Really big sample sizes (e.g. 1 million) might expose other problems<br>with the program.<br>\r
        <br>&quot;-H&quot; option will dump the histogram for additional statistical analysis.<br>See xgraph, ygraph, r-base (http://www.r-project.org/), pspp, or other\r
        <br>statistical math programs.<br><br>Architectures tested: x86, x86_64, ia64</p>\r
+       <p align="left">Also see <a href="#WinVerbs">winverbs</a> performance tools.</p>\r
 </blockquote>\r
 <h4 align="left"><a name="ibsend_lat"></a><br>\r
 ib_send_lat.exe&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; - latency test with \r
@@ -347,39 +396,1820 @@ Options specific to -r:
 <h4 align="left"><a href="#TOP"><font color="#000000">&lt;return-to-top&gt;</font></a></h4>\r
 <p align="left">&nbsp;</p>\r
 <p align="left">&nbsp;</p>\r
-<h2 align="left"><a name="diags"></a>Diagnostics</h2>\r
-<hr>\r
-<h3 align="left"><a name="ibv_devinfo"></a><br>\r
-ibv_devinfo - print CA (Channel Adapter) attributes</h3>\r
-<p align="left">usage: ibv_devinfo&nbsp; [options]<br>\r
+<h2 align="left"><a name="diags"></a>Diagnostics</h2>\r
+<hr>\r
+<BLOCKQUOTE></BLOCKQUOTE>\r
+<h3 align="left"><a name="IBADDR">IBADDR</a>(8) OFED Diagnostics</h3>\r
+<p align="left">NAME<br>\r
+ibaddr - query InfiniBand address(es)<br>\r
+<br>\r
+SYNOPSIS<br>\r
+ibaddr [-d(ebug)] [-D(irect)] [-G(uid)] [-l(id_show)] [-g(id_show)] [-C\r
+ca_name] [-P ca_port] [-t(imeout) timeout_ms] [-V(ersion)] [-h(elp)]\r
+[&lt;lid | dr_path | guid&gt;]<br>\r
+<br>\r
+DESCRIPTION<br>\r
+Display the lid (and range) as well as the GID address of the port<br>\r
+specified (by DR path, lid, or GUID) or the local port by default.<br>\r
+<br>\r
+Note: this utility can be used as simple address resolver.<br>\r
+<br>\r
+OPTIONS<br>\r
+-G, --Guid<br>\r
+show lid range and gid for GUID address<br>\r
+<br>\r
+-l, --lid_show<br>\r
+show lid range only<br>\r
+<br>\r
+-L, --Lid_show<br>\r
+show lid range (in decimal) only<br>\r
+<br>\r
+-g, --gid_show<br>\r
+show gid address only<br>\r
+<br>\r
+<br>\r
+COMMON OPTIONS<br>\r
+Most WinOF diagnostics take the following common flags. The exact list<br>\r
+of supported flags per utility can be found in the usage message and<br>\r
+can be shown using the util_name -h syntax.<br>\r
+<br>\r
+# Debugging flags<br>\r
+<br>\r
+-d raise the IB debugging level.<br>\r
+May be used several times (-ddd or -d -d -d).<br>\r
+<br>\r
+-e show send and receive errors (timeouts and others)<br>\r
+<br>\r
+-h show the usage message<br>\r
+<br>\r
+-v increase the application verbosity level.<br>\r
+May be used several times (-vv or -v -v -v)<br>\r
+<br>\r
+-V show the version info.<br>\r
+<br>\r
+# Addressing flags<br>\r
+<br>\r
+-D use directed path address arguments. The path<br>\r
+is a comma separated list of out ports.<br>\r
+Examples:<br>\r
+&quot;0&quot; # self port<br>\r
+&quot;0,1,2,1,4&quot; # out via port 1, then 2, ...<br>\r
+<br>\r
+-G use GUID address argument. In most cases, it is the Port GUID.<br>\r
+Example:<br>\r
+&quot;0x08f1040023&quot;<br>\r
+<br>\r
+-s &lt;smlid&gt; use \92smlid\92 as the target lid for SM/SA queries.<br>\r
+<br>\r
+# Other common flags:<br>\r
+<br>\r
+-C &lt;ca_name&gt; use the specified ca_name.<br>\r
+<br>\r
+-P &lt;ca_port&gt; use the specified ca_port.<br>\r
+<br>\r
+-t &lt;timeout_ms&gt; override the default timeout for the solicited mads.<br>\r
+<br>\r
+Multiple CA/Multiple Port Support<br>\r
+<br>\r
+When no IB device or port is specified, the port to use is selected by<br>\r
+the following criteria:<br>\r
+<br>\r
+1. the first port that is ACTIVE.<br>\r
+<br>\r
+2. if not found, the first port that is UP (physical link up).<br>\r
+<br>\r
+If a port and/or CA name is specified, the user request is attempted to<br>\r
+be fulfilled, and will fail if it is not possible.<br>\r
+<br>\r
+<br>\r
+EXAMPLES<br>\r
+ibaddr # local port´s address<br>\r
+<br>\r
+ibaddr 32 # show lid range and gid of lid 32<br>\r
+<br>\r
+ibaddr -G 0x8f1040023 # same but using guid address<br>\r
+<br>\r
+ibaddr -l 32 # show lid range only<br>\r
+<br>\r
+ibaddr -L 32 # show decimal lid range only<br>\r
+<br>\r
+ibaddr -g 32 # show gid address only<br>\r
+<br>\r
+<br>\r
+SEE ALSO<br>\r
+ibroute(8), ibtracert(8)<br>\r
+<br>\r
+AUTHOR<br>\r
+Hal Rosenstock<br>\r
+&lt;halr@voltaire.com&gt;<br>\r
+<br>\r
+<br>\r
+OFED June 18, 2007 IBADDR(8)<br>\r
+&nbsp;</p>\r
+<h3 align="left">&nbsp;</h3>\r
+<h3 align="left"><a name="IBLINKINFO">IBLINKINFO</a>(8) OFED Diagnostics<br>\r
+&nbsp;</h3>\r
+<p align="left">NAME<br>\r
+iblinkinfo - report link info for all links in the fabric<br>\r
+<br>\r
+<br>\r
+SYNOPSIS<br>\r
+iblinkinfo\r
+[-Rhcdl -C &lt;ca_name&gt; -P &lt;ca_port&gt; -v &lt;lt,hoq,vlstall&gt; -S &lt;guid&gt; -D&lt;direct_route&gt;]<br>\r
+<br>\r
+<br>\r
+DESCRIPTION<br>\r
+iblinkinfo reports the link info for each port of each switch active<br>\r
+in the IB fabric.<br>\r
+<br>\r
+<br>\r
+OPTIONS<br>\r
+-R Recalculate the ibnetdiscover information, ie do not use the<br>\r
+cached information. This option is slower but should be used if<br>\r
+the diag tools have not been used for some time or if there are<br>\r
+other reasons to believe the fabric has changed.<br>\r
+<br>\r
+-S &lt;guid&gt;<br>\r
+Output only the switch specified by &lt;guid&gt; (hex format)<br>\r
+<br>\r
+-D &lt;direct_route&gt;<br>\r
+Output only the switch specified by the direct route path.<br>\r
+<br>\r
+-l Print all information for each link on one line. Default is to<br>\r
+print a header with the switch information and then a list for<br>\r
+each port (useful for grep´ing output).<br>\r
+<br>\r
+-d Print only switches which have a port in the &quot;Down&quot; state.<br>\r
+<br>\r
+-v &lt;lt,hoq,vlstall&gt;<br>\r
+Verify additional switch settings (&lt;Life-<br>\r
+Time&gt;,&lt;HoqLife&gt;,&lt;VLStallCount&gt;)<br>\r
+<br>\r
+-c Print port capabilities (enabled and supported values)<br>\r
+<br>\r
+-C &lt;ca_name&gt; use the specified ca_name for the search.<br>\r
+<br>\r
+-P &lt;ca_port&gt; use the specified ca_port for the search.<br>\r
+<br>\r
+<br>\r
+<br>\r
+AUTHOR<br>\r
+Ira Weiny &lt;weiny2@llnl.gov&gt;<br>\r
+<br>\r
+<br>\r
+OFED Jan 24, 2008 IBLINKINFO(8)</p>\r
+<p align="left"><font color="#000000"><a href="#TOP">&lt;return-to-top&gt;</a></font><br>\r
+&nbsp;</p>\r
+<p align="left">&nbsp;</p>\r
+<h3 align="left"><a name="IBNETDISCOVER">IBNETDISCOVER</a>(8) OFED Diagnostics<br>\r
+&nbsp;</h3>\r
+<p align="left">NAME<br>\r
+ibnetdiscover - discover InfiniBand topology<br>\r
+<br>\r
+<br>\r
+SYNOPSIS<br>\r
+ibnetdiscover [-d(ebug)] [-e(rr_show)] [-v(erbose)] [-s(how)] [-l(ist)]<br>\r
+[-g(rouping)] [-H(ca_list)] [-S(witch_list)] [-R(outer_list)] [-C<br>\r
+ca_name] [-P ca_port] [-t(imeout) timeout_ms] [-V(ersion)] [--node-<br>\r
+name-map &lt;node-name-map&gt;] [-p(orts)] [-h(elp)] [&lt;topology-file&gt;]<br>\r
+<br>\r
+<br>\r
+DESCRIPTION<br>\r
+ibnetdiscover performs IB subnet discovery and outputs a human readable<br>\r
+topology file. GUIDs, node types, and port numbers are displayed as<br>\r
+well as port LIDs and NodeDescriptions. All nodes (and links) are dis-<br>\r
+played (full topology). Optionally, this utility can be used to list<br>\r
+the current connected nodes by nodetype. The output is printed to<br>\r
+standard output unless a topology file is specified.<br>\r
+<br>\r
+<br>\r
+OPTIONS<br>\r
+-l, --list<br>\r
+List of connected nodes<br>\r
+<br>\r
+-g, --grouping<br>\r
+Show grouping. Grouping correlates IB nodes by different vendor<br>\r
+specific schemes. It may also show the switch external ports<br>\r
+correspondence.<br>\r
+<br>\r
+-H, --Hca_list<br>\r
+List of connected CAs<br>\r
+<br>\r
+-S, --Switch_list<br>\r
+List of connected switches<br>\r
+<br>\r
+-R, --Router_list<br>\r
+List of connected routers<br>\r
+<br>\r
+-s, --show<br>\r
+Show progress information during discovery.<br>\r
+<br>\r
+--node-name-map &lt;node-name-map&gt;<br>\r
+Specify a node name map. The node name map file maps GUIDs to<br>\r
+more user friendly names. See file format below.<br>\r
+<br>\r
+-p, --ports<br>\r
+Obtain a ports report which is a list of connected ports with<br>\r
+relevant information (like LID, portnum, GUID, width, speed, and<br>\r
+NodeDescription).<br>\r
+<br>\r
+<br>\r
+COMMON OPTIONS<br>\r
+Most OpenIB diagnostics take the following common flags. The exact list<br>\r
+of supported flags per utility can be found in the usage message and<br>\r
+can be shown using the util_name -h syntax.<br>\r
+<br>\r
+# Debugging flags<br>\r
+<br>\r
+-d raise the IB debugging level.<br>\r
+May be used several times (-ddd or -d -d -d).<br>\r
+<br>\r
+-e show send and receive errors (timeouts and others)<br>\r
+<br>\r
+-h show the usage message<br>\r
+<br>\r
+-v increase the application verbosity level.<br>\r
+May be used several times (-vv or -v -v -v)<br>\r
+<br>\r
+-V show the version info.<br>\r
+<br>\r
+# Other common flags:<br>\r
+<br>\r
+-C &lt;ca_name&gt; use the specified ca_name.<br>\r
+<br>\r
+-P &lt;ca_port&gt; use the specified ca_port.<br>\r
+<br>\r
+-t &lt;timeout_ms&gt; override the default timeout for the solicited mads.<br>\r
+<br>\r
+Multiple CA/Multiple Port Support<br>\r
+<br>\r
+When no IB device or port is specified, the port to use is selected by<br>\r
+the following criteria:<br>\r
+<br>\r
+1. the first port that is ACTIVE.<br>\r
+<br>\r
+2. if not found, the first port that is UP (physical link up).<br>\r
+<br>\r
+If a port and/or CA name is specified, the user request is attempted to<br>\r
+be fulfilled, and will fail if it is not possible.<br>\r
+<br>\r
+<br>\r
+TOPOLOGY FILE FORMAT<br>\r
+The topology file format is human readable and largely intuitive. Most<br>\r
+identifiers are given textual names like vendor ID (vendid), device ID<br>\r
+(device ID), GUIDs of various types (sysimgguid, caguid, switchguid,<br>\r
+etc.). PortGUIDs are shown in parentheses (). For switches, this is<br>\r
+shown on the switchguid line. For CA and router ports, it is shown on<br>\r
+the connectivity lines. The IB node is identified followed by the num-<br>\r
+ber of ports and a quoted the node GUID. On the right of this line is<br>\r
+a comment (#) followed by the NodeDescription in quotes. If the node<br>\r
+is a switch, this line also contains whether switch port 0 is base or<br>\r
+enhanced, and the LID and LMC of port 0. Subsequent lines pertaining<br>\r
+to this node show the connectivity. On the left is the port number of<br>\r
+the current node. On the right is the peer node (node at other end of<br>\r
+link). It is identified in quotes with nodetype followed by - followed<br>\r
+by NodeGUID with the port number in square brackets. Further on the<br>\r
+right is a comment (#). What follows the comment is dependent on the<br>\r
+node type. If it it a switch node, it is followed by the NodeDescrip-<br>\r
+tion in quotes and the LID of the peer node. If it is a CA or router<br>\r
+node, it is followed by the local LID and LMC and then followed by the<br>\r
+NodeDescription in quotes and the LID of the peer node. The active<br>\r
+link width and speed are then appended to the end of this output line.<br>\r
+<br>\r
+An example of this is:<br>\r
+#<br>\r
+# Topology file: generated on Tue Jun 5 14:15:10 2007<br>\r
+#<br>\r
+# Max of 3 hops discovered<br>\r
+# Initiated from node 0008f10403960558 port 0008f10403960559<br>\r
+<br>\r
+Non-Chassis Nodes<br>\r
+<br>\r
+vendid=0x8f1<br>\r
+devid=0x5a06<br>\r
+sysimgguid=0x5442ba00003000<br>\r
+switchguid=0x5442ba00003080(5442ba00003080)<br>\r
+Switch 24 &quot;S-005442ba00003080&quot; # &quot;ISR9024 Voltaire&quot; base port 0 lid 6 lmc 0<br>\r
+[22] &quot;H-0008f10403961354&quot;[1](8f10403961355) # &quot;MT23108 InfiniHost Mellanox \r
+Technologies&quot; lid 4 4xSDR<br>\r
+[10] &quot;S-0008f10400410015&quot;[1] # &quot;SW-6IB4 Voltaire&quot; lid 3 4xSDR<br>\r
+[8] &quot;H-0008f10403960558&quot;[2](8f1040396055a) # &quot;MT23108 InfiniHost Mellanox \r
+Technologies&quot; lid 14 4xSDR<br>\r
+[6] &quot;S-0008f10400410015&quot;[3] # &quot;SW-6IB4 Voltaire&quot; lid 3 4xSDR<br>\r
+[12] &quot;H-0008f10403960558&quot;[1](8f10403960559) # &quot;MT23108 InfiniHost Mellanox \r
+Technologies&quot; lid 10 4xSDR<br>\r
+<br>\r
+vendid=0x8f1<br>\r
+devid=0x5a05<br>\r
+switchguid=0x8f10400410015(8f10400410015)<br>\r
+Switch 8 &quot;S-0008f10400410015&quot; # &quot;SW-6IB4 Voltaire&quot; base port 0 lid 3 lmc 0<br>\r
+[6] &quot;H-0008f10403960984&quot;[1](8f10403960985) # &quot;MT23108 InfiniHost Mellanox \r
+Technologies&quot; lid 16 4xSDR<br>\r
+[4] &quot;H-005442b100004900&quot;[1](5442b100004901) # &quot;MT23108 InfiniHost Mellanox \r
+Technologies&quot; lid 12 4xSDR<br>\r
+[1] &quot;S-005442ba00003080&quot;[10] # &quot;ISR9024 Voltaire&quot; lid 6 1xSDR<br>\r
+[3] &quot;S-005442ba00003080&quot;[6] # &quot;ISR9024 Voltaire&quot; lid 6 4xSDR<br>\r
+<br>\r
+vendid=0x2c9<br>\r
+devid=0x5a44<br>\r
+caguid=0x8f10403960984<br>\r
+Ca 2 &quot;H-0008f10403960984&quot; # &quot;MT23108 InfiniHost Mellanox Technologies&quot;<br>\r
+[1](8f10403960985) &quot;S-0008f10400410015&quot;[6] # lid 16 lmc 1 &quot;SW-6IB4 Voltaire&quot; lid \r
+3 4xSDR<br>\r
+<br>\r
+vendid=0x2c9<br>\r
+devid=0x5a44<br>\r
+caguid=0x5442b100004900<br>\r
+Ca 2 &quot;H-005442b100004900&quot; # &quot;MT23108 InfiniHost Mellanox Technologies&quot;<br>\r
+[1](5442b100004901) &quot;S-0008f10400410015&quot;[4] # lid 12 lmc 1 &quot;SW-6IB4 Voltaire&quot; \r
+lid 3 4xSDR<br>\r
+<br>\r
+vendid=0x2c9<br>\r
+devid=0x5a44<br>\r
+caguid=0x8f10403961354<br>\r
+Ca 2 &quot;H-0008f10403961354&quot; # &quot;MT23108 InfiniHost Mellanox Technologies&quot;<br>\r
+[1](8f10403961355) &quot;S-005442ba00003080&quot;[22] # lid 4 lmc 1 &quot;ISR9024 Voltaire&quot; lid \r
+6 4xSDR<br>\r
+<br>\r
+vendid=0x2c9<br>\r
+devid=0x5a44<br>\r
+caguid=0x8f10403960558<br>\r
+Ca 2 &quot;H-0008f10403960558&quot; # &quot;MT23108 InfiniHost Mellanox Technologies&quot;<br>\r
+[2](8f1040396055a) &quot;S-005442ba00003080&quot;[8] # lid 14 lmc 1 &quot;ISR9024 Voltaire&quot; lid \r
+6 4xSDR<br>\r
+[1](8f10403960559) &quot;S-005442ba00003080&quot;[12] # lid 10 lmc 1 &quot;ISR9024 Voltaire&quot; \r
+lid 6 1xSDR<br>\r
+<br>\r
+When grouping is used, IB nodes are organized into chasses which are<br>\r
+numbered. Nodes which cannot be determined to be in a chassis are dis-<br>\r
+played as &quot;Non-Chassis Nodes&quot;. External ports are also shown on the<br>\r
+connectivity lines.<br>\r
+<br>\r
+<br>\r
+<br>\r
+NODE NAME MAP FILE FORMAT<br>\r
+The node name map is used to specify user friendly names for nodes in<br>\r
+the output. GUIDs are used to perform the lookup.<br>\r
+<br>\r
+<br>\r
+Generically:<br>\r
+<br>\r
+# comment<br>\r
+&lt;guid&gt; &quot;&lt;name&gt;&quot;<br>\r
+<br>\r
+<br>\r
+Example:<br>\r
+<br>\r
+# IB1<br>\r
+# Line cards<br>\r
+0x0008f104003f125c &quot;IB1 (Rack 11 slot 1 ) ISR9288/ISR9096<br>\r
+Voltaire sLB-24D&quot;<br>\r
+0x0008f104003f125d &quot;IB1 (Rack 11 slot 1 ) ISR9288/ISR9096<br>\r
+Voltaire sLB-24D&quot;<br>\r
+0x0008f104003f10d2 &quot;IB1 (Rack 11 slot 2 ) ISR9288/ISR9096<br>\r
+Voltaire sLB-24D&quot;<br>\r
+0x0008f104003f10d3 &quot;IB1 (Rack 11 slot 2 ) ISR9288/ISR9096<br>\r
+Voltaire sLB-24D&quot;<br>\r
+0x0008f104003f10bf &quot;IB1 (Rack 11 slot 12 ) ISR9288/ISR9096<br>\r
+Voltaire sLB-24D&quot;<br>\r
+# Spines<br>\r
+0x0008f10400400e2d &quot;IB1 (Rack 11 spine 1 ) ISR9288 Voltaire<br>\r
+sFB-12D&quot;<br>\r
+0x0008f10400400e2e &quot;IB1 (Rack 11 spine 1 ) ISR9288 Voltaire<br>\r
+sFB-12D&quot;<br>\r
+0x0008f10400400e2f &quot;IB1 (Rack 11 spine 1 ) ISR9288 Voltaire<br>\r
+sFB-12D&quot;<br>\r
+0x0008f10400400e31 &quot;IB1 (Rack 11 spine 2 ) ISR9288 Voltaire<br>\r
+sFB-12D&quot;<br>\r
+0x0008f10400400e32 &quot;IB1 (Rack 11 spine 2 ) ISR9288 Voltaire<br>\r
+sFB-12D&quot;<br>\r
+# GUID Node Name<br>\r
+0x0008f10400411a08 &quot;SW1 (Rack 3) ISR9024 Voltaire 9024D&quot;<br>\r
+0x0008f10400411a28 &quot;SW2 (Rack 3) ISR9024 Voltaire 9024D&quot;<br>\r
+0x0008f10400411a34 &quot;SW3 (Rack 3) ISR9024 Voltaire 9024D&quot;<br>\r
+0x0008f104004119d0 &quot;SW4 (Rack 3) ISR9024 Voltaire 9024D&quot;<br>\r
+<br>\r
+<br>\r
+AUTHORS<br>\r
+Hal Rosenstock&nbsp;&nbsp;&nbsp; &lt;halr@voltaire.com&gt;<br>\r
+<br>\r
+Ira Weiny&nbsp;&nbsp;&nbsp; &lt;weiny2@llnl.gov&gt;<br>\r
+<br>\r
+<br>\r
+OFED January 3, 2008 IBNETDISCOVER(8)<br>\r
+<br>\r
+<font color="#000000"><a href="#TOP">&lt;return-to-top&gt;</a></font><br>\r
+&nbsp;</p>\r
+<p align="left">&nbsp;</p>\r
+<h3 align="left"><a name="IBPING">IBPING</a>(8) OFED Diagnostics<br>\r
+&nbsp;</h3>\r
+<p align="left">NAME<br>\r
+ibping - ping an InfiniBand address<br>\r
+<br>\r
+<br>\r
+SYNOPSIS<br>\r
+ibping [-d(ebug)] [-e(rr_show)] [-v(erbose)] [-G(uid)] [-C ca_name] [-P<br>\r
+ca_port] [-s smlid] [-t(imeout) timeout_ms] [-V(ersion)] [-c<br>\r
+ping_count] [-f(lood)] [-o oui] [-S(erver)] [-h(elp)] &lt;dest lid | guid&gt;<br>\r
+<br>\r
+<br>\r
+DESCRIPTION<br>\r
+ibping uses vendor mads to validate connectivity between IB nodes. On<br>\r
+exit, (IP) ping like output is show. ibping is run as client/server.<br>\r
+Default is to run as client. Note also that a default ping server is<br>\r
+implemented within the kernel.<br>\r
+<br>\r
+<br>\r
+OPTIONS<br>\r
+-c stop after count packets<br>\r
+<br>\r
+-f, --flood<br>\r
+flood destination: send packets back to back without delay<br>\r
+<br>\r
+-o, --oui<br>\r
+use specified OUI number to multiplex vendor mads<br>\r
+<br>\r
+-S, --Server<br>\r
+start in server mode (do not return)<br>\r
+<br>\r
+<br>\r
+COMMON OPTIONS<br>\r
+Most OFED diagnostics take the following common flags. The exact list<br>\r
+of supported flags per utility can be found in the usage message and<br>\r
+can be shown using the util_name -h syntax.<br>\r
+<br>\r
+# Debugging flags<br>\r
+<br>\r
+-d raise the IB debugging level.<br>\r
+May be used several times (-ddd or -d -d -d).<br>\r
+<br>\r
+-e show send and receive errors (timeouts and others)<br>\r
+<br>\r
+-h show the usage message<br>\r
+<br>\r
+-v increase the application verbosity level.<br>\r
+May be used several times (-vv or -v -v -v)<br>\r
+<br>\r
+-V show the version info.<br>\r
+<br>\r
+# Addressing flags<br>\r
+<br>\r
+-G use GUID address argument. In most cases, it is the Port GUID.<br>\r
+Example:<br>\r
+&quot;0x08f1040023&quot;<br>\r
+<br>\r
+-s &lt;smlid&gt; use \92smlid\92 as the target lid for SM/SA queries.<br>\r
+<br>\r
+# Other common flags:<br>\r
+<br>\r
+-C &lt;ca_name&gt; use the specified ca_name.<br>\r
+<br>\r
+-P &lt;ca_port&gt; use the specified ca_port.<br>\r
+<br>\r
+-t &lt;timeout_ms&gt; override the default timeout for the solicited mads.<br>\r
+<br>\r
+Multiple CA/Multiple Port Support<br>\r
+<br>\r
+When no IB device or port is specified, the port to use is selected by<br>\r
+the following criteria:<br>\r
+<br>\r
+1. the first port that is ACTIVE.<br>\r
+<br>\r
+2. if not found, the first port that is UP (physical link up).<br>\r
+<br>\r
+If a port and/or CA name is specified, the user request is attempted to<br>\r
+be fulfilled, and will fail if it is not possible.<br>\r
+<br>\r
+<br>\r
+AUTHOR<br>\r
+Hal Rosenstock &lt;halr@voltaire.com&gt;<br>\r
+<br>\r
+<br>\r
+OFED August 11, 2006 IBPING(8)</p>\r
+<p align="left"><br>\r
+<font color="#000000"><a href="#TOP">&lt;return-to-top&gt;</a></font></p>\r
+<h3 align="left">&nbsp;</h3>\r
+<h3 align="left"><a name="IBPORTSTATE">IBPORTSTATE</a>(8) OFED Diagnostics</h3>\r
+<p align="left"><br>\r
+NAME<br>\r
+ibportstate - handle port (physical) state and link speed of an Infini-<br>\r
+Band port<br>\r
+<br>\r
+<br>\r
+SYNOPSIS<br>\r
+ibportstate [-d(ebug)] [-e(rr_show)] [-v(erbose)] [-D(irect)] [-G(uid)] [-s \r
+smlid] [-V(ersion)] [-C ca_name] [-P ca_port] [-t(imeout) time-out_ms] [-h(elp)] \r
+&lt;dest dr_path|lid|guid&gt; &lt;portnum&gt; [&lt;op&gt;]<br>\r
+<br>\r
+<br>\r
+DESCRIPTION<br>\r
+ibportstate allows the port state and port physical state of an IB port<br>\r
+to be queried (in addition to link width and speed being validated rel-<br>\r
+ative to the peer port when the port queried is a switch port), or a<br>\r
+switch port to be disabled, enabled, or reset. It also allows the link<br>\r
+speed enabled on any IB port to be adjusted.<br>\r
+<br>\r
+<br>\r
+OPTIONS<br>\r
+op Port operations allowed<br>\r
+supported ops: enable, disable, reset, speed, query<br>\r
+Default is query<br>\r
+<br>\r
+ops enable, disable, and reset are only allowed on switch ports<br>\r
+(An error is indicated if attempted on CA or router ports)<br>\r
+speed op is allowed on any port<br>\r
+speed values are legal values for PortInfo:LinkSpeedEnabled<br>\r
+(An error is indicated if PortInfo:LinkSpeedSupported does not support<br>\r
+this setting)<br>\r
+(NOTE: Speed changes are not effected until the port goes through<br>\r
+link renegotiation)<br>\r
+query also validates port characteristics (link width and speed)<br>\r
+based on the peer port. This checking is done when the port<br>\r
+queried is a switch port as it relies on combined routing<br>\r
+(an initial LID route with directed routing to the peer) which<br>\r
+can only be done on a switch. This peer port validation feature<br>\r
+of query op requires LID routing to be functioning in the subnet.<br>\r
+<br>\r
+<br>\r
+COMMON OPTIONS<br>\r
+Most OFED diagnostics take the following common flags. The exact list<br>\r
+of supported flags per utility can be found in the usage message and<br>\r
+can be shown using the util_name -h syntax.<br>\r
+<br>\r
+# Debugging flags<br>\r
+<br>\r
+-d raise the IB debugging level.<br>\r
+May be used several times (-ddd or -d -d -d).<br>\r
+<br>\r
+-e show send and receive errors (timeouts and others)<br>\r
+<br>\r
+-h show the usage message<br>\r
+<br>\r
+-v increase the application verbosity level.<br>\r
+May be used several times (-vv or -v -v -v)<br>\r
+<br>\r
+-V show the version info.<br>\r
+<br>\r
+# Addressing flags<br>\r
+<br>\r
+-D use directed path address arguments. The path<br>\r
+is a comma separated list of out ports.<br>\r
+Examples:<br>\r
+&quot;0&quot; # self port<br>\r
+&quot;0,1,2,1,4&quot; # out via port 1, then 2, ...<br>\r
+<br>\r
+-G use GUID address argument. In most cases, it is the Port GUID.<br>\r
+Example:<br>\r
+&quot;0x08f1040023&quot;<br>\r
+<br>\r
+-s &lt;smlid&gt; use \92smlid\92 as the target lid for SM/SA queries.<br>\r
+<br>\r
+# Other common flags:<br>\r
+<br>\r
+-C &lt;ca_name&gt; use the specified ca_name.<br>\r
+<br>\r
+-P &lt;ca_port&gt; use the specified ca_port.<br>\r
+<br>\r
+-t &lt;timeout_ms&gt; override the default timeout for the solicited mads.<br>\r
+<br>\r
+Multiple CA/Multiple Port Support<br>\r
+<br>\r
+When no IB device or port is specified, the port to use is selected by<br>\r
+the following criteria:<br>\r
+<br>\r
+1. the first port that is ACTIVE.<br>\r
+<br>\r
+2. if not found, the first port that is UP (physical link up).<br>\r
+<br>\r
+If a port and/or CA name is specified, the user request is attempted to<br>\r
+be fulfilled, and will fail if it is not possible.<br>\r
+<br>\r
+<br>\r
+EXAMPLES<br>\r
+ibportstate 3 1 disable # by lid<br>\r
+<br>\r
+ibportstate -G 0x2C9000100D051 1 enable # by guid<br>\r
+<br>\r
+ibportstate -D 0 1 # (query) by direct route<br>\r
+<br>\r
+ibportstate 3 1 reset # by lid<br>\r
+<br>\r
+ibportstate 3 1 speed 1 # by lid<br>\r
+<br>\r
+<br>\r
+AUTHOR<br>\r
+Hal Rosenstock &lt;halr@voltaire.com&gt;<br>\r
+<br>\r
+<br>\r
+OFED October 19, 2006 IBPORTSTATE(8)</p>\r
+<p align="left"><br>\r
+<font color="#000000"><a href="#TOP">&lt;return-to-top&gt;</a></font></p>\r
+<h3 align="left">&nbsp;</h3>\r
+<h3 align="left"><a name="IBQUERYERRORS">IBQUERYERRORS</a>(8) OFED Diagnostics<br>\r
+&nbsp;</h3>\r
+<p align="left">NAME<br>\r
+ibqueryerrors - query and report non-zero IB port counters<br>\r
+<br>\r
+<br>\r
+SYNOPSIS<br>\r
+ibqueryerrors [-a -c -r -R -C &lt;ca_name&gt; -P &lt;ca_port&gt; -s<br>\r
+&lt;err1,err2,...&gt; -S &lt;switch_guid&gt; -D &lt;direct_route&gt; -d]<br>\r
+<br>\r
+<br>\r
+DESCRIPTION<br>\r
+ibqueryerrors reports the port counters of switches. This is simi-<br>\r
+lar to ibcheckerrors with the additional ability to filter out selected<br>\r
+errors, include the optional transmit and receive data counters, report<br>\r
+actions to remedy a non-zero count, and report full link information<br>\r
+for the link reported.<br>\r
+<br>\r
+<br>\r
+OPTIONS<br>\r
+-a Report an action to take. Some of the counters are not errors<br>\r
+in and of themselves. This reports some more information on<br>\r
+what the counters mean and what actions can/should be taken if<br>\r
+they are non-zero.<br>\r
+<br>\r
+-c Suppress some of the common &quot;side effect&quot; counters. These coun-<br>\r
+ters usually do not indicate an error condition and can be usu-<br>\r
+ally be safely ignored.<br>\r
+<br>\r
+-r Report the port information. This includes LID, port, external<br>\r
+port (if applicable), link speed setting, remote GUID, remote<br>\r
+port, remote external port (if applicable), and remote node<br>\r
+description information.<br>\r
+<br>\r
+-R Recalculate the ibnetdiscover information, ie do not use the<br>\r
+cached information. This option is slower but should be used if<br>\r
+the diag tools have not been used for some time or if there are<br>\r
+other reasons to believe that the fabric has changed.<br>\r
+<br>\r
+-s &lt;err1,err2,...&gt;<br>\r
+Suppress the errors listed in the comma separated list provided.<br>\r
+<br>\r
+-S &lt;switch_guid&gt;<br>\r
+Report results only for the switch specified. (hex format)<br>\r
+<br>\r
+-D &lt;direct_route&gt;<br>\r
+Report results only for the switch specified by the direct route<br>\r
+path.<br>\r
+<br>\r
+-d Include the optional transmit and receive data counters.<br>\r
+<br>\r
+-C &lt;ca_name&gt; use the specified ca_name for the search.<br>\r
+<br>\r
+-P &lt;ca_port&gt; use the specified ca_port for the search.<br>\r
+<br>\r
+AUTHOR<br>\r
+Ira Weiny &lt;weiny2@llnl.gov&gt;<br>\r
+<br>\r
+<br>\r
+OFED Jan 24, 2008 IBQUERYERRORS(8)</p>\r
+<p align="left"><br>\r
+<font color="#000000"><a href="#TOP">&lt;return-to-top&gt;</a></font></p>\r
+<h3 align="left">&nbsp;</h3>\r
+<h3 align="left"><a name="IBROUTE">IBROUTE</a>(8) OFED Diagnostics<br>\r
+&nbsp;</h3>\r
+<p align="left">NAME<br>\r
+ibroute - query InfiniBand switch forwarding tables<br>\r
+<br>\r
+<br>\r
+SYNOPSIS<br>\r
+ibroute [-d(ebug)] [-a(ll)] [-n(o_dests)] [-v(erbose)] [-D(irect)]<br>\r
+[-G(uid)] [-M(ulticast)] [-s smlid] [-C ca_name] [-P ca_port] [-t(ime-<br>\r
+out) timeout_ms] [-V(ersion)] [-h(elp)] [&lt;dest dr_path|lid|guid&gt;<br>\r
+[&lt;startlid&gt; [&lt;endlid&gt;]]]<br>\r
+<br>\r
+<br>\r
+DESCRIPTION<br>\r
+ibroute uses SMPs to display the forwarding tables (unicast (LinearFor-<br>\r
+wardingTable or LFT) or multicast (MulticastForwardingTable or MFT))<br>\r
+for the specified switch LID and the optional lid (mlid) range. The<br>\r
+default range is all valid entries in the range 1...FDBTop.<br>\r
+<br>\r
+<br>\r
+OPTIONS<br>\r
+-a, --all<br>\r
+show all lids in range, even invalid entries<br>\r
+<br>\r
+-n, --no_dests<br>\r
+do not try to resolve destinations<br>\r
+<br>\r
+-M, --Multicast<br>\r
+show multicast forwarding tables In this case, the range parame-<br>\r
+ters are specifying the mlid range.<br>\r
+<br>\r
+<br>\r
+COMMON OPTIONS<br>\r
+Most OFED diagnostics take the following common flags. The exact list<br>\r
+of supported flags per utility can be found in the usage message and<br>\r
+can be shown using the util_name -h syntax.<br>\r
+<br>\r
+# Debugging flags<br>\r
+<br>\r
+-d raise the IB debugging level.<br>\r
+May be used several times (-ddd or -d -d -d).<br>\r
+<br>\r
+-e show send and receive errors (timeouts and others)<br>\r
+<br>\r
+-h show the usage message<br>\r
+<br>\r
+-v increase the application verbosity level.<br>\r
+May be used several times (-vv or -v -v -v)<br>\r
+<br>\r
+-V show the version info.<br>\r
+<br>\r
+# Addressing flags<br>\r
+<br>\r
+-D use directed path address arguments. The path<br>\r
+is a comma separated list of out ports.<br>\r
+Examples:<br>\r
+&quot;0&quot; # self port<br>\r
+&quot;0,1,2,1,4&quot; # out via port 1, then 2, ...<br>\r
+<br>\r
+-G use GUID address argument. In most cases, it is the Port GUID.<br>\r
+Example:<br>\r
+&quot;0x08f1040023&quot;<br>\r
+<br>\r
+-s &lt;smlid&gt; use \92smlid\92 as the target lid for SM/SA queries.<br>\r
+<br>\r
+# Other common flags:<br>\r
+<br>\r
+-C &lt;ca_name&gt; use the specified ca_name.<br>\r
+<br>\r
+-P &lt;ca_port&gt; use the specified ca_port.<br>\r
+<br>\r
+-t &lt;timeout_ms&gt; override the default timeout for the solicited mads.<br>\r
+<br>\r
+Multiple CA/Multiple Port Support<br>\r
+<br>\r
+When no IB device or port is specified, the port to use is selected by<br>\r
+the following criteria:<br>\r
+<br>\r
+1. the first port that is ACTIVE.<br>\r
+<br>\r
+2. if not found, the first port that is UP (physical link up).<br>\r
+<br>\r
+If a port and/or CA name is specified, the user request is attempted to<br>\r
+be fulfilled, and will fail if it is not possible.<br>\r
+<br>\r
+<br>\r
+EXAMPLES<br>\r
+Unicast examples<br>\r
+<br>\r
+ibroute 4 # dump all lids with valid out ports of switch with lid 4<br>\r
+<br>\r
+ibroute -a 4 # same, but dump all lids, even with invalid out ports<br>\r
+<br>\r
+ibroute -n 4 # simple dump format - no destination resolution<br>\r
+<br>\r
+ibroute 4 10 # dump lids starting from 10 (up to FDBTop)<br>\r
+<br>\r
+ibroute 4 0x10 0x20 # dump lid range<br>\r
+<br>\r
+ibroute -G 0x08f1040023 # resolve switch by GUID<br>\r
+<br>\r
+ibroute -D 0,1 # resolve switch by direct path<br>\r
+<br>\r
+<br>\r
+Multicast examples<br>\r
+<br>\r
+ibroute -M 4 # dump all non empty mlids of switch with lid 4<br>\r
+<br>\r
+ibroute -M 4 0xc010 0xc020 # same, but with range<br>\r
+<br>\r
+ibroute -M -n 4 # simple dump format<br>\r
+<br>\r
+<br>\r
+SEE ALSO<br>\r
+ibtracert(8)<br>\r
+<br>\r
+AUTHOR<br>\r
+Hal Rosenstock &lt;halr@voltaire.com&gt;<br>\r
+<br>\r
+<br>\r
+OFED July 25, 2006 IBROUTE(8)</p>\r
+<p align="left"><br>\r
+<font color="#000000"><a href="#TOP">&lt;return-to-top&gt;</a></font><br>\r
+&nbsp;</p>\r
+<p align="left">&nbsp;</p>\r
+<BLOCKQUOTE></BLOCKQUOTE>\r
+<h3 align="left"><a name="ibv_devinfo"></a><br>\r
+ibv_devinfo - print CA (Channel Adapter) attributes</h3>\r
+<p align="left">usage: ibv_devinfo&nbsp; [options]<br>\r
+<br>\r
+Options:<br>\r
+&nbsp;&nbsp; -d, --ib-dev=&lt;dev&gt; use IB device &lt;dev&gt; (default: first device \r
+found)<br>\r
+&nbsp;&nbsp;&nbsp; -i, --ib-port=&lt;port&gt; use port &lt;port&gt; of IB device (default: \r
+all ports)<br>\r
+&nbsp;&nbsp;&nbsp; -l, --list print only the IB devices names<br>\r
+&nbsp;&nbsp;&nbsp; -v, --verbose print all the attributes of the IB device(s)<br>\r
+<br>\r
+<font color="#000000"><a href="#TOP">&lt;return-to-top&gt;</a></font><br>\r
+&nbsp;</p>\r
+<BLOCKQUOTE></BLOCKQUOTE>\r
+<h3 align="left"><a name="ibstat"></a><br>\r
+IBSTAT(8) OFED Diagnostics</h3>\r
+<p align="left">NAME<br>\r
+ibstat - query basic status of InfiniBand device(s)<br>\r
+<br>\r
+<br>\r
+SYNOPSIS<br>\r
+ibstat [-d(ebug)] [-l(ist_of_cas)] [-s(hort)] [-p(ort_list)] [-V(ersion)] [-h] &lt;ca_name&gt; \r
+[portnum]<br>\r
+<br>\r
+<br>\r
+DESCRIPTION<br>\r
+ibstat is a binary which displays basic information obtained from the<br>\r
+local IB driver. Output includes LID, SMLID, port state, link width<br>\r
+active, and port physical state.<br>\r
+<br>\r
+It is similar to the ibstatus utility but implemented as a binary<br>\r
+rather than a script. It has options to list CAs and/or ports and dis-<br>\r
+plays more information than ibstatus.<br>\r
+<br>\r
+<br>\r
+OPTIONS<br>\r
+-l, --list_of_cas<br>\r
+list all IB devices<br>\r
+<br>\r
+-s, --short<br>\r
+short output<br>\r
+<br>\r
+-p, --port_list<br>\r
+show port list<br>\r
+<br>\r
+ca_name<br>\r
+InfiniBand device name<br>\r
+<br>\r
+portnum<br>\r
+port number of InfiniBand device<br>\r
+<br>\r
+<br>\r
+COMMON OPTIONS<br>\r
+Most OFED diagnostics take the following common flags. The exact list<br>\r
+of supported flags per utility can be found in the usage message and<br>\r
+can be shown using the util_name -h syntax.<br>\r
+<br>\r
+# Debugging flags<br>\r
+<br>\r
+-d raise the IB debugging level.<br>\r
+May be used several times (-ddd or -d -d -d).<br>\r
+<br>\r
+-e show send and receive errors (timeouts and others)<br>\r
+<br>\r
+-h show the usage message<br>\r
+<br>\r
+-v increase the application verbosity level.<br>\r
+May be used several times (-vv or -v -v -v)<br>\r
+<br>\r
+-V show the version info.<br>\r
+<br>\r
+# Addressing flags<br>\r
+<br>\r
+-D use directed path address arguments. The path<br>\r
+is a comma separated list of out ports.<br>\r
+Examples:<br>\r
+&quot;0&quot; # self port<br>\r
+&quot;0,1,2,1,4&quot; # out via port 1, then 2, ...<br>\r
+<br>\r
+-G use GUID address argument. In most cases, it is the Port GUID.<br>\r
+Example:<br>\r
+&quot;0x08f1040023&quot;<br>\r
+<br>\r
+-s &lt;smlid&gt; use \92smlid\92 as the target lid for SM/SA queries.<br>\r
+<br>\r
+# Other common flags:<br>\r
+<br>\r
+-C &lt;ca_name&gt; use the specified ca_name.<br>\r
+<br>\r
+-P &lt;ca_port&gt; use the specified ca_port.<br>\r
+<br>\r
+-t &lt;timeout_ms&gt; override the default timeout for the solicited mads.<br>\r
+<br>\r
+Multiple CA/Multiple Port Support<br>\r
+<br>\r
+When no IB device or port is specified, the port to use is selected by<br>\r
+the following criteria:<br>\r
+<br>\r
+1. the first port that is ACTIVE.<br>\r
+<br>\r
+2. if not found, the first port that is UP (physical link up).<br>\r
+<br>\r
+If a port and/or CA name is specified, the user request is attempted to<br>\r
+be fulfilled, and will fail if it is not possible.<br>\r
+<br>\r
+<br>\r
+EXAMPLES<br>\r
+ibstat # display status of all ports on all IB devices<br>\r
+<br>\r
+ibstat -l # list all IB devices<br>\r
+<br>\r
+ibstat -p # show port guids<br>\r
+<br>\r
+ibstat ibv_device0 2 # show status of port 2 of \92hca0\92<br>\r
+<br>\r
+<br>\r
+SEE ALSO<br>\r
+ibstatus(8)<br>\r
+<br>\r
+<br>\r
+AUTHOR<br>\r
+Hal Rosenstock &lt;halr@voltaire.com&gt;<br>\r
+<br>\r
+<br>\r
+OFED July 25, 2006 IBSTAT(8)<br>\r
+<br>\r
+<font color="#000000"><a href="#TOP">&lt;return-to-top&gt;</a></font><br>\r
+&nbsp;</p>\r
+<p align="left">&nbsp;</p>\r
+<h3 align="left"><a name="IBSYSSTAT">IBSYSSTAT</a>(8) OFED Diagnostics<br>\r
+&nbsp;</h3>\r
+<p align="left">NAME<br>\r
+ibsysstat - system status on an InfiniBand address<br>\r
+<br>\r
+<br>\r
+SYNOPSIS<br>\r
+ibsysstat [-d(ebug)] [-e(rr_show)] [-v(erbose)] [-G(uid)] [-C ca_name]<br>\r
+[-P ca_port] [-s smlid] [-t(imeout) timeout_ms] [-V(ersion)] [-o oui]<br>\r
+[-S(erver)] [-h(elp)] &lt;dest lid | guid&gt; [&lt;op&gt;]<br>\r
+<br>\r
+<br>\r
+DESCRIPTION<br>\r
+ibsysstat uses vendor mads to validate connectivity between IB nodes<br>\r
+and obtain other information about the IB node. ibsysstat is run as<br>\r
+client/server. Default is to run as client.<br>\r
+<br>\r
+<br>\r
+OPTIONS<br>\r
+Current supported operations:<br>\r
+ping - verify connectivity to server (default)<br>\r
+host - obtain host information from server<br>\r
+cpu - obtain cpu information from server<br>\r
+<br>\r
+-o, --oui<br>\r
+use specified OUI number to multiplex vendor mads<br>\r
+<br>\r
+-S, --Server<br>\r
+start in server mode (do not return)<br>\r
+<br>\r
+<br>\r
+<br>\r
+COMMON OPTIONS<br>\r
+Most OFED diagnostics take the following common flags. The exact list<br>\r
+of supported flags per utility can be found in the usage message and<br>\r
+can be shown using the util_name -h syntax.<br>\r
+<br>\r
+# Debugging flags<br>\r
+<br>\r
+-d raise the IB debugging level.<br>\r
+May be used several times (-ddd or -d -d -d).<br>\r
+<br>\r
+-e show send and receive errors (timeouts and others)<br>\r
+<br>\r
+-h show the usage message<br>\r
+<br>\r
+-v increase the application verbosity level.<br>\r
+May be used several times (-vv or -v -v -v)<br>\r
+<br>\r
+-V show the version info.<br>\r
+<br>\r
+# Addressing flags<br>\r
+<br>\r
+-G use GUID address argument. In most cases, it is the Port GUID.<br>\r
+Example:<br>\r
+&quot;0x08f1040023&quot;<br>\r
+<br>\r
+-s &lt;smlid&gt; use \92smlid\92 as the target lid for SM/SA queries.<br>\r
+<br>\r
+# Other common flags:<br>\r
+<br>\r
+-C &lt;ca_name&gt; use the specified ca_name.<br>\r
+<br>\r
+-P &lt;ca_port&gt; use the specified ca_port.<br>\r
+<br>\r
+-t &lt;timeout_ms&gt; override the default timeout for the solicited mads.<br>\r
+<br>\r
+Multiple CA/Multiple Port Support<br>\r
+<br>\r
+When no IB device or port is specified, the port to use is selected by<br>\r
+the following criteria:<br>\r
+<br>\r
+1. the first port that is ACTIVE.<br>\r
+<br>\r
+2. if not found, the first port that is UP (physical link up).<br>\r
+<br>\r
+If a port and/or CA name is specified, the user request is attempted to<br>\r
+be fulfilled, and will fail if it is not possible.<br>\r
+<br>\r
+<br>\r
+AUTHOR<br>\r
+Hal Rosenstock&nbsp;&nbsp;&nbsp; &lt;halr@voltaire.com&gt;<br>\r
+<br>\r
+<br>\r
+OFED August 11, 2006 IBSYSSTAT(8)</p>\r
+<p align="left"><br>\r
+<a href="#TOP"><font color="#000000">&lt;return-to-top&gt;</font></a></p>\r
+<h3 align="left">&nbsp;</h3>\r
+<h3 align="left"><a name="IBTRACERT">IBTRACERT</a>(8) OFED Diagnostics</h3>\r
+<p align="left"><br>\r
+NAME<br>\r
+ibtracert- trace InfiniBand path<br>\r
+<br>\r
+<br>\r
+SYNOPSIS<br>\r
+ibtracert [-d(ebug)] [-v(erbose)] [-D(irect)] [-G(uids)] [-n(o_info)]<br>\r
+[-m mlid] [-s smlid] [-C ca_name] [-P ca_port] [-t(imeout) timeout_ms]<br>\r
+[-V(ersion)] [--node-name--map &lt;node-name-map&gt;] [-h(elp)] [&lt;dest<br>\r
+dr_path|lid|guid&gt; [&lt;startlid&gt; [&lt;endlid&gt;]]]<br>\r
+<br>\r
+<br>\r
+DESCRIPTION<br>\r
+ibtracert uses SMPs to trace the path from a source GID/LID to a desti-<br>\r
+nation GID/LID. Each hop along the path is displayed until the destina-<br>\r
+tion is reached or a hop does not respond. By using the -m option, mul-<br>\r
+ticast path tracing can be performed between source and destination<br>\r
+nodes.<br>\r
+<br>\r
+<br>\r
+OPTIONS<br>\r
+-n, --no_info<br>\r
+simple format; don\92t show additional information<br>\r
+<br>\r
+-m show the multicast trace of the specified mlid<br>\r
+<br>\r
+--node-name-map &lt;node-name-map&gt;<br>\r
+Specify a node name map. The node name map file maps GUIDs to<br>\r
+more user friendly names. See ibnetdiscover(8) for node name<br>\r
+map file format.<br>\r
+<br>\r
+<br>\r
+COMMON OPTIONS<br>\r
+Most OFED diagnostics take the following common flags. The exact list<br>\r
+of supported flags per utility can be found in the usage message and<br>\r
+can be shown using the util_name -h syntax.<br>\r
+<br>\r
+# Debugging flags<br>\r
+<br>\r
+-d raise the IB debugging level.<br>\r
+May be used several times (-ddd or -d -d -d).<br>\r
+<br>\r
+-h show the usage message<br>\r
+<br>\r
+-v increase the application verbosity level.<br>\r
+May be used several times (-vv or -v -v -v)<br>\r
+<br>\r
+-V show the version info.<br>\r
+<br>\r
+# Addressing flags<br>\r
+<br>\r
+-D use directed path address arguments. The path<br>\r
+is a comma separated list of out ports.<br>\r
+Examples:<br>\r
+&quot;0&quot; # self port<br>\r
+&quot;0,1,2,1,4&quot; # out via port 1, then 2, ...<br>\r
+<br>\r
+-G use GUID address argument. In most cases, it is the Port GUID.<br>\r
+Example:<br>\r
+&quot;0x08f1040023&quot;<br>\r
+<br>\r
+-s &lt;smlid&gt; use \92smlid\92 as the target lid for SM/SA queries.<br>\r
+<br>\r
+# Other common flags:<br>\r
+<br>\r
+-C &lt;ca_name&gt; use the specified ca_name.<br>\r
+<br>\r
+-P &lt;ca_port&gt; use the specified ca_port.<br>\r
+<br>\r
+-t &lt;timeout_ms&gt; override the default timeout for the solicited mads.<br>\r
+<br>\r
+Multiple CA/Multiple Port Support<br>\r
+<br>\r
+When no IB device or port is specified, the port to use is selected by<br>\r
+the following criteria:<br>\r
+<br>\r
+1. the first port that is ACTIVE.<br>\r
+<br>\r
+2. if not found, the first port that is UP (physical link up).<br>\r
+<br>\r
+If a port and/or CA name is specified, the user request is attempted to<br>\r
+be fulfilled, and will fail if it is not possible.<br>\r
+<br>\r
+<br>\r
+EXAMPLES<br>\r
+Unicast examples<br>\r
+<br>\r
+ibtracert 4 16 # show path between lids 4 and 16<br>\r
+<br>\r
+ibtracert -n 4 16 # same, but using simple output format<br>\r
+<br>\r
+ibtracert -G 0x8f1040396522d 0x002c9000100d051 # use guid addresses<br>\r
+<br>\r
+<br>\r
+Multicast example<br>\r
+<br>\r
+ibtracert -m 0xc000 4 16 # show multicast path of mlid 0xc000<br>\r
+between lids 4 and 16<br>\r
+<br>\r
+<br>\r
+SEE ALSO<br>\r
+ibroute(8)<br>\r
+<br>\r
+<br>\r
+AUTHOR<br>\r
+&nbsp;&nbsp;&nbsp; Hal Rosenstock&nbsp;&nbsp;&nbsp; &lt;<a href="mailto:halr@voltaire.com">halr@voltaire.com</a>&gt;<br>\r
+<br>\r
+&nbsp;&nbsp;&nbsp; Ira Weiny&nbsp;&nbsp;&nbsp; &lt;weiny2@llnl.gov&gt;<br>\r
+<br>\r
+OFED April 14, 2007 IBTRACERT(8)</p>\r
+<p align="left"><a href="#TOP"><font color="#000000">&lt;return-to-top&gt;</font></a></p>\r
+<h3 align="left">&nbsp;</h3>\r
+<h3 align="left"><a name="PERFQUERY">PERFQUERY</a>(8) OFED Diagnostics</h3>\r
+<p align="left"><br>\r
+NAME<br>\r
+perfquery - query InfiniBand port counters<br>\r
+<br>\r
+<br>\r
+SYNOPSIS<br>\r
+perfquery [-d(ebug)] [-G(uid)] [-x|--extended] [-X|--xmtsl]<br>\r
+[-S|--rcvsl] [-a(ll_ports)] [-l(oop_ports)] [-r(eset_after_read)]<br>\r
+[-R(eset_only)] [-C ca_name] [-P ca_port] [-t(imeout) timeout_ms]<br>\r
+[-V(ersion)] [-h(elp)] [&lt;lid|guid&gt; [[port] [reset_mask]]]<br>\r
+<br>\r
+<br>\r
+DESCRIPTION<br>\r
+perfquery uses PerfMgt GMPs to obtain the PortCounters (basic perfor-<br>\r
+mance and error counters), PortExtendedCounters, PortXmitDataSL, or<br>\r
+PortRcvDataSL from the PMA at the node/port specified. Optionally shows<br>\r
+aggregated counters for all ports of node. Also, optionally, reset<br>\r
+after read, or only reset counters.<br>\r
+<br>\r
+Note: In PortCounters, PortCountersExtended, PortXmitDataSL, and PortR-<br>\r
+cvDataSL, components that represent Data (e.g. PortXmitData and PortR-<br>\r
+cvData) indicate octets divided by 4 rather than just octets.<br>\r
+<br>\r
+Note: Inputting a port of 255 indicates an operation be performed on<br>\r
+all ports.<br>\r
+<br>\r
+<br>\r
+OPTIONS<br>\r
+-x, --extended<br>\r
+show extended port counters rather than (basic) port counters.<br>\r
+Note that extended port counters attribute is optional.<br>\r
+<br>\r
+-X, --xmtsl<br>\r
+show transmit data SL counter. This is an optional counter for<br>\r
+QoS.<br>\r
+<br>\r
+-S, --rcvsl<br>\r
+show receive data SL counter. This is an optional counter for<br>\r
+QoS.<br>\r
+<br>\r
+-a, --all_ports<br>\r
+show aggregated counters for all ports of the destination lid or<br>\r
+reset all counters for all ports. If the destination lid does<br>\r
+not support the AllPortSelect flag, all ports will be iterated<br>\r
+through to emulate AllPortSelect behavior.<br>\r
+<br>\r
+-l, --loop_ports<br>\r
+If all ports are selected by the user (either through the -a<br>\r
+option or port 255) iterate through each port rather than doing<br>\r
+than aggregate operation.<br>\r
+<br>\r
+-r, --reset_after_read<br>\r
+reset counters after read<br>\r
+<br>\r
+-R, --Reset_only<br>\r
+only reset counters<br>\r
+<br>\r
+<br>\r
+COMMON OPTIONS<br>\r
+Most OFED diagnostics take the following common flags. The exact list<br>\r
+of supported flags per utility can be found in the usage message and<br>\r
+can be shown using the util_name -h syntax.<br>\r
+<br>\r
+# Debugging flags<br>\r
+<br>\r
+-d raise the IB debugging level.<br>\r
+May be used several times (-ddd or -d -d -d).<br>\r
+<br>\r
+-e show send and receive errors (timeouts and others)<br>\r
+<br>\r
+-h show the usage message<br>\r
+<br>\r
+-v increase the application verbosity level.<br>\r
+May be used several times (-vv or -v -v -v)<br>\r
+<br>\r
+-V show the version info.<br>\r
+<br>\r
+# Addressing flags<br>\r
+<br>\r
+-G use GUID address argument. In most cases, it is the Port GUID.<br>\r
+Example:<br>\r
+&quot;0x08f1040023&quot;<br>\r
+<br>\r
+-s &lt;smlid&gt; use \92smlid\92 as the target lid for SM/SA queries.<br>\r
+<br>\r
+# Other common flags:<br>\r
+<br>\r
+-C &lt;ca_name&gt; use the specified ca_name.<br>\r
+<br>\r
+-P &lt;ca_port&gt; use the specified ca_port.<br>\r
+<br>\r
+-t &lt;timeout_ms&gt; override the default timeout for the solicited mads.<br>\r
+<br>\r
+Multiple CA/Multiple Port Support<br>\r
+<br>\r
+When no IB device or port is specified, the port to use is selected by<br>\r
+the following criteria:<br>\r
+<br>\r
+1. the first port that is ACTIVE.<br>\r
+<br>\r
+2. if not found, the first port that is UP (physical link up).<br>\r
+<br>\r
+If a port and/or CA name is specified, the user request is attempted to<br>\r
+be fulfilled, and will fail if it is not possible.<br>\r
+<br>\r
+<br>\r
+EXAMPLES<br>\r
+perfquery # read local port performance counters<br>\r
+<br>\r
+perfquery 32 1 # read performance counters from lid 32, port 1<br>\r
+<br>\r
+perfquery -x 32 1 # read extended performance counters from lid 32, port 1<br>\r
+<br>\r
+perfquery -a 32 # read perf counters from lid 32, all ports<br>\r
+<br>\r
+perfquery -r 32 1 # read performance counters and reset<br>\r
+<br>\r
+perfquery -x -r 32 1 # read extended performance counters and reset<br>\r
+<br>\r
+perfquery -R 0x20 1 # reset performance counters of port 1 only<br>\r
+<br>\r
+perfquery -x -R 0x20 1 # reset extended performance counters of port 1 only<br>\r
+<br>\r
+perfquery -R -a 32 # reset performance counters of all ports<br>\r
+<br>\r
+perfquery -R 32 2 0x0fff # reset only error counters of port 2<br>\r
+<br>\r
+perfquery -R 32 2 0xf000 # reset only non-error counters of port 2<br>\r
+<br>\r
+<br>\r
+AUTHOR<br>\r
+Hal Rosenstock&nbsp;&nbsp;&nbsp; &lt;halr@voltaire.com&gt;<br>\r
+<br>\r
+<br>\r
+OFED March 10, 2009 PERFQUERY(8)</p>\r
+<p align="left"><br>\r
+<a href="#TOP"><font color="#000000">&lt;return-to-top&gt;</font></a></p>\r
+<h3 align="left">&nbsp;</h3>\r
+<h3 align="left"><a name="SAQUERY">SAQUERY</a>(8) OFED Diagnostics</h3>\r
+<p align="left"><br>\r
+NAME<br>\r
+saquery - query InfiniBand subnet administration attributes<br>\r
+<br>\r
+<br>\r
+SYNOPSIS<br>\r
+saquery [-h] [-d] [-p] [-N] [--list | -D] [-S] [-I] [-L] [-l] [-G] [-O]<br>\r
+[-U] [-c] [-s] [-g] [-m] [-x] [-C ca_name] [-P ca_port] [--smkey val]<br>\r
+[-t(imeout) &lt;msec&gt;] [--src-to-dst &lt;src:dst&gt;] [--sgid-to-dgid<br>\r
+&lt;sgid-dgid&gt;] [--node-name-map &lt;node-name-map&gt;] [&lt;name&gt; | &lt;lid&gt; |<br>\r
+&lt;guid&gt;]<br>\r
+<br>\r
+<br>\r
+DESCRIPTION<br>\r
+saquery issues the selected SA query. Node records are queried by<br>\r
+default.<br>\r
+<br>\r
+<br>\r
+OPTIONS<br>\r
+-p get PathRecord info<br>\r
+<br>\r
+-N get NodeRecord info<br>\r
+<br>\r
+--list | -D<br>\r
+get NodeDescriptions of CAs only<br>\r
+<br>\r
+-S get ServiceRecord info<br>\r
+<br>\r
+-I get InformInfoRecord (subscription) info<br>\r
+<br>\r
+-L return the Lids of the name specified<br>\r
+<br>\r
+-l return the unique Lid of the name specified<br>\r
+<br>\r
+-G return the Guids of the name specified<br>\r
+<br>\r
+-O return the name for the Lid specified<br>\r
+<br>\r
+-U return the name for the Guid specified<br>\r
+<br>\r
+-c get the SA\92s class port info<br>\r
+<br>\r
+-s return the PortInfoRecords with isSM or isSMdisabled capability<br>\r
+mask bit on<br>\r
+<br>\r
+-g get multicast group info<br>\r
+<br>\r
+-m get multicast member info. If a group is specified, limit the<br>\r
+output to the group specified and print one line containing only<br>\r
+the GUID and node description for each entry. Example: saquery<br>\r
+-m 0xc000<br>\r
+<br>\r
+-x get LinkRecord info<br>\r
+<br>\r
+--src-to-dst<br>\r
+get a PathRecord for &lt;src:dst&gt; where src and dst are either node<br>\r
+names or LIDs<br>\r
+<br>\r
+--sgid-to-dgid<br>\r
+get a PathRecord for sgid to dgid where both GIDs are in an IPv6<br>\r
+format acceptable to inet_pton(3).<br>\r
+<br>\r
+-C &lt;ca_name&gt;<br>\r
+use the specified ca_name.<br>\r
+<br>\r
+-P &lt;ca_port&gt;<br>\r
+use the specified ca_port.<br>\r
+<br>\r
+--smkey &lt;val&gt;<br>\r
+use SM_Key value for the query. Will be used only with &quot;trusted&quot;<br>\r
+queries. If non-numeric value (like \92x\92) is specified then<br>\r
+saquery will prompt for a value.<br>\r
+<br>\r
+-t, -timeout &lt;msec&gt;<br>\r
+Specify SA query response timeout in milliseconds. Default is<br>\r
+100 milliseconds. You may want to use this option if IB_TIMEOUT<br>\r
+is indicated.<br>\r
+<br>\r
+--node-name-map &lt;node-name-map&gt;<br>\r
+Specify a node name map. The node name map file maps GUIDs to<br>\r
+more user friendly names. See ibnetdiscover(8) for node name<br>\r
+map file format. Only used with the -O and -U options.<br>\r
+<br>\r
+Supported query names (and aliases):<br>\r
+ClassPortInfo (CPI)<br>\r
+NodeRecord (NR) [lid]<br>\r
+PortInfoRecord (PIR) [[lid]/[port]]<br>\r
+SL2VLTableRecord (SL2VL) [[lid]/[in_port]/[out_port]]<br>\r
+PKeyTableRecord (PKTR) [[lid]/[port]/[block]]<br>\r
+VLArbitrationTableRecord (VLAR) [[lid]/[port]/[block]]<br>\r
+InformInfoRecord (IIR)<br>\r
+LinkRecord (LR) [[from_lid]/[from_port]] [[to_lid]/[to_port]]<br>\r
+ServiceRecord (SR)<br>\r
+PathRecord (PR)<br>\r
+MCMemberRecord (MCMR)<br>\r
+LFTRecord (LFTR) [[lid]/[block]]<br>\r
+MFTRecord (MFTR) [[mlid]/[position]/[block]]<br>\r
+<br>\r
+-d enable debugging<br>\r
+<br>\r
+-h show help<br>\r
+<br>\r
+<br>\r
+AUTHORS<br>\r
+Ira Weiny &lt;weiny2@llnl.gov&gt;<br>\r
+<br>\r
+Hal Rosenstock &lt;halr@voltaire.com&gt;<br>\r
+<br>\r
+<br>\r
+OFED October 19, 2008 SAQUERY(8)</p>\r
+<p align="left"><a href="#TOP"><font color="#000000">&lt;return-to-top&gt;</font></a></p>\r
+<p align="left">&nbsp;</p>\r
+<h3 align="left"><a name="SMINFO">SMINFO</a>(8) OFED Diagnostics</h3>\r
+<p align="left"><br>\r
+NAME<br>\r
+sminfo - query InfiniBand SMInfo attribute<br>\r
 <br>\r
-Options:<br>\r
-&nbsp;&nbsp; -d, --ib-dev=&lt;dev&gt; use IB device &lt;dev&gt; (default: first device \r
-found)<br>\r
-&nbsp;&nbsp;&nbsp; -i, --ib-port=&lt;port&gt; use port &lt;port&gt; of IB device (default: \r
-all ports)<br>\r
-&nbsp;&nbsp;&nbsp; -l, --list print only the IB devices names<br>\r
-&nbsp;&nbsp;&nbsp; -v, --verbose print all the attributes of the IB device(s)<br>\r
 <br>\r
-<font color="#000000"><a href="#TOP">&lt;return-to-top&gt;</a></font><br>\r
-&nbsp;</p>\r
-<h3 align="left"><a name="ibstat"></a><br>\r
-ibstat - print InfiniBand stats</h3>\r
-<p align="left">usage: ibstat [OPTIONS] &lt;ca_name&gt; [portnum]<br>\r
+SYNOPSIS<br>\r
+sminfo [-d(ebug)] [-e(rr_show)] -s state -p prio -a activity<br>\r
+[-D(irect)] [-G(uid)] [-C ca_name] [-P ca_port] [-t(imeout) time-<br>\r
+out_ms] [-V(ersion)] [-h(elp)] sm_lid | sm_dr_path [modifier]<br>\r
 <br>\r
-Options:<br>\r
-&nbsp;&nbsp;&nbsp; -d debug<br>\r
-&nbsp;&nbsp;&nbsp; -l list all IB devices<br>\r
-&nbsp;&nbsp;&nbsp; -s print short device summary<br>\r
-&nbsp;&nbsp;&nbsp; -p print port GUIDs<br>\r
-&nbsp;&nbsp;&nbsp; -V print ibstat version information and exit<br>\r
-&nbsp;&nbsp;&nbsp; -h print usage<br>\r
 <br>\r
+DESCRIPTION<br>\r
+Optionally set and display the output of a sminfo query in human read-<br>\r
+able format. The target SM is the one listed in the local port info, or<br>\r
+the SM specified by the optional SM lid or by the SM direct routed<br>\r
+path.<br>\r
+<br>\r
+Note: using sminfo for any purposes other then simple query may be very<br>\r
+dangerous, and may result in a malfunction of the target SM.<br>\r
+<br>\r
+<br>\r
+OPTIONS<br>\r
+-s set SM state<br>\r
+0 - not active<br>\r
+1 - discovering<br>\r
+2 - standby<br>\r
+3 - master<br>\r
+<br>\r
+-p set priority (0-15)<br>\r
+<br>\r
+-a set activity count<br>\r
+<br>\r
+<br>\r
+COMMON OPTIONS<br>\r
+Most OFED diagnostics take the following common flags. The exact list<br>\r
+of supported flags per utility can be found in the usage message and<br>\r
+can be shown using the util_name -h syntax.<br>\r
+<br>\r
+# Debugging flags<br>\r
+<br>\r
+-d raise the IB debugging level.<br>\r
+May be used several times (-ddd or -d -d -d).<br>\r
+<br>\r
+-e show send and receive errors (timeouts and others)<br>\r
+<br>\r
+-h show the usage message<br>\r
+<br>\r
+-v increase the application verbosity level.<br>\r
+May be used several times (-vv or -v -v -v)<br>\r
+<br>\r
+-V show the version info.<br>\r
+<br>\r
+# Addressing flags<br>\r
+<br>\r
+-D use directed path address arguments. The path<br>\r
+is a comma separated list of out ports.<br>\r
 Examples:<br>\r
-&nbsp;&nbsp;&nbsp; ibstat -l # list all IB devices<br>\r
-&nbsp;&nbsp;&nbsp; ibstat mthca0 2 # stat port 2 of mthca0<br>\r
+&quot;0&quot; # self port<br>\r
+&quot;0,1,2,1,4&quot; # out via port 1, then 2, ...<br>\r
 <br>\r
-<font color="#000000"><a href="#TOP">&lt;return-to-top&gt;</a></font><br>\r
+-G use GUID address argument. In most cases, it is the Port GUID.<br>\r
+Example:<br>\r
+&quot;0x08f1040023&quot;<br>\r
+<br>\r
+-s &lt;smlid&gt; use \92smlid\92 as the target lid for SM/SA queries.<br>\r
+<br>\r
+# Other common flags:<br>\r
+<br>\r
+-C &lt;ca_name&gt; use the specified ca_name.<br>\r
+<br>\r
+-P &lt;ca_port&gt; use the specified ca_port.<br>\r
+<br>\r
+-t &lt;timeout_ms&gt; override the default timeout for the solicited mads.<br>\r
+<br>\r
+Multiple CA/Multiple Port Support<br>\r
+<br>\r
+When no IB device or port is specified, the port to use is selected by<br>\r
+the following criteria:<br>\r
+<br>\r
+1. the first port that is ACTIVE.<br>\r
+<br>\r
+2. if not found, the first port that is UP (physical link up).<br>\r
+<br>\r
+If a port and/or CA name is specified, the user request is attempted to<br>\r
+be fulfilled, and will fail if it is not possible.<br>\r
+<br>\r
+<br>\r
+EXAMPLES<br>\r
+sminfo&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; # local port´s sminfo<br>\r
+<br>\r
+sminfo 32&nbsp;&nbsp;&nbsp;&nbsp; # show sminfo of lid 32<br>\r
+<br>\r
+sminfo -G 0x8f1040023&nbsp;&nbsp;&nbsp;&nbsp; # same but using guid address<br>\r
+<br>\r
+<br>\r
+SEE ALSO<br>\r
+smpdump(8)<br>\r
+<br>\r
+<br>\r
+AUTHOR<br>\r
+Hal Rosenstock&nbsp;&nbsp;&nbsp; &lt;halr@voltaire.com&gt;<br>\r
+<br>\r
+OFED July 25, 2006 SMINFO(8)</p>\r
+<p align="left"><br>\r
+<a href="#TOP"><font color="#000000">&lt;<b>return-to-top</b>&gt;</font></a></p>\r
+<h3 align="left">&nbsp;</h3>\r
+<h3 align="left"><a name="SMPDUMP">SMPDUMP</a>(8) OFED Diagnostics</h3>\r
+<p align="left"><br>\r
+NAME<br>\r
+smpdump - dump InfiniBand subnet management attributes<br>\r
+<br>\r
+<br>\r
+SYNOPSIS<br>\r
+smpdump [-s(ring)] [-D(irect)] [-C ca_name] [-P ca_port] [-t(imeout)<br>\r
+timeout_ms] [-V(ersion)] [-h(elp)] &lt;dlid|dr_path&gt; &lt;attr&gt; [mod]<br>\r
+<br>\r
+<br>\r
+DESCRIPTION<br>\r
+smpdump is a general purpose SMP utility which gets SM attributes from<br>\r
+a specified SMA. The result is dumped in hex by default.<br>\r
+<br>\r
+<br>\r
+OPTIONS<br>\r
+attr IBA attribute ID for SM attribute<br>\r
+<br>\r
+mod IBA modifier for SM attribute<br>\r
+<br>\r
+<br>\r
+COMMON OPTIONS<br>\r
+Most OFED diagnostics take the following common flags. The exact list<br>\r
+of supported flags per utility can be found in the usage message and<br>\r
+can be shown using the util_name -h syntax.<br>\r
+<br>\r
+# Debugging flags<br>\r
+<br>\r
+-d raise the IB debugging level.<br>\r
+May be used several times (-ddd or -d -d -d).<br>\r
+<br>\r
+-e show send and receive errors (timeouts and others)<br>\r
+<br>\r
+-h show the usage message<br>\r
+<br>\r
+-v increase the application verbosity level.<br>\r
+May be used several times (-vv or -v -v -v)<br>\r
+<br>\r
+-V show the version info.<br>\r
+<br>\r
+# Addressing flags<br>\r
+<br>\r
+-D use directed path address arguments. The path<br>\r
+is a comma separated list of out ports.<br>\r
+Examples:<br>\r
+&quot;0&quot; # self port<br>\r
+&quot;0,1,2,1,4&quot; # out via port 1, then 2, ...<br>\r
+<br>\r
+-G use GUID address argument. In most cases, it is the Port GUID.<br>\r
+Example:<br>\r
+&quot;0x08f1040023&quot;<br>\r
+<br>\r
+-s &lt;smlid&gt; use \92smlid\92 as the target lid for SM/SA queries.<br>\r
+<br>\r
+# Other common flags:<br>\r
+<br>\r
+-C &lt;ca_name&gt; use the specified ca_name.<br>\r
+<br>\r
+-P &lt;ca_port&gt; use the specified ca_port.<br>\r
+<br>\r
+-t &lt;timeout_ms&gt; override the default timeout for the solicited mads.<br>\r
+<br>\r
+Multiple CA/Multiple Port Support<br>\r
+<br>\r
+When no IB device or port is specified, the port to use is selected by<br>\r
+the following criteria:<br>\r
+<br>\r
+1. the first port that is ACTIVE.<br>\r
+<br>\r
+2. if not found, the first port that is UP (physical link up).<br>\r
+<br>\r
+If a port and/or CA name is specified, the user request is attempted to<br>\r
+be fulfilled, and will fail if it is not possible.<br>\r
+<br>\r
+<br>\r
+EXAMPLES<br>\r
+Direct Routed Examples<br>\r
+<br>\r
+smpdump -D 0,1,2,3,5 16 # NODE DESC<br>\r
+<br>\r
+smpdump -D 0,1,2 0x15 2 # PORT INFO, port 2<br>\r
+<br>\r
+LID Routed Examples<br>\r
+<br>\r
+smpdump 3 0x15 2 # PORT INFO, lid 3 port 2<br>\r
+<br>\r
+smpdump 0xa0 0x11 # NODE INFO, lid 0xa0<br>\r
+<br>\r
+<br>\r
+SEE ALSO<br>\r
+smpquery(8)<br>\r
+<br>\r
+<br>\r
+AUTHOR<br>\r
+Hal Rosenstock&nbsp;&nbsp;&nbsp; &lt;halr@voltaire.com&gt;<br>\r
+<br>\r
+<br>\r
+OFED July 25, 2006 SMPDUMP(8)</p>\r
+<p align="left"><br>\r
+<a href="#TOP"><font color="#000000">&lt;return-to-top&gt;</font></a></p>\r
+<h3 align="left">&nbsp;</h3>\r
+<h3 align="left"><a name="SMPQUERY">SMPQUERY</a>(8) OFED Diagnostics</h3>\r
+<p align="left"><br>\r
+NAME<br>\r
+smpquery - query InfiniBand subnet management attributes<br>\r
+<br>\r
+<br>\r
+SYNOPSIS<br>\r
+smpquery [-d(ebug)] [-e(rr_show)] [-v(erbose)] [-D(irect)] [-G(uid)]<br>\r
+[-C ca_name] [-P ca_port] [-t(imeout) timeout_ms] [--node-name-map<br>\r
+node-name-map] [-V(ersion)] [-h(elp)] &lt;op&gt; &lt;dest dr_path|lid|guid&gt; [op<br>\r
+params]<br>\r
+<br>\r
+<br>\r
+DESCRIPTION<br>\r
+smpquery allows a basic subset of standard SMP queries including the<br>\r
+following: node info, node description, switch info, port info. Fields<br>\r
+are displayed in human readable format.<br>\r
+<br>\r
+<br>\r
+OPTIONS<br>\r
+Current supported operations and their parameters:<br>\r
+nodeinfo &lt;addr&gt;<br>\r
+nodedesc &lt;addr&gt;<br>\r
+portinfo &lt;addr&gt; [&lt;portnum&gt;] # default port is zero<br>\r
+switchinfo &lt;addr&gt;<br>\r
+pkeys &lt;addr&gt; [&lt;portnum&gt;]<br>\r
+sl2vl &lt;addr&gt; [&lt;portnum&gt;]<br>\r
+vlarb &lt;addr&gt; [&lt;portnum&gt;]<br>\r
+guids &lt;addr&gt;<br>\r
+<br>\r
+<br>\r
+--node-name-map &lt;node-name-map&gt;<br>\r
+Specify a node name map. The node name map file maps GUIDs to<br>\r
+more user friendly names. See ibnetdiscover(8) for node name<br>\r
+map file format.<br>\r
+<br>\r
+<br>\r
+COMMON OPTIONS<br>\r
+Most OFED diagnostics take the following common flags. The exact list<br>\r
+of supported flags per utility can be found in the usage message and<br>\r
+can be shown using the util_name -h syntax.<br>\r
+<br>\r
+# Debugging flags<br>\r
+<br>\r
+-d raise the IB debugging level.<br>\r
+May be used several times (-ddd or -d -d -d).<br>\r
+<br>\r
+-e show send and receive errors (timeouts and others)<br>\r
+<br>\r
+-h show the usage message<br>\r
+<br>\r
+-v increase the application verbosity level.<br>\r
+May be used several times (-vv or -v -v -v)<br>\r
+<br>\r
+-V show the version info.<br>\r
+<br>\r
+# Addressing flags<br>\r
+<br>\r
+-D use directed path address arguments. The path<br>\r
+is a comma separated list of out ports.<br>\r
+Examples:<br>\r
+&quot;0&quot; # self port<br>\r
+&quot;0,1,2,1,4&quot; # out via port 1, then 2, ...<br>\r
+<br>\r
+-c use combined route address arguments. The<br>\r
+address is a combination of a LID and a direct route path.<br>\r
+The LID specified is the DLID and the local LID is used<br>\r
+as the DrSLID.<br>\r
+<br>\r
+-G use GUID address argument. In most cases, it is the Port GUID.<br>\r
+Example:<br>\r
+&quot;0x08f1040023&quot;<br>\r
+<br>\r
+-s &lt;smlid&gt; use \92smlid\92 as the target lid for SM/SA queries.<br>\r
+<br>\r
+# Other common flags:<br>\r
+<br>\r
+-C &lt;ca_name&gt; use the specified ca_name.<br>\r
+<br>\r
+-P &lt;ca_port&gt; use the specified ca_port.<br>\r
+<br>\r
+-t &lt;timeout_ms&gt; override the default timeout for the solicited mads.<br>\r
+<br>\r
+Multiple CA/Multiple Port Support<br>\r
+<br>\r
+When no IB device or port is specified, the port to use is selected by<br>\r
+the following criteria:<br>\r
+<br>\r
+1. the first port that is ACTIVE.<br>\r
+<br>\r
+2. if not found, the first port that is UP (physical link up).<br>\r
+<br>\r
+If a port and/or CA name is specified, the user request is attempted to<br>\r
+be fulfilled, and will fail if it is not possible.<br>\r
+<br>\r
+<br>\r
+EXAMPLES<br>\r
+smpquery portinfo 3 1 # portinfo by lid, with port modifier<br>\r
+<br>\r
+smpquery -G switchinfo 0x2C9000100D051 1 # switchinfo by guid<br>\r
+<br>\r
+smpquery -D nodeinfo 0 # nodeinfo by direct route<br>\r
+<br>\r
+smpquery -c nodeinfo 6 0,12 # nodeinfo by combined route<br>\r
+<br>\r
+<br>\r
+SEE ALSO<br>\r
+smpdump(8)<br>\r
+<br>\r
+<br>\r
+AUTHOR<br>\r
+Hal Rosenstock &lt;halr@voltaire.com&gt;<br>\r
+<br>\r
+<br>\r
+OFED March 14, 2007 SMPQUERY(8)</p>\r
+<p align="left"><a href="#TOP"><font color="#000000">&lt;<b><font size="4">return-to-top</font></b>&gt;</font></a></p>\r
+<h3 align="left">&nbsp;</h3>\r
+<h3 align="left"><a name="VENDSTAT">VENDSTAT</a>(8) OFED Diagnostics</h3>\r
+<p align="left">NAME<br>\r
+vendstat - query InfiniBand vendor specific functions<br>\r
+<br>\r
+<br>\r
+SYNOPSIS<br>\r
+vendstat [-d(ebug)] [-G(uid)] [-N] [-w] [-i] [-c &lt;num,num&gt;] [-C ca_name] [-P \r
+ca_port] [-t(imeout) timeout_ms] [-V(ersion)] [-h(elp)] &lt;lid|guid&gt;<br>\r
+<br>\r
+<br>\r
+DESCRIPTION<br>\r
+vendstat uses vendor specific MADs to access beyond the IB spec vendor<br>\r
+specific functionality. Currently, there is support for Mellanox InfiniSwitch-III \r
+(IS3) and InfiniSwitch-IV (IS4).<br>\r
+<br>\r
+<br>\r
+OPTIONS<br>\r
+-N show IS3 general information.<br>\r
+<br>\r
+-w show IS3 port xmit wait counters.<br>\r
+<br>\r
+-i show IS4 counter group info.<br>\r
+<br>\r
+-c &lt;num,num&gt;<br>\r
+configure IS4 counter groups.<br>\r
+<br>\r
+Configure IS4 counter groups 0 and 1. Such configuration is not<br>\r
+persistent across IS4 reboot. First number is for counter group<br>\r
+0 and second is for counter group 1.<br>\r
+<br>\r
+Group 0 counter config values:<br>\r
+0 - PortXmitDataSL0-7<br>\r
+1 - PortXmitDataSL8-15<br>\r
+2 - PortRcvDataSL0-7<br>\r
+<br>\r
+Group 1 counter config values:<br>\r
+1 - PortXmitDataSL8-15<br>\r
+2 - PortRcvDataSL0-7<br>\r
+8 - PortRcvDataSL8-15<br>\r
+<br>\r
+<br>\r
+COMMON OPTIONS<br>\r
+Most OFED diagnostics take the following common flags. The exact list<br>\r
+of supported flags per utility can be found in the usage message and<br>\r
+can be shown using the util_name -h syntax.<br>\r
+<br>\r
+# Debugging flags<br>\r
+<br>\r
+-d raise the IB debugging level.<br>\r
+May be used several times (-ddd or -d -d -d).<br>\r
+<br>\r
+-e show send and receive errors (timeouts and others)<br>\r
+<br>\r
+-h show the usage message<br>\r
+<br>\r
+-v increase the application verbosity level.<br>\r
+May be used several times (-vv or -v -v -v)<br>\r
+<br>\r
+-V show the version info.<br>\r
+<br>\r
+# Addressing flags<br>\r
+<br>\r
+-G use GUID address argument. In most cases, it is the Port GUID.<br>\r
+Example:<br>\r
+&quot;0x08f1040023&quot;<br>\r
+<br>\r
+-s &lt;smlid&gt; use \92smlid\92 as the target lid for SM/SA queries.<br>\r
+<br>\r
+# Other common flags:<br>\r
+<br>\r
+-C &lt;ca_name&gt; use the specified ca_name.<br>\r
+<br>\r
+-P &lt;ca_port&gt; use the specified ca_port.<br>\r
+<br>\r
+-t &lt;timeout_ms&gt; override the default timeout for the solicited mads.<br>\r
+<br>\r
+Multiple CA/Multiple Port Support<br>\r
+<br>\r
+When no IB device or port is specified, the port to use is selected by<br>\r
+the following criteria:<br>\r
+<br>\r
+1. the first port that is ACTIVE.<br>\r
+<br>\r
+2. if not found, the first port that is UP (physical link up).<br>\r
+<br>\r
+If a port and/or CA name is specified, the user request is attempted to<br>\r
+be fulfilled, and will fail if it is not possible.<br>\r
+<br>\r
+<br>\r
+EXAMPLES<br>\r
+vendstat -N 6 # read IS3 general information<br>\r
+<br>\r
+vendstat -w 6 # read IS3 port xmit wait counters<br>\r
+<br>\r
+vendstat -i 6 12 # read IS4 port 12 counter group info<br>\r
+<br>\r
+vendstat -c 0,1 6 12 # configure IS4 port 12 counter groups for PortXmitDataSL<br>\r
+<br>\r
+vendstat -c 2,8 6 12 # configure IS4 port 12 counter groups for PortRcvDataSL<br>\r
+<br>\r
+<br>\r
+AUTHOR<br>\r
+Hal Rosenstock&nbsp;&nbsp;&nbsp; &lt;halr@voltaire.com&gt;<br>\r
+<br>\r
+<br>\r
+OFED April 16, 2009 VENDSTAT(8)</p>\r
+<p align="left"><a href="#TOP"><font color="#000000">&lt;return-to-top&gt;</font></a><br>\r
 &nbsp;</p>\r
 <h3 align="left"><a name="iblimits"></a><br>\r
 ib_limits - Infiniband verbs tests</h3>\r
@@ -424,6 +2254,7 @@ cmtest - Connection Manager Tests</h3>
 </blockquote>\r
 <h4 align="left"><a href="#TOP"><font color="#000000">&lt;return-to-top&gt;</font></a></h4>\r
 <p align="left">&nbsp;</p>\r
+<BLOCKQUOTE></BLOCKQUOTE>\r
 <h3 align="left"><a name="InfiniBand_Partition_Management">InfiniBand Partition \r
 Management</a></h3>\r
 <p align="left"><font face="Times New Roman">The part</font><font face="Times New Roman" size="3"><span style="FONT-SIZE: 12pt">_man.exe \r
@@ -590,6 +2421,7 @@ vstat - HCA Stats and Counters</h3>
 </blockquote>\r
 <h4 align="left"><a href="#TOP"><font color="#000000">&lt;return-to-top&gt;</font></a></h4>\r
 <p align="left">&nbsp;</p>\r
+<BLOCKQUOTE></BLOCKQUOTE>\r
 <h2 align="left"><a name="opensm"></a>Subnet Management with OpenSM Rev: openib-1.2.0</h2>\r
 <hr>\r
 <p align="left">A single running process (opensm.exe) is required to configure \r
@@ -982,6 +2814,7 @@ run on the same HCA port which OpenSM is currently using.</p>
 <h4 align="left"><a href="#TOP"><font color="#000000">&lt;return-to-top&gt;</font></a></h4>\r
 <h3 align="left">&nbsp;</h3>\r
 <h3 align="left"><br>\r
+<BLOCKQUOTE></BLOCKQUOTE>\r
 <a name="ibtrapgen"></a><br>\r
 ibtrapgen - Generate Infiniband subnet management traps</h3>\r
 <p align="left">Usage: ibtrapgen -t|--trap_num &lt;TRAP_NUM&gt; -n|--number &lt;NUM_TRAP_CREATIONS&gt;<br>\r
@@ -1080,6 +2913,7 @@ Options: one of the following optional flows:</p>
 <h4 align="left"><a href="#TOP"><font color="#000000">&lt;return-to-top&gt;</font></a></h4>\r
 <p align="left">&nbsp;</p>\r
 <p align="left">&nbsp;</p>\r
+<BLOCKQUOTE></BLOCKQUOTE>\r
 <h2 align="left"><a name="IPoIB"></a>IPoIB - Internet Protocols over InfiniBand</h2>\r
 <hr>\r
 <p align="left">IPoIB enables the use of Internet Protocol utilities (e.g., ftp, \r
@@ -1108,6 +2942,7 @@ the Local Area Connection to be disabled, then likely your subnet manager
 <h4 align="left"><a href="#TOP"><font color="#000000">&lt;return-to-top&gt;</font></a></h4>\r
 <p align="left">&nbsp;</p>\r
 <p align="left">&nbsp;</p>\r
+<BLOCKQUOTE></BLOCKQUOTE>\r
 <h2 align="left"><a name="winsockdirect"></a>Winsock Direct Service Provider</h2>\r
 <hr>\r
 <p align="left">Winsock Direct (WSD) is Microsoft's proprietary protocol that \r
@@ -1292,6 +3127,7 @@ Manual control is performed via the \Program Files\WinOF\installsp.exe utility.<
 </blockquote>\r
 <h4 align="left"><a href="#TOP"><font color="#000000">&lt;return-to-top&gt;</font></a></h4>\r
 <p align="left">&nbsp;</p>\r
+<BLOCKQUOTE></BLOCKQUOTE>\r
 <h2 align="left"><a name="Network_Direct_Service_Provider">Network Direct \r
 Service Provider</a></h2><hr>\r
 <h3 align="left">Network Direct Service Provider Installation</h3>\r
@@ -1322,6 +3158,7 @@ host)</p>
 <p align="left">See ndping.exe /? for details.</p>\r
 <p align="left"><b><a href="#TOP"><font color="#000000">&lt;return-to-top&gt;</font></a></b></p>\r
 <p align="left">&nbsp;</p>\r
+<BLOCKQUOTE></BLOCKQUOTE>\r
 <h2 align="left"><a name="DAT"></a>Usermode Direct Access Transport and Direct Access Programming \r
 Libraries</h2>\r
 <hr>\r
@@ -1415,9 +3252,9 @@ include</font></p>
                </table>\r
        </div>\r
 </div>\r
-<p align="left"><a href="#TOP"><font color="#000000">&lt;<b>return-to-top</b>&gt;</font></a></p>\r
 <div align="left">\r
-       <h3 align="left"><font face="Courier New" size="3">DAT ENVIRONMENT</font><font face="Courier New" size="2">:</font></h3>\r
+       <h3 align="left"><font face="Courier New" size="3"><br>\r
+       DAT ENVIRONMENT</font><font face="Courier New" size="2">:</font></h3>\r
 </div>\r
 <blockquote>\r
        <p align="left"><font face="Courier New" size="2">DAT/DAPL v1.1 (free-build) \r
@@ -1436,16 +3273,6 @@ include</font></p>
        versions of DAT/DAPL 2.0 runtime libraries, found only on 64-bit systems, \r
        are identified in '%SystemDrive%\%ProgramFiles(x86)%\WinOF' as dat232.dll \r
        and dapl232.dll.</font></p>\r
-       <p align="left"><font face="Courier New" size="2">DAT/DAPL 2.0 (free-build) \r
-       libraries utilize the IBAL (eye-ball) InfiniBand Access Layer Connection \r
-       Manager (CM) to establish IB reliable connections to Windows based system. \r
-       To facilitate DAT v2.0 Windows to Linux InfiniBand communications an interim \r
-       BSD socket based Connection Manager (sock-cm) is provided. The DAPL \r
-       socket-CM provider is installed as '%SystemRoot%\dapl2-scm.dll' and listed \r
-       in the %SystemDrive%\DAT\dat.conf provider file as 'ibnic0v2-scm'. Both \r
-       nodes must use the same Connection Manager IBAL-CM[ibnic0v2: dapl2.dll] or \r
-       Socket-CM[ibnicv2-scm: dapl2-scm.dll] in order for connections to be \r
-       established.</font></p>\r
        <p align="left"><font face="Courier New" size="2">In order for DAT/uDAPL \r
        programs to execute correctly, the runtime library files 'dat.dll and \r
        dapl.dll' must be present in one of the following folders: current \r
@@ -1475,8 +3302,98 @@ include</font></p>
        exist in the DAT default configuration folder '%SystemDrive%\DAT\', dat.conf \r
        will be copied there.<br>\r
 &nbsp;</font></p>\r
-       <p align="left"><b>\r
-<u><a name="DAT_App_Build"></a>DAT application build environment</u>:</b></p>\r
+</blockquote>\r
+<h3 align="left"><u><font face="Times New Roman" size="3">\r
+<a name="DAPL_Providers">DAPL Providers</a></font></u></h3>\r
+<blockquote>\r
+       <p align="left"><font face="Courier New" size="2">DAT 2.0 (free-build) \r
+       libraries utilize the following user application selectable DAPL providers. \r
+       Each DAPL provider represents an RDMA hardware interface device type and \r
+       it's Connection Manager.<br>\r
+       DAPL providers are listed in the file '%SystemDrive%\DAT\dat.conf'.<br>\r
+       The dat.conf InfiniBand DAPL provider names are formatted 'ibnic-HCA#-DAPL_Version-CM_type'.<br>\r
+       Example:<br>\r
+&nbsp;&nbsp;&nbsp; ibnic0v2 - InfiniBand HCA #zero, DAPL version 2.0, (default \r
+       CM is IBAL).<br>\r
+&nbsp;&nbsp;&nbsp; ibnic1v2-scm - InfiniBand HCA #one, DAPL version 2.0, CM is \r
+       'socket-CM'</font></p>\r
+       <p align="left"><font face="Courier New" size="2">Each non-comment line in \r
+       the dat.conf file describes a DAPL provider interface.<br>\r
+       The 2nd to the last field on the right (7th from the left) describes the \r
+       ia_device_params (Interface Adapter Device Parameters) (aka, RDMA device) in \r
+       accordance with the specific DAPL provider specified in the 5th field.\r
+       </font></p>\r
+       <ul>\r
+               <li>\r
+               <p align="left"><font face="Times New Roman"><u>IBAL (eye-ball) DAPL \r
+               Provider</u></font></p>\r
+               <ul>\r
+                       <li>\r
+                       <p align="left"><font face="Courier New" size="2">File: \r
+                       %windir%\dapl2.dll</font></p></li>\r
+                       <li>\r
+                       <p align="left"><font face="Courier New" size="2">dat.conf Provider \r
+                       name: ibnic0v2</font></p></li>\r
+                       <li>\r
+                       <p align="left"><font face="Courier New" size="2">ia_device_params - \r
+                       'IbalHcaX Y' where 'X' is the IB HCA device instance (0 == 1st HCA), \r
+                       Y is the port number (1 == 1st port).</font></p></li>\r
+               </ul>\r
+               <p align="left"><font face="Courier New" size="2">Use the InfiniBand Access Layer Connection \r
+       Manager (CM) to establish InfiniBand reliable connections to Windows based system. \r
+               IBAL is the original DAPL provider.<br>\r
+&nbsp;</font></p></li>\r
+               <li>\r
+               <p align="left"><u>Socket-CM Provider</u></p>\r
+               <ul>\r
+                       <li>\r
+                       <p align="left"><font face="Courier New" size="2">File: %windir%\dapl2-ofa-scm.dll</font></p>\r
+                       </li>\r
+                       <li>\r
+                       <p align="left"><font face="Courier New" size="2"><u>dat.conf</u> \r
+                       Provider name: ibnic0v2-scm</font></p></li>\r
+                       <li>\r
+                       <p align="left"><font face="Courier New" size="2">ia_device_params - \r
+                       &quot;ibv_deviceX Y&quot; where 'X' is the IB HCA device instance (0 == 1st \r
+                       HCA), Y is the port number (1 == 1st port). Socket-CM uses Winverbs \r
+                       hence the ibv_deviceX nomenclature; see ibstat command.</font></p></li>\r
+               </ul>\r
+               <p align="left"><font face="Courier New" size="2">To facilitate DAT v2.0 \r
+               Windows to Linux DAT v2.0 InfiniBand communications, a BSD socket based Connection Manager (sock-cm) is \r
+               supported. Both \r
+       nodes must use the same Connection Manager IBAL-CM[ibnic0v2] or \r
+       Socket-CM[ibnicv2-scm] in order for connections to be \r
+       established. For Linux &lt;==&gt; Windows DAT connections, the DAPL provider must \r
+               be socket-cm or rdma-cm; IBAL DAPL provider is not supported for Linux.<br>\r
+&nbsp;</font></p></li>\r
+               <li>\r
+               <p align="left"><font face="Times New Roman">RDMA-CM Provider</font></p>\r
+               <ul>\r
+                       <li>\r
+                       <p align="left"><font face="Courier New" size="2">File: %windir%\dapl2-ofa-cma.dll</font></p>\r
+                       </li>\r
+                       <li>\r
+                       <p align="left"><font face="Courier New" size="2">dat.conf Provider \r
+                       name: ibnic0v2-cma</font></p></li>\r
+                       <li>\r
+                       <p align="left"><font face="Courier New" size="2">ia_device_params - \r
+                       &quot;rdma_devX Y&quot; where 'X' is the RDMA device instance (future iWARP \r
+                       support, today InfiniBand) with assigned IPv4 address (0 == 1st \r
+                       IPoIB device with an assigned IPv4 address); Y is ignored although \r
+                       there must be a digit present.<br>\r
+                       Alternatively, 'rdma_devX' can be replaced with the IP4v address \r
+                       assigned to an IPoIB device instance. The 'rdma_dev0' is used to \r
+                       instruct the rdma-cm provider to use the 1st RDMA device (IPoIB) \r
+                       with an assigned IP4v address such that the dat.conf file does not \r
+                       have to be tailored for each WinOF installation.</font></p></li>\r
+               </ul>\r
+               <p align="left"><font face="Courier New" size="2">OFED RDMA CM manager \r
+               can be used to establish connections between Windows and/or Linux systems.</font></p></li>\r
+       </ul>\r
+       <p align="left">&nbsp;</p>\r
+</blockquote>\r
+<p align="left"><b><u><a name="DAT_App_Build"></a>DAT application build environment</u>:</b></p>\r
+<blockquote>\r
        <p align="left"><font face="Courier New" size="2">DAT library header files \r
        are selectively installed in the DAT default configuration folder as<br>'%SystemDrive%\DAT\v1-1' \r
        or\r
@@ -1507,9 +3424,9 @@ include</font></p>
                </b>When linking a DEBUG/Checked version make sure to use datd.lib or \r
                dat2d.lib for DAT v2.0.</p>\r
        </blockquote>\r
-       <h4>\r
-<u>DAT library environment variables</u>:<br>\r
-&nbsp;</h4>\r
+</blockquote>\r
+<h4><u>DAT library environment variables</u>:</h4>\r
+<blockquote>\r
        <pre>\r
 DAT_OVERRIDE\r
 ------------\r
@@ -1549,9 +3466,10 @@ DAT_OS_DBG_DEST_ALL    = 0x3
 \r
 For example, 0x3 will output to both stdout and the syslog. \r
 </pre>\r
-       <h4>\r
-<u>DAPL Provider library environment variables</u></h4>\r
-       <p><br><font size="2">DAPL_DBG_TYPE<br>-------------<br><br>\r
+</blockquote>\r
+<h4><u>DAPL Provider library environment variables</u></h4>\r
+<blockquote>\r
+       <p><font size="2">DAPL_DBG_TYPE<br>-------------<br><br>\r
        <font face="Courier New">Value specifies which parts of the registry will print \r
 debugging information, valid values are</font> <br><br></font>\r
        <font face="Courier New"><font size="2">DAPL_DBG_TYPE_ERR&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; = 0x0001<br>DAPL_DBG_TYPE_WARN&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; = 0x0002<br>DAPL_DBG_TYPE_EVD&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; = 0x0004<br>DAPL_DBG_TYPE_CM&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; = 0x0008<br>DAPL_DBG_TYPE_EP&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; = 0x0010<br>DAPL_DBG_TYPE_UTIL&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; = 0x0020<br>DAPL_DBG_TYPE_CALLBACK&nbsp;&nbsp;&nbsp;&nbsp; = 0x0040<br>DAPL_DBG_TYPE_DTO_COMP_ERR = 0x0080<br>DAPL_DBG_TYPE_API&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; = 0x0100<br>DAPL_DBG_TYPE_RTN&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; = 0x0200<br>DAPL_DBG_TYPE_EXCEPTION&nbsp;&nbsp;&nbsp; = 0x0400<br>\r
@@ -1562,6 +3480,7 @@ debugging information, valid values are</font> <br><br></font>
        </font><br><br></p>\r
 <p align="left"><a href="#TOP"><font color="#000000">&lt;<b>return-to-top</b>&gt;</font></a><br></p>\r
 </blockquote><hr>\r
+<BLOCKQUOTE></BLOCKQUOTE>\r
 <h3><a name="DAPLTEST"></a>DAPLTEST</h3>\r
 <pre>\r
 \r
@@ -1849,18 +3768,39 @@ USAGE - Limit test client
                         for a larger number of iterations,\r
                         validating the data received.</pre>\r
 <pre>\r
-dt-svr.bat - DAPLtest server script; starts a DAPLtest server on the local node.\r
-       dt-svr [-D [hex-debug-bitmask] ]</pre>\r
-<pre>\r
-dt-cli.bat - DAPLtest client; drives testing by interacting with dt-svr.bat script.\r
-       dt-cli host-IPv4-address testname\r
-               example: dt-cli 10.10.2.20 trans\r
-                        dt-cli -h  # outputs help text.</pre>\r
+dt-svr.bat - DAPLtest server script; starts a DAPL2test.exe server on the local node.\r
+       dt-svr DAPL-provider [-D [hex-debug-bitmask] ]</pre>\r
+<blockquote>\r
+       <blockquote>\r
+               <pre>where: DAPL-provider can be one of [ ibal | scm | cma ]</pre>\r
+               <blockquote>\r
+                       <ul>\r
+                               <li>\r
+                               <pre>ibal - Original InfiniBand Access Layer (eye-bal) ibal verbs interface</pre>\r
+                               </li>\r
+                               <li>\r
+                               <pre>scm - Socket-CM (Connection Manager), exchanges QP information over a n IP socket.</pre>\r
+                               </li>\r
+                               <li>\r
+                               <pre>cma - rdma CM, use the OFED rdma Communications Manager to create the QP connection.</pre>\r
+                               </li>\r
+                               <li>\r
+                               <pre>or the DAPL-provider name from %SystemDrive%\DAT\dat.conf</pre>\r
+                               </li>\r
+                       </ul>\r
+               </blockquote>\r
+       </blockquote>\r
+</blockquote>\r
+<pre>dt-cli.bat - DAPLtest client; drives testing by interacting with dt-svr.bat script.\r
+       dt-cli DAPL-provider host-IPv4-address testname [-D [hex-debug-bitmask] ]\r
+               example: dt-cli ibnic0v2 10.10.2.20 trans\r
+                        dt-cli -h  # outputs help text.\r
+                        dt-svr ibnic0v2        # IBAL on HCA0</pre>\r
 <pre>\r
 Verify dt-*.bat script is running same dapltest.exe(v1.1) or dapl2test.exe(v2.0)\r
 \r
 \r
-BUGS  (and  To Do List)\r
+BUGS  (and To Do List)\r
 \r
     Use of CNOs (-Q) is not yet supported.\r
 \r
@@ -1868,7 +3808,9 @@ BUGS  (and  To Do List)
 <h4 align="left"><a href="#TOP"><font color="#000000">&lt;return-to-top&gt;</font></a></h4>\r
 <p align="left">&nbsp;</p>\r
 <p align="left">&nbsp;</p>\r
-<h2 align="left"><u><a name="SRP"></a>SRP (SCSI RDMA) Protocol Driver</u></h2>\r
+<BLOCKQUOTE></BLOCKQUOTE>\r
+<h2 align="left"><u><a name="SRP"></a></u>SRP (SCSI RDMA) Protocol Driver</h2>\r
+<hr>\r
 <p align="left"><span style="color: black">\r
 <font face="Times New Roman" size="3">The\r
 <a href="http://infiniband.sourceforge.net/Storage/SRP/overview.htm">SCSI RDMA \r
@@ -1942,7 +3884,9 @@ when the WinOF uninstall attempts to delete the files the operation fails.</p>
 see ib_srp.inf file for details.</p>\r
 <h4 align="left"><a href="#TOP"><font color="#000000" size="4">&lt;return-to-top&gt;</font></a></h4>\r
 <h3>&nbsp;</h3>\r
-<h2><u><a name="QLOGICVNIC"></a>QLogic VNIC Configuration</u></h2>\r
+<BLOCKQUOTE></BLOCKQUOTE>\r
+<h2><u><a name="QLOGICVNIC"></a></u>QLogic VNIC Configuration</h2>\r
+<hr>\r
 <p><font face="Arial">\r
 <span style="font-size: 12pt; font-family: Times New Roman">The QLogic VNIC \r
 (Virtual Network Interface Card) driver in conjunction with the QLogic Ethernet \r
@@ -2024,7 +3968,8 @@ for the setting to take effect.</span></p>
 </font>\r
 <h3>&nbsp;<a href="#TOP"><font color="#000000">&lt;return-to-top&gt;</font></a></h3>\r
 <p>&nbsp;</p>\r
-<h2><u><a name="qlgcvnicconfig"></a>QLogic VNIC Child Device Management</u></h2>\r
+<h2><u><a name="qlgcvnicconfig"></a></u>QLogic VNIC Child Device Management</h2>\r
+<hr>\r
 <p><font face="Arial">\r
 <span style="font-size: 12pt; font-family: Times New Roman">Each I/O Controller (IOC) of QLogic's EVIC gateway \r
 device is able to handle 256 connections per host. So a single host can have multiple VNIC interfaces connecting to the same\r
@@ -2054,8 +3999,10 @@ Executing qlgcvnic_config without any option or with -l option will list the IOC
 \r
 <h3>&nbsp;<a href="#TOP"><font color="#000000">&lt;return-to-top&gt;</font></a></h3>\r
 <p>&nbsp;</p>\r
-<h2><u><a name="InfiniBand_Software_Development_Kit">InfiniBand Software \r
-Development Kit</a></u></h2>\r
+<BLOCKQUOTE></BLOCKQUOTE>\r
+<h2><a name="InfiniBand_Software_Development_Kit">InfiniBand Software \r
+Development Kit</a></h2>\r
+<hr>\r
 <p>If selected during a WinOF install, the IB Software Development Kit will \r
 be installed as '%SystemDrive%\IBSDK'. Underneath the IBSDK\ folder you will find an \r
 include folder 'Inc\',&nbsp; library definition files 'Lib\'&nbsp; along with a \r
@@ -2088,13 +4035,23 @@ include folder 'Inc\',&nbsp; library definition files 'Lib\'&nbsp; along with a
 <p align="left">&nbsp;</p>\r
 <p align="left"><a href="#TOP"><font color="#000000">&lt;<b>return-to-top</b>&gt;</font></a></p>\r
 <p align="left">&nbsp;</p>\r
+<BLOCKQUOTE></BLOCKQUOTE>\r
 <h2><a name="WinVerbs">WinVerbs</a></h2><hr>\r
-<p><br>WinVerbs is a userspace verbs and communication management interface optimized<br>for the Windows operating system. Its lower interface is designed to support<br>any RDMA based device, including Infiniband and iWarp. Its upper interface is<br>capable of providing a low latency verbs interface, plus supports Microsoft's<br>Network Direct Interface, DAPL, and OFED libibverbs interfaces. It consists of<br>a userspace library and a kernel filter driver.<br>\r
-<br>The WinVerbs driver loads as an upper filter driver for Infiniband controllers.<br>(Open source iWarp drivers for Windows are not yet available.) A corresponding<br>userspace library installs as part of the Winverbs driver installation package.<br>Additionally, a Windows port of the OFED libibverbs library and several test<br>programs are also included.<br>\r
+<p>WinVerbs is a userspace verbs and communication management interface optimized<br>for the Windows operating system. Its lower interface is designed to support<br>any RDMA based device, including Infiniband and \r
+future RDMA devices. Its upper interface is<br>capable of providing a low latency verbs interface, plus supports Microsoft's<br>NetworkDirect Interface, DAPL and OFED \r
+components: libibverbs, libibmad, rdma_cm interfaces and numerous OFED IB \r
+diagnostic tools.<br>\r
+<br>The WinVerbs driver loads as an upper filter driver for Infiniband HCA \r
+devices.<br>(Open source iWarp drivers for Windows are not yet available.) A corresponding<br>userspace library installs as part of the Winverbs driver installation package.<br>Additionally, a Windows port of the OFED libibverbs library and several test<br>programs are also included.</p>\r
+<p>As of the WinOF 2.1 release, Winverbs and Winmad are are fully integrated \r
+into the HCA driver stack load.<br>\r
+That's to say, Winverbs and Winmad are now integral components of the WinOF \r
+stack.<br>\r
 <br>Available libibverbs test programs and their usage are listed<br>below. Note that not all listed options apply to all applications<br>\r
 <br>ibv_rc_pingpong, ibv_uc_pingpong, ibv_ud_pingpong<br>no args start a server and wait for connection<br>-h &lt;host&gt;&nbsp;&nbsp;&nbsp;&nbsp; connect to server at &lt;host&gt;<br>-p &lt;port&gt;&nbsp;&nbsp;&nbsp;&nbsp; listen on/connect to port &lt;port&gt; (default 18515)<br>-d &lt;dev&gt;&nbsp;&nbsp;&nbsp;&nbsp; use IB device &lt;dev&gt; (default first device found)<br>-i &lt;port&gt;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; use port &lt;port&gt; of IB device (default 1)<br>-s &lt;size&gt;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; size of message to exchange (default 4096)<br>-m &lt;size&gt;&nbsp;&nbsp;&nbsp;&nbsp; path MTU (default 1024)<br>-r &lt;dep&gt;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; number of receives to post at a time (default 500)<br>-n &lt;iters&gt;&nbsp;&nbsp;&nbsp;&nbsp; number of exchanges (default 1000)<br>-l &lt;sl&gt;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; service level value<br>-e&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; sleep on CQ events (default poll)<br>\r
 <br>ibv_send_bw, ibv_send_lat<br>ibv_read_bw, ibv_read_lat<br>ibv_write_bw, ibv_write_lat<br>no args start a server and wait for connection<br>-h &lt;host&gt;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; connect to server at &lt;host&gt;<br>-p &lt;port&gt;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; listen on/connect to port &lt;port&gt; (default 18515)<br>-d &lt;dev&gt;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; use IB device &lt;dev&gt; (default first device found)<br>-i &lt;port&gt;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; use port &lt;port&gt; of IB device (default 1)<br>-c &lt;RC/UC/UD&gt;&nbsp; connection type RC/UC/UD (default RC)<br>-m &lt;mtu&gt;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; mtu size (256 - 4096. default for hermon is 2048)<br>-s &lt;size&gt;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; size of message to exchange (default 65536)<br>-a&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Run sizes from 2 till 2^23<br>-t &lt;dep&gt;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; size of tx queue (default 300)<br>-g&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; send messages to multicast group (UD only)<br>-r &lt;dep&gt;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; make rx queue bigger than tx (default 600)<br>-n &lt;iters&gt;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; number of exchanges (at least 2, default 1000)<br>-I &lt;size&gt;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; max size of message to be sent in inline mode (default 400)<br>-b&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; measure bidirectional bandwidth (default unidirectional)<br>-V&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; display version number<br>-e&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; sleep on CQ events (default poll)<br>-N&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; cancel peak-bw calculation (default with peak-bw)<br>\r
-<br>To verify correct WinVerbs and libibverbs installation, run ibv_devinfo. It<br>should report all RDMA devices in the system, along with limited port<br>attributes. Because of limitations in the WinOF stack, it is normal for it to<br>list several values as unknown.</p>\r
+<br>To verify correct WinVerbs and libibverbs installation, run ibstat or ibv_devinfo. It<br>should report all RDMA devices in the system, along with limited port<br>attributes. Because of limitations in the WinOF stack \r
+in comparision to the Linux OFED stack, it is normal for the programs to<br>list several values as unknown.</p>\r
 <p><a href="#TOP"><font color="#000000">&lt;<b>return-to-top</b>&gt;</font></a></p>\r
 \r
 \r