[libvirt] [PATCH v4 9/9] docs: Add vhost-scsi

[Eric Farman]

On 11/22/2016 04:16 PM, John Ferlan wrote:
>
> On 11/21/2016 10:58 PM, Eric Farman wrote:
>> Signed-off-by: Eric Farman <farman at linux.vnet.ibm.com>
>> ---
>>   docs/formatdomain.html.in | 24 ++++++++++++++++++++++++
>>   1 file changed, 24 insertions(+)
>>
> This will get squashed in with the conf patch. I'll also generate the
> news.html.in entry:
>
>            <li>vhost-scsi: Add support scsi_host hostdev passthrough<br/>
>            Add the capability to pass through a scsi_host HBA and the
>            associated LUNs to the guest.
>            </li>
>
>
> ACK -
>
> I'll push these in a bit, just seeing what I get on my test system... Of
> course I'm also curious what would happen if I try to pass through a
> vHBA ;-)...

Many thanks, John!  And let me know if that bubbles up your list; I'm 
curious what would happen too.  :-)

  - Eric

>
>
> John
>> diff --git a/docs/formatdomain.html.in b/docs/formatdomain.html.in
>> index 4e40aa1..6bd02cc 100644
>> --- a/docs/formatdomain.html.in
>> +++ b/docs/formatdomain.html.in
>> @@ -3694,6 +3694,17 @@
>>   </devices>
>>   ...</pre>
>>   
>> +    <p>or:</p>
>> +
>> +<pre>
>> +  ...
>> +  <devices>
>> +    <hostdev mode='subsystem' type='scsi_host'>
>> +      <source protocol='vhost' wwpn='naa.50014057667280d8'/>
>> +    </hostdev>
>> +  </devices>
>> +  ...</pre>
>> +
>>       <dl>
>>         <dt><code>hostdev</code></dt>
>>         <dd>The <code>hostdev</code> element is the main container for describing
>> @@ -3732,6 +3743,12 @@
>>               If a disk lun in the domain already has the rawio capability,
>>               then this setting not required.
>>             </dd>
>> +          <dt><code>scsi_host</code></dt>
>> +          <dd><span class="since">since 2.5.0</span>For SCSI devices, user
>> +            is responsible to make sure the device is not used by host. This
>> +            <code>type</code> passes all LUNs presented by a single HBA to
>> +            the guest.
>> +          </dd>
>>           </dl>
>>           <p>
>>             Note: The <code>managed</code> attribute is only used with PCI devices
>> @@ -3795,6 +3812,13 @@
>>               credentials to the iSCSI server.
>>               </p>
>>             </dd>
>> +          <dt><code>scsi_host</code></dt>
>> +          <dd><span class="since">Since 2.5.0</span>, multiple LUNs behind a
>> +            single SCSI HBA are described by a <code>protocol</code>
>> +            attribute set to "vhost" and a <code>wwpn</code> attribute that
>> +            is the vhost_scsi wwpn (16 hexadecimal digits with a prefix of
>> +            "naa.") established in the host configfs.
>> +          </dd>
>>           </dl>
>>         </dd>
>>         <dt><code>vendor</code>, <code>product</code></dt>
>>