[libvirt] [PATCH v3 4/6] formatdomain.html.in: document <address type='unassigned'/>

Daniel Henrique Barboza danielhb413 at gmail.com
Tue Nov 26 13:33:59 UTC 2019


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

diff --git a/docs/formatdomain.html.in b/docs/formatdomain.html.in
index 6df4a8b26e..7625265ba8 100644
--- a/docs/formatdomain.html.in
+++ b/docs/formatdomain.html.in
@@ -4148,6 +4148,20 @@
         attributes: <code>iobase</code> and <code>irq</code>.
         <span class="since">Since 1.2.1</span>
       </dd>
+      <dt><code>unassigned</code></dt>
+      <dd>For PCI hostdevs, <code><address type='unassigned'/></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. Using this address type 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='unassigned'/></code> is an invalid address
+        type for all other device types.
+        <span class="since">Since 5.11.0</span>
+      </dd>
     </dl>
 
     <h4><a id="elementsVirtio">Virtio-related options</a></h4>
-- 
2.23.0





More information about the libvir-list mailing list