From nobody Mon Aug 10 16:08:00 2026 X-Original-To: dev-commits-src-branches@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 4hJfmc6bfQz6p0bk for ; Mon, 10 Aug 2026 16:08:00 +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 "YR1" (not verified)) by mx1.freebsd.org (Postfix) with ESMTPS id 4hJfmc1x4Mz3qR8 for ; Mon, 10 Aug 2026 16:08:00 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1786378080; 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=rR3/GAt++wwpnZ0E9EWxlVn/O0JVo2f7G54J8ZBHYs0=; b=iqZ3dMiWe7/71WoAAAB2Qn0NpkAi1Rw7mwIfpCVFKV7A3h75G4gGudQ98isO1fzvDayL1e Tu+C3GbWO8F6EBCdZ3S4jQPcElfE9bajeTvys2MHt8YYLWEmZkH+QSE6jHW+XjS9C+3Wo9 SlkZ3KAvgGirgpiplZgujTs+YGTnfuOntOHa1bbk28NLdea9DiFGYpOifZUBsoqW7jbC6V GqXsMUEWRwvCHil6eyZEnjrMJntVHURwsLurza/JnvOW9+Y3jsrBzTbA1UZBmbko0dQ2kC J/35+qvJYGeLdB4DbenOudwqDeSZMRs2cKWYYWhAKG6/Mh4NpPTomEQEuV1Xww== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1786378080; a=rsa-sha256; cv=none; b=b6kMab3aKlrB6m/wsjhWDWZ6D5K8itqWLdPOOq9yGhRSyJbxjXtPg6OEKWv5bBskRpivR0 gctMDNwBmTUFqSHuyJoLMJhJoDUGTrLWIi/l8mjXy9ErhX+AHJ2Ak1ySAGkO/YeCsf1UMN 3XB72f7Bbp+Y7lB8PfRMZ676mvkFrwMo/hZovG3mA9lw4tpicoEqvqQ+qDi76/cYev108c MsF++2cx50cnDhtm082Fq9KIu9e5ylWtjHUmm+IPRd9UmPbSJIS3AO0nqDr/tanxIpoABM vdOctYU0fIHq1JjdAy4G77ptH7Dog6OZJ9fGkXoUf72tNsNrpFDnqOYJOD/HsA== 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=1786378080; 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=rR3/GAt++wwpnZ0E9EWxlVn/O0JVo2f7G54J8ZBHYs0=; b=acuI2sWhx8yDMZj0a3AsqxJF9Apc9loR1s0N20335sdlwia/rG2iCc/sCOlAkHNQlWIrEp 9YDghudPw+wmQr9nIagfdDDaW3FqQDtafSAGn9DAmKrpl18HTlCLa9zxKmjMy0hCwdWcUg VExkiY66hA6tCnLcTsmIyhyFWyZdLyygXQ1jMVnliPEWEcTwo1hNajc77ZVIf8ZKBmdTNR 8YVwKXFidesTdLuiVrQ9ztf5ugqZh53ALAkMduR3rW5y7Ok/PMJPukPA8cAvTx+Nn/ltHd wFJTUe0jis0Q8w5dmNvoQWkjjWgg0uO241F0Lsajq4MAxHCIAt5a/QJdcbx+pQ== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) by mxrelay.nyi.freebsd.org (Postfix) with ESMTP id 4hJfmc0CVXz1Pk for ; Mon, 10 Aug 2026 16:08:00 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from git (uid 1279) (envelope-from git@FreeBSD.org) id 36896 by gitrepo.freebsd.org (DragonFly Mail Agent v0.13+ on gitrepo.freebsd.org); Mon, 10 Aug 2026 16:08:00 +0000 To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-branches@FreeBSD.org From: Bojan Novk=?utf-8?Q?ovi=C4=87?= Subject: git: bb68e4ac1250 - stable/15 - bhyve: Document vCPU range pinning List-Id: Commits to the stable branches of the FreeBSD src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-branches List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-src-branches@freebsd.org Sender: owner-dev-commits-src-branches@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/stable/15 X-Git-Reftype: branch X-Git-Commit: bb68e4ac1250cd764681db501db36daf6757ea9a Auto-Submitted: auto-generated Date: Mon, 10 Aug 2026 16:08:00 +0000 Message-Id: <6a79f760.36896.68124f3e@gitrepo.freebsd.org> The branch stable/15 has been updated by bnovkov: URL: https://cgit.FreeBSD.org/src/commit/?id=bb68e4ac1250cd764681db501db36daf6757ea9a commit bb68e4ac1250cd764681db501db36daf6757ea9a Author: Bojan Novković AuthorDate: 2026-06-05 17:31:01 +0000 Commit: Bojan Novković 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 ,