From: Roman Bogorodskiy <bogorodskiy@gmail.com>
Date: Mon, 24 Nov 2025 18:35:00 +0000 (+0100)
Subject: docs: drvbhyve: document SLIRP networking
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=437c135671d74e352c9fd01652ee8625aa9bb5d1;p=thirdparty%2Flibvirt.git

docs: drvbhyve: document SLIRP networking

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

diff --git a/docs/drvbhyve.rst b/docs/drvbhyve.rst
index c0f4cd8a1f..dfcdb011d2 100644
--- a/docs/drvbhyve.rst
+++ b/docs/drvbhyve.rst
@@ -694,6 +694,30 @@ 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.
 
+SLIRP networking
+~~~~~~~~~~~~~~~~
+:since:`Since 12.0.0`, it is possible to use SLIRP networking.
+
+Example:
+
+::
+
+  ...
+    <interface type='user'>
+      <model type='e1000'/>
+    </interface>
+  ...
+
+Then the guest will have external network connectivity without
+any configuration on the host.
+
+.. note::
+   This configuration requires SLIRP open mode support by ``bhyve``.
+   It was introduced in FreeBSD -CURRENT in this commit:
+   https://cgit.FreeBSD.org/src/commit/?id=0e62ebd20172f67283bac9526c2aaeaffeb41b45.
+   Unfortunately, there is no (easy) way to probe its support in libvirt,
+   so please consult the ``bhyve(8)`` manual page to make sure it is available.
+
 Guest-specific considerations
 -----------------------------