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

[John Ferlan]

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 ;-)...


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>
>