From: Andrea Bolognani <abologna@redhat.com>
Date: Mon, 19 Feb 2018 16:37:17 +0000 (+0100)
Subject: docs: Document pcie-root requirement for q35 guests
X-Git-Url: http://xenbits.xensource.com/gitweb?a=commitdiff_plain;h=210385c3ee915dd44a43698c03d08d2f574150a5;p=libvirt.git

docs: Document pcie-root requirement for q35 guests

When you add a bunch of pcie-root-port controllers to a q35 guest
in order to have hotplug capabilities, you also need to make sure
you're adding the pcie-root controller at the same time or you
will get an error. Document this fact.

Signed-off-by: Andrea Bolognani <abologna@redhat.com>
Reviewed-by: Daniel P. Berrangé <berrange@redhat.com>
---

diff --git a/docs/pci-hotplug.html.in b/docs/pci-hotplug.html.in
index 6e0648ee26..4ac87d644f 100644
--- a/docs/pci-hotplug.html.in
+++ b/docs/pci-hotplug.html.in
@@ -72,6 +72,7 @@
     </p>
 
 <pre>
+&lt;controller type='pci' model='pcie-root'/&gt;
 &lt;controller type='pci' model='pcie-root-port'/&gt;
 &lt;controller type='pci' model='pcie-root-port'/&gt;
 &lt;controller type='pci' model='pcie-root-port'/&gt;</pre>
@@ -80,7 +81,10 @@
       if you expect to hotplug up to three PCI Express devices,
       either emulated or assigned from the host. That's all the
       information you need to provide: libvirt will fill in the
-      remaining details automatically.
+      remaining details automatically. Note that you need to add
+      the <code>pcie-root</code> controller along with the
+      <code>pcie-root-port</code> controllers or you will get an
+      error.
     </p>
     <p>
       Note that if you're adding PCI controllers to a guest and at