From f4751e23d329419b6b65c0657604ea38071c1ea2 Mon Sep 17 00:00:00 2001 From: Roman Bogorodskiy Date: Sat, 8 Nov 2025 14:25:00 +0100 Subject: [PATCH] docs: drvbhyve: document device passthrough Signed-off-by: Roman Bogorodskiy Reviewed-by: Michal Privoznik --- docs/drvbhyve.rst | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) 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: + +:: + + ... + + +
+ + + ... + +Using passthrough devices requires wiring guest memory, see `Wiring guest memory`_. + +Note: currently, the `nodedev `_ 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. -- 2.47.3