From nobody Fri Jun 12 09:30:36 2026 X-Original-To: dev-commits-src-main@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4gcDlJ4s5Sz6hR48 for ; Fri, 12 Jun 2026 09:30:36 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R13" (not verified)) by mx1.freebsd.org (Postfix) with ESMTPS id 4gcDlJ3ysFz3y4N for ; Fri, 12 Jun 2026 09:30:36 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1781256636; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=r9X8E1MJlwVulSb9VUVkNEKbkl1Z2VPnKE1IFtdUqKE=; b=asYukMAy4BcUkPiE5XASM4eslnzrX9dM9/vJtbmLjP7tDI3p7pH4DNWkdoeAjxh/fF4xu9 lip1IIbpdFh4YNphf9xibtXMxz3kZpSwIMtwti9hAd3T3rMThkrdeec5V4lt/k7A7ymMG8 +xX0joHBHvkCHktrBM3b0vop5w6ehbHuUngtVoV02zy/7//sOnKtJm9T5qP6ABi1YDWA9z Sx6BQY+6XXIi6i75XCa0dcC3FGfKzsihtIQRl/Glzpd1yceWoTJO4RRlvnggSq+Nd5kezi fG6pNrb9blmv2FCf9ekDEpoVo4iXbPYvIAcgmHyiFzpA/Ie0oUUb1PS2IQ7wIw== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1781256636; a=rsa-sha256; cv=none; b=H64e/uL6h6pmCQ3/pIwhgS+0ZdW2tHQy/1AeOkj1sfHYsa3FILhG726BY0Zi71A97SkJau DoJsvm6BYw7yXqE4ZPvNeexAJmGt9l0h9LRWpJCRYpp1SK/+uDrwq4TiU5h+N5YaO3WmQG nDTWS2jc6bgCOfn46DF/AjaCRidFsHdSPXAk95jcM8hloKSOBcSC1eH6KPnfZSX1SRqrDW FRuML9IS/G6ci7OxpfgkS/NnMrXFvqX/AcdYTloF0YCnnqXQQkfaS1IW0136TyXW/xwPba 1ZLP+8RCkXA7l+Niy5Ycr1qkcAjdtjudDIkj1rKqR2Q7ggSap/n02iU9uGAAFw== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1781256636; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=r9X8E1MJlwVulSb9VUVkNEKbkl1Z2VPnKE1IFtdUqKE=; b=X7wewhEhVC5pgFS4JZZqv4ecWUR8DppD9FBlQUUjVHUyj66EgRpQag+ldIGBVHmF/bVZke c4dWwmBFzOUKBrq+qdmNfYtiBfJgPOUXGTvDIvwxPt4EoHuv/Y2nRKbSnjdHGOpSLh25LR QO+hx1oz0xsivFWNOeoFMRWy3poWv5vp/cSmNMlpHeFjTD6P4Id4H7bcx/y3JN4Jb9Huuo POTq+C4yGfKm1cwjuWPFP0p5C2lR7//6mQrAVkeOxhUUv8XdP1/fTjg5vOVHyoOZdewIiV iB5O5M0XpvcIrB/nuHL3xurs0Du/ye3LoFrSiWNoCuQzKQIylCqYDVskK2xsQA== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) by mxrelay.nyi.freebsd.org (Postfix) with ESMTP id 4gcDlJ3VqtzXPj for ; Fri, 12 Jun 2026 09:30:36 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from git (uid 1279) (envelope-from git@FreeBSD.org) id 333fb by gitrepo.freebsd.org (DragonFly Mail Agent v0.13+ on gitrepo.freebsd.org); Fri, 12 Jun 2026 09:30:36 +0000 To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: Bojan Novk=?utf-8?Q?ovi=C4=87?= Subject: git: 23c99b64918e - main - bhyve: Document vCPU range pinning List-Id: Commit messages for the main branch of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-main List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-src-main@freebsd.org Sender: owner-dev-commits-src-main@FreeBSD.org List-Id: List-Post: List-Help: List-Subscribe: List-Unsubscribe: List-Owner: Precedence: list MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: bnovkov X-Git-Repository: src X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 23c99b64918eddb6084ffe4347faf95f82661c47 Auto-Submitted: auto-generated Date: Fri, 12 Jun 2026 09:30:36 +0000 Message-Id: <6a2bd1bc.333fb.ef578b1@gitrepo.freebsd.org> The branch main has been updated by bnovkov: URL: https://cgit.FreeBSD.org/src/commit/?id=23c99b64918eddb6084ffe4347faf95f82661c47 commit 23c99b64918eddb6084ffe4347faf95f82661c47 Author: Bojan Novković AuthorDate: 2026-06-05 17:31:01 +0000 Commit: Bojan Novković CommitDate: 2026-06-12 09:30:08 +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 --- 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 ec8c880b0243..73094f5dc23f 100644 --- a/usr.sbin/bhyve/bhyve.8 +++ b/usr.sbin/bhyve/bhyve.8 @@ -26,7 +26,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 @@ -80,7 +80,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\~ @@ -356,19 +356,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 @@ -1403,6 +1405,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 ,