Date: Mon, 10 Aug 2026 16:08:00 +0000 From: "Bojan Novković" <bnovkov@FreeBSD.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-branches@FreeBSD.org Subject: git: bb68e4ac1250 - stable/15 - bhyve: Document vCPU range pinning Message-ID: <6a79f760.36896.68124f3e@gitrepo.freebsd.org>
index | next in thread | raw e-mail
The branch stable/15 has been updated by bnovkov: URL: https://cgit.FreeBSD.org/src/commit/?id=bb68e4ac1250cd764681db501db36daf6757ea9a commit bb68e4ac1250cd764681db501db36daf6757ea9a Author: Bojan Novković <bnovkov@FreeBSD.org> AuthorDate: 2026-06-05 17:31:01 +0000 Commit: Bojan Novković <bnovkov@FreeBSD.org> CommitDate: 2026-08-10 16:04:23 +0000 bhyve: Document vCPU range pinning This change documents the recently introduced changes to -p that allow users to specify CPU ranges instead of having to specify each individual mapping. While we're here, move the -p examples to the EXAMPLES section. Reviewed by: bcr MFC after: 2 weeks Differential Revision: https://reviews.freebsd.org/D57480 (cherry picked from commit 23c99b64918eddb6084ffe4347faf95f82661c47) --- usr.sbin/bhyve/bhyve.8 | 38 +++++++++++++++++++++++++------------- 1 file changed, 25 insertions(+), 13 deletions(-) diff --git a/usr.sbin/bhyve/bhyve.8 b/usr.sbin/bhyve/bhyve.8 index 4efa936f437e..5eba53b92597 100644 --- a/usr.sbin/bhyve/bhyve.8 +++ b/usr.sbin/bhyve/bhyve.8 @@ -25,7 +25,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.Dd May 15, 2026 +.Dd June 5, 2026 .Dt BHYVE 8 .Os .Sh NAME @@ -79,7 +79,7 @@ .Sm on .Oc .Op Fl o Ar var Ns Cm = Ns Ar value -.Op Fl p Ar vcpu Ns Cm \&: Ns Ar hostcpu +.Oo Fl p Ar vcpuN Ns Oo - Ns Ar vcpuM Oc Ns Cm \&: Ns Ar hostcpuN Ns Oo - Ns Ar hostcpuM Oc Oc .Op Fl r Ar file .Sm off .Oo Fl s\~ @@ -333,19 +333,21 @@ for configuration options. .It Fl P Force the guest virtual CPU to exit when a PAUSE instruction is detected. This option applies only to the amd64 platform. -.It Fl p Ar vcpu Ns Cm \& : Ns Ar hostcpu -Pin guest's virtual CPU -.Em vcpu +.It Fl p Ar vcpuN Ns Oo - Ns Ar vcpuM Oc Ns Cm \&: Ns Ar hostcpuN Ns Op - Ns Ar hostcpuM +Pin the guest's virtual CPUs starting from +.Em vcpuN to -.Em hostcpu . +.Em vcpuM +to the host CPUs starting from +.Em hostcpuN +to +.Em hostcpuM . Host CPUs and guest virtual CPUs are numbered starting from 0. -A -.Fl p -option is required for every guest vCPU to be pinned. -To map a 4 vCPU guest to host CPUs 12-15: -.Bd -literal --p 0:12 -p 1:13 -p 2:14 -p 3:15 -.Ed +The +.Em vcpuM +and +.Em hostcpuM +arguments may be omitted. .It Fl r Ar file Resume a guest from a snapshot. The guest memory contents are restored from @@ -1317,6 +1319,16 @@ bhyve -c 2 -w -H \\ -n id=0,size=4G,cpus=0-1,domain_policy=prefer:0 \\ numavm .Ed +To run a virtual machine with a single vCPU pinned to host CPU 12: +.Bd -literal -offset indent +bhyve -c 1 -s 0,hostbridge -s 1,lpc -s 2,virtio-blk,/my/image \\ + -l com1,stdio -H -P -m 1G -p 0:12 vm1 +.Ed +To run a virtual machine with 4 vCPUs pinned to host CPUs 12-15: +.Bd -literal -offset indent +bhyve -c 4 -s 0,hostbridge -s 1,lpc -s 2,virtio-blk,/my/image \\ + -l com1,stdio -H -P -m 1G -p 0-3:12-15 vm1 +.Ed .Sh SEE ALSO .Xr bhyve 4 , .Xr netgraph 4 ,home | help
Want to link to this message? Use this
URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?6a79f760.36896.68124f3e>