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(a)redhat.com&gt; --- docs/pci-hotplug.html.in | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/docs/pci-hotplug.html.in b/docs/pci-hotplug.html.in index 6e0648ee2..4ac87d644 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 --