[libvirt] [PATCH v2 4/4] formatdomain.html.in: document <address type='none'/>

Daniel Henrique Barboza danielhb413 at gmail.com
Thu Nov 21 22:19:17 UTC 2019

Signed-off-by: Daniel Henrique Barboza <danielhb413 at gmail.com>
 docs/formatdomain.html.in | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/docs/formatdomain.html.in b/docs/formatdomain.html.in
index a1042a314c..65012aac88 100644
--- a/docs/formatdomain.html.in
+++ b/docs/formatdomain.html.in
@@ -4137,6 +4137,21 @@
         attributes: <code>iobase</code> and <code>irq</code>.
         <span class="since">Since 1.2.1</span>
+      <dt><code>none</code></dt>
+      <dd>For PCI hostdevs, <code><address type='none'/></code> has
+        a special meaning. A PCI hostdev must be assigned to the domain
+        with all the devices of its IOMMU group. If the admin so chooses,
+        it is possible to filter which devices the guest OS will actually
+        see, while the Libvirt domain is retaining ownership of all the
+        devices of the IOMMU group. Passing address type <code>none</code>
+        in such cases will tell Libvirt that the device must not be
+        assigned to the guest. This avoids scenarios in which the admin
+        might be compelled to use a ACS patch to remove the device
+        from the guest.
+        <code><address type='none'/></code> is an invalid address
+        type for all other device types.
+        <span class="since">Since 5.10.0</span>
+      </dd>
     <h4><a id="elementsVirtio">Virtio-related options</a></h4>

More information about the libvir-list mailing list