From: Roman Bogorodskiy <bogorodskiy@gmail.com>
Date: Sat, 8 Nov 2025 14:22:48 +0000 (+0100)
Subject: docs: drvbhyve: add guest-specific nodes section
X-Git-Tag: CVE-2025-12748~13
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=f81e5158d43ec8fa2f897757c8e4677641787558;p=thirdparty%2Flibvirt.git

docs: drvbhyve: add guest-specific nodes section

Add a section with guest-specific notes. Start with LPC slot address
information for the Windows guests.

Signed-off-by: Roman Bogorodskiy <bogorodskiy@gmail.com>
Reviewed-by: Michal Privoznik <mprivozn@redhat.com>
---

diff --git a/docs/drvbhyve.rst b/docs/drvbhyve.rst
index 3efbc03ce5..73372ff7cf 100644
--- a/docs/drvbhyve.rst
+++ b/docs/drvbhyve.rst
@@ -683,3 +683,19 @@ on FreeBSD.
 Users must configure the device for passthrough manually either by
 using ``devctl(8)`` or by setting ``pptdevs`` in ``loader.conf(5)``.
 Please refer to the ``vmm(4)`` manual page for more details.
+
+Guest-specific considerations
+-----------------------------
+
+Windows
+~~~~~~~
+
+For Windows guests, it is recommended to have the LPC controller on slot 31.
+As the libvirt driver allocates slot 1 for the LPC controller by default,
+the address must be specified explicitly:
+
+::
+
+    <controller type='isa' index='0'>
+      <address type='pci' domain='0x0000' bus='0x00' slot='0x1f' function='0x0'/>
+    </controller>