[DOCS] added QLogic VNIC Child Device Management discussion.
authorstansmith <stansmith@ad392aa1-c5ef-ae45-8dd8-e69d62a5ef86>
Tue, 17 Mar 2009 16:46:30 +0000 (16:46 +0000)
committerstansmith <stansmith@ad392aa1-c5ef-ae45-8dd8-e69d62a5ef86>
Tue, 17 Mar 2009 16:46:30 +0000 (16:46 +0000)
git-svn-id: svn://openib.tc.cornell.edu/gen1/trunk@2035 ad392aa1-c5ef-ae45-8dd8-e69d62a5ef86

docs/Manual.htm

index e7a0b9c..b01b505 100644 (file)
@@ -13,9 +13,9 @@ div.Section1
 <a href="#TOP"></a> </h1>\r
 <h1 align="center">Windows OpenFabrics </h1>\r
 <h1 align="center">User's Manual</h1>\r
-<h2 align="center">Release 2.0</h2>\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 -->01/06/2009<!--webbot bot="Timestamp" endspan i-checksum="12592" --></h3>\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
 <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
@@ -130,6 +130,12 @@ style='background-position: 0% 0%; mso-highlight:yellow; background-image:none;
                        <p align="left"><a href="#ibtrapgen">ib_trapgen</a>&nbsp;&nbsp;&nbsp;&nbsp; Generate Infiniband Subnet \r
        Management Traps for testing purposes</li>\r
                </ul>\r
+       <h4 align="left"><u>QLogic VNIC Child Device Management</u></h4>\r
+               <ul>\r
+                       <li>\r
+                       <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
                <ul>\r
                        <li>\r
@@ -2016,6 +2022,36 @@ MTU for a VNIC interface is set to&nbsp;<span class="899314318-23042008">4</span
 the MTU at the EVIC module must also be set at least&nbsp;<span class="899314318-23042008">4</span>000 \r
 for the setting to take effect.</span></p>\r
 </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
+<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
+IOC. So qlgcvnic_config can be used to create multiple VNIC interfaces by giving local channel adapter node guid and \r
+target ioc guid parameters as input.<br> </span></p>\r
+<p class="MsoPlainText" style="MARGIN: 0in 0in 0pt">\r
+<span style="font-size: 12pt; font-family: Times New Roman">\r
+Usage:--\r
+<br><br>\r
+<span style="text-decoration: underline;">To create child vnic devices</span>\r
+<br><br>\r
+qlgcvnic_config -c {caguid}&nbsp;&nbsp;{iocguid}&nbsp;&nbsp;{instanceid}&nbsp;&nbsp;{interface description}\r
+<br><br>\r
+caguid -- Local HCA node guid value in hex format (may start with "0x")\r
+<br>\r
+iocguid -- Target IOC's guid vale in hex format (may start with "0x")\r
+<br>\r
+instanceid -- InstanceID is used to distinguish between different child devices created by IBAL. So this must be a unique \r
+value. InstanceID is a 32bit value. User input should be in decimal format.\r
+<br>\r
+interface description -- Description that should be shown in device manager's device tree for the child device.\r
+<br><br>\r
+<span style="text-decoration: underline;">Listing Channel Adapter to IOC paths</span>\r
+<br><br>\r
+Executing qlgcvnic_config without any option or with -l option will list the IOCs reachable from the host.\r
+<br>\r
+\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