git: 489f9ed6a0a6 - stable/15 - bhyve: document missing options in bhyve_config(5)

Roman Bogorodskiy <[email protected]>
Newsgroups gmane.os.freebsd.devel.cvs.src
Message-ID <6a893093.1bde3.6073e24f__11986.7929069855$1787375789$gmane$org@gitrepo.freebsd.org>
The branch stable/15 has been updated by novel:

URL: https://cgit.FreeBSD.org/src/commit/?id=489f9ed6a0a63dfd100247e51bfccba706564cb4

commit 489f9ed6a0a63dfd100247e51bfccba706564cb4
Author:     Roman Bogorodskiy <[email protected]>
AuthorDate: 2026-07-22 17:02:47 +0000
Commit:     Roman Bogorodskiy <[email protected]>
CommitDate: 2026-08-22 05:06:07 +0000

    bhyve: document missing options in bhyve_config(5)
    
    Document a few options that are currently supported but
    not covered in bhyve_config(5):
    
     - vcpu.N.cpuset
     - domains.N.{size,cpus,domain_policy}
     - console (for arm64 and riscv)
    
    MFC after:              1 week
    Reviewed by:            bnovkov, jhb
    Sponsored by:           The FreeBSD Foundation
    Differential Revision:  https://reviews.freebsd.org/D58399
    
    (cherry picked from commit a257e2dc9c6ecd3db41e1aa27a5297a0f328694a)
---
 usr.sbin/bhyve/bhyve_config.5 | 45 +++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 43 insertions(+), 2 deletions(-)

diff --git a/usr.sbin/bhyve/bhyve_config.5 b/usr.sbin/bhyve/bhyve_config.5
index 6460ce8dd909..bddfa6d888ab 100644
--- a/usr.sbin/bhyve/bhyve_config.5
+++ b/usr.sbin/bhyve/bhyve_config.5
@@ -23,7 +23,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd December 26, 2025
+.Dd August 14, 2026
 .Dt BHYVE_CONFIG 5
 .Os
 .Sh NAME
@@ -225,9 +225,13 @@ This value is used for the guest's System Management BIOS System Information str
 Stock keeping unit of the chassis.
 It's also called product ID or purchase order number.
 This value is used for the guest's System Management BIOS System Information structure.
+.It Va vcpu.N.cpuset Ta string Ta none Ta
+Comma-separated host CPU IDs and ranges to which virtual CPU
+.Em N
+is pinned.
 .El
 .Ss x86-Specific Settings
-.Bl -column "x86.vmexit_on_pause" "integer" "Default"
+.Bl -column "domains.N.domain_policy" "integer" "Default"
 .It Sy Name Ta Sy Format Ta Sy Default Ta Sy Description
 .It Va x86.mptable Ta bool Ta true Ta
 Generate an MPTable.
@@ -254,6 +258,43 @@ This allows idle guest CPUs to yield the host CPU.
 Force a VM exit when a guest CPU executes the
 .Dv PAUSE
 instruction.
+.It Va domains.N.size Ta string Ta Ta
+Guest physical memory size assigned to NUMA domain
+.Em N .
+The value must be formatted as described in
+.Xr expand_number 3 .
+If at least one NUMA domain is configured without a memory size,
+the configured guest memory is split evenly across all configured domains.
+.It Va domains.N.cpus Ta string Ta Ta
+Comma-separated guest CPU IDs and ranges assigned to NUMA domain
+.Em N .
+This setting is required for each configured NUMA domain.
+.It Va domains.N.domain_policy Ta string Ta Ta
+Host NUMA memory allocation policy for the memory backing NUMA domain
+.Em N .
+The value uses the policy format accepted by
+.Xr cpuset 1
+with the
+.Fl n
+option.
+.El
+.Ss arm64 and RISC-V Specific Settings
+.Bl -column "console" "string" "Default"
+.It Sy Name Ta Sy Format Ta Sy Default Ta Sy Description
+.It Va console Ta string Ta Ta
+Backend device for the console.
+Supported backends are a character device pathname,
+.Dq stdio ,
+and
+.Ql tcp=ip:port .
+The
+.Dq stdio
+backend uses standard input and output of the
+.Xr bhyve 8
+process.
+The
+.Ql tcp=ip:port
+backend listens for TCP connections.
 .El
 .Sh DEVICE SETTINGS
 Device settings are stored under a device node.
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.