From: Roman Bogorodskiy <bogorodskiy@gmail.com>
Date: Sat, 8 Nov 2025 13:25:00 +0000 (+0100)
Subject: docs: drvbhyve: document device passthrough
X-Git-Tag: CVE-2025-12748~15
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=f4751e23d329419b6b65c0657604ea38071c1ea2;p=thirdparty%2Flibvirt.git

docs: drvbhyve: document device passthrough

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 9db17e55e3..94f6b65d77 100644
--- a/docs/drvbhyve.rst
+++ b/docs/drvbhyve.rst
@@ -659,3 +659,27 @@ As ``bhyve(1)`` uses one NVMe device per PCI address, it's modeled in a way
 that there is one device per controller. That is, if using more than one
 NVMe device, for device name users should increment controller number rather
 than namespace number, i.e.: ``nvme0n1``, ``nvme1n1``, etc.
+
+Device passthrough
+~~~~~~~~~~~~~~~~~~
+:since:`Since 11.10.0`, it is possible to passthrough PCI devices.
+
+Example:
+
+::
+
+  ...
+    <hostdev mode='subsystem' type='pci' managed='no'>
+      <source>
+        <address domain='0x0000' bus='0x01' slot='0x00' function='0x0'/>
+      </source>
+    </hostdev>
+  ...
+
+Using passthrough devices requires wiring guest memory, see `Wiring guest memory`_.
+
+Note: currently, the `nodedev <drvnodedev.html>`_ driver is not supported
+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.