From: Roman Bogorodskiy <bogorodskiy@gmail.com>
Date: Sun, 8 Mar 2026 05:03:29 +0000 (+0100)
Subject: docs: bhyve: document NUMA domains configuration
X-Git-Tag: v12.2.0-rc1~92
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=d760c5c12e2ef4c32773fb6b6dc690d2fc3acc5a;p=thirdparty%2Flibvirt.git

docs: bhyve: document NUMA domains configuration

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 f4aec9ffad..3924a947c5 100644
--- a/docs/drvbhyve.rst
+++ b/docs/drvbhyve.rst
@@ -757,6 +757,32 @@ Example:
     ...
   </domain>
 
+NUMA domains configuration
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+:since:`Since 12.2.0`, it is possible to configure NUMA domains
+for the guest.
+
+Example:
+
+::
+
+  <domain type='bhyve'>
+    ...
+    <memory unit='KiB'>4194304</memory>
+    <vcpu>8</vcpu>
+    ...
+    <cpu>
+      <numa>
+        <cell id='0' cpus='0-3' memory='2097152' unit='KiB'/>
+        <cell id='1' cpus='4-7' memory='2097152' unit='KiB'/>
+      </numa>
+    </cpu>
+  </domain>
+
+Every NUMA domain must have `memory` and `cpus` specified.
+Bhyve allows configuring up to 8 NUMA domains.
+
 Guest-specific considerations
 -----------------------------