mirror of
https://gitlab.com/libvirt/libvirt.git
synced 2024-08-28 19:41:16 +00:00
docs: documentation for vfio-ccw passthrough
Signed-off-by: Shalini Chellathurai Saroja <shalini@linux.vnet.ibm.com> Reviewed-by: Bjoern Walk <bwalk@linux.ibm.com> Reviewed-by: Boris Fiuczynski <fiuczy@linux.ibm.com> Reviewed-by: John Ferlan <jferlan@redhat.com>
This commit is contained in:
parent
21442874cf
commit
9c0981ea2e
@ -334,9 +334,28 @@
|
|||||||
<pre>
|
<pre>
|
||||||
$ ls /sys/class/mdev_bus/<device>/mdev_supported_types</pre>
|
$ ls /sys/class/mdev_bus/<device>/mdev_supported_types</pre>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
Before creating a mediated device, unbind the device from the respective
|
||||||
|
device driver, eg. subchannel I/O driver for a CCW device. Then bind the
|
||||||
|
device to the respective VFIO driver. For a CCW device, also unbind the
|
||||||
|
corresponding subchannel of the CCW device from the subchannel I/O driver
|
||||||
|
and then bind the subchannel (instead of the CCW device) to the vfio_ccw
|
||||||
|
driver. The below example shows the unbinding and binding steps for a CCW
|
||||||
|
device.
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<pre>
|
||||||
|
device="0.0.1234"
|
||||||
|
subchannel="0.0.0123"
|
||||||
|
echo $device > /sys/bus/ccw/devices/$device/driver/unbind
|
||||||
|
echo $subchannel > /sys/bus/css/devices/$subchannel/driver/unbind
|
||||||
|
echo $subchannel > /sys/bus/css/drivers/vfio_ccw/bind
|
||||||
|
</pre>
|
||||||
|
|
||||||
<p>
|
<p>
|
||||||
To manually instantiate a mediated device, use one of the following as a
|
To manually instantiate a mediated device, use one of the following as a
|
||||||
reference:
|
reference. For a CCW device, use the subchannel ID instead of the device
|
||||||
|
ID.
|
||||||
</p>
|
</p>
|
||||||
|
|
||||||
<pre>
|
<pre>
|
||||||
|
@ -4350,6 +4350,12 @@
|
|||||||
<address uuid='c2177883-f1bb-47f0-914d-32a22e3a8804'/>
|
<address uuid='c2177883-f1bb-47f0-914d-32a22e3a8804'/>
|
||||||
</source>
|
</source>
|
||||||
</hostdev>
|
</hostdev>
|
||||||
|
<hostdev mode='subsystem' type='mdev' model='vfio-ccw'>
|
||||||
|
<source>
|
||||||
|
<address uuid='9063cba3-ecef-47b6-abcf-3fef4fdcad85'/>
|
||||||
|
</source>
|
||||||
|
<address type='ccw' cssid='0xfe' ssid='0x0' devno='0x0001'/>
|
||||||
|
</hostdev>
|
||||||
</devices>
|
</devices>
|
||||||
...</pre>
|
...</pre>
|
||||||
|
|
||||||
@ -4401,10 +4407,13 @@
|
|||||||
<dd>For mediated devices (<span class="since">Since 3.2.0</span>)
|
<dd>For mediated devices (<span class="since">Since 3.2.0</span>)
|
||||||
the <code>model</code> attribute specifies the device API which
|
the <code>model</code> attribute specifies the device API which
|
||||||
determines how the host's vfio driver will expose the device to the
|
determines how the host's vfio driver will expose the device to the
|
||||||
guest. Currently, only <code>model='vfio-pci'</code> is supported.
|
guest. Currently, <code>model='vfio-pci'</code> and
|
||||||
There are also some implications on the usage of guest's address type
|
<code>model='vfio-ccw'</code> (<span class="since">Since 4.4.0</span>)
|
||||||
depending on the <code>model</code> attribute, see the
|
is supported. Refer <a href="drvnodedev.html#MDEV">MDEV</a> to create
|
||||||
<code>address</code> element below.</dd>
|
a mediated device on the host. There are also some implications on the
|
||||||
|
usage of guest's address type depending on the <code>model</code>
|
||||||
|
attribute, see the <code>address</code> element below.
|
||||||
|
</dd>
|
||||||
</dl>
|
</dl>
|
||||||
<p>
|
<p>
|
||||||
Note: The <code>managed</code> attribute is only used with
|
Note: The <code>managed</code> attribute is only used with
|
||||||
@ -4536,7 +4545,8 @@
|
|||||||
devices defining an allocation of resources on the physical parent device,
|
devices defining an allocation of resources on the physical parent device,
|
||||||
the address type used must conform to the <code>model</code> attribute
|
the address type used must conform to the <code>model</code> attribute
|
||||||
of element <code>hostdev</code>, e.g. any address type other than PCI for
|
of element <code>hostdev</code>, e.g. any address type other than PCI for
|
||||||
<code>vfio-pci</code> device API will result in an error.
|
<code>vfio-pci</code> device API or any address type other than CCW for
|
||||||
|
<code>vfio-ccw</code> device API will result in an error.
|
||||||
<a href="#elementsAddress">See above</a> for more details on the address
|
<a href="#elementsAddress">See above</a> for more details on the address
|
||||||
element.</dd>
|
element.</dd>
|
||||||
<dt><code>driver</code></dt>
|
<dt><code>driver</code></dt>
|
||||||
|
Loading…
Reference in New Issue
Block a user