Re: [libvirt] docs: Document the new hostdev and address type 'mdev'

On 20/02/17 15:28 +0100, Erik Skultety wrote: > Signed-off-by: Erik Skultety <eskultet(a)redhat.com&gt; > --- > docs/formatdomain.html.in | 48 +++++++++++++++++++++++++++++++++++++++++++---- > 1 file changed, 44 insertions(+), 4 deletions(-) > > diff --git a/docs/formatdomain.html.in b/docs/formatdomain.html.in > index b69bd4c..13cb767 100644 > --- a/docs/formatdomain.html.in > +++ b/docs/formatdomain.html.in > @@ -3277,8 +3277,20 @@ > attributes: <code>iobase</code> and <code>irq</code>. > <span class="since">Since 1.2.1</span> > </dd> > + <dt><code>mdev</code></dt> > + <dd>Mediated devices' addresses have so far only one mandatory attribute > + <code>uuid</code> (<span class="since">since 3.1.0</span>) which > + uniquely identifies a mediated device under the syfs file system. > + </dd> > </dl> > > + <p> > + Note: Due to nature of mediated devices, being only software devices > + defining an allocation of resources on the physical parent device, the > + address type <code>mdev</code> is supposed to be used to identify a > + device on the host only, rather than identifying it in the guest. > + </p> > + > <h4><a name="elementsControllers">Controllers</a></h4> > > <p> > @@ -3774,6 +3786,19 @@ > &lt;/devices&gt; > ...</pre> > > + <p>or:</p> > + > +<pre> > + ... > + &lt;devices&gt; > + &lt;hostdev mode='subsystem' type='mdev' model='vfio-pci'&gt; > + &lt;source&gt; > + &lt;address type='mdev' uuid='c2177883-f1bb-47f0-914d-32a22e3a8804'&gt; > + &lt;/source&gt; > + &lt;/hostdev&gt; > + &lt;/devices&gt; > + ...</pre> Can't really test it yet, but from the docs/code seems to be OK for oVirt.