From nobody Fri Nov 21 10:14:23 2025 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of lists.libvirt.org designates 8.43.85.245 as permitted sender) client-ip=8.43.85.245; envelope-from=devel-bounces@lists.libvirt.org; helo=lists.libvirt.org; Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of lists.libvirt.org designates 8.43.85.245 as permitted sender) smtp.mailfrom=devel-bounces@lists.libvirt.org; dmarc=pass(p=none dis=none) header.from=gmail.com ARC-Seal: i=1; a=rsa-sha256; t=1762613328; cv=none; d=zohomail.com; s=zohoarc; b=i4YzCZ/Osq/T7NobloL0no2mHRrcxW1vkuLa1lMmbxMhbAudFJCF1cD6zBY2w+3mjBcznHKmSMPwjYWQQb/Cye6DsVLowhATgpwYte4kUvZJ1uJymLxMYHs9D7atLEWm/MG/JCBWHtwATOlvamra3UU1nwnRJdHUwqNNE/dQfLs= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1762613328; h=Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:In-Reply-To:List-Subscribe:List-Post:List-Owner:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Subject:Subject:To:To:Message-Id:Reply-To; bh=SbWJjKyOb6gq6rQfqjGERt2Nru0AF2flfVXWdtuXMHM=; b=hHA8RuJg2wylX/PNaq2Xt4UbBKHd5FVzI8reAYGOmbkBoZAmfTpdxYVxRlad6LYPn9I/Zn/Nx+z4exCpsGSA5sakZhXA5+G1ztS+ZXctCP0h8WriUq4GzEoQ5KhUPdBdfnO49b2PoVp6zDvFqAkWfqJW4Q7aBuyYmnX+KMGmYnM= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of lists.libvirt.org designates 8.43.85.245 as permitted sender) smtp.mailfrom=devel-bounces@lists.libvirt.org; dmarc=pass header.from= (p=none dis=none) Return-Path: Received: from lists.libvirt.org (lists.libvirt.org [8.43.85.245]) by mx.zohomail.com with SMTPS id 1762613328394898.0640662970991; Sat, 8 Nov 2025 06:48:48 -0800 (PST) Received: by lists.libvirt.org (Postfix, from userid 993) id 68B0A44580; Sat, 8 Nov 2025 09:48:47 -0500 (EST) Received: from [172.19.199.29] (lists.libvirt.org [8.43.85.245]) by lists.libvirt.org (Postfix) with ESMTP id 3F628447D6; Sat, 8 Nov 2025 09:47:24 -0500 (EST) Received: by lists.libvirt.org (Postfix, from userid 993) id AFE2C41C16; Sat, 8 Nov 2025 09:47:09 -0500 (EST) Received: from mail-ed1-f50.google.com (mail-ed1-f50.google.com [209.85.208.50]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (3072 bits) server-digest SHA256) (No client certificate requested) by lists.libvirt.org (Postfix) with ESMTPS id 0E82F44471 for ; Sat, 8 Nov 2025 09:47:09 -0500 (EST) Received: by mail-ed1-f50.google.com with SMTP id 4fb4d7f45d1cf-64175dfc338so61393a12.0 for ; Sat, 08 Nov 2025 06:47:09 -0800 (PST) Received: from tulp.my.domain (84-25-144-101.cable.dynamic.v4.ziggo.nl. [84.25.144.101]) by smtp.gmail.com with ESMTPSA id a640c23a62f3a-b72bf97d430sm583866866b.37.2025.11.08.06.47.05 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 08 Nov 2025 06:47:05 -0800 (PST) X-Spam-Checker-Version: SpamAssassin 4.0.1 (2024-03-26) on lists.libvirt.org X-Spam-Level: X-Spam-Status: No, score=-5.3 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,FREEMAIL_FORGED_FROMDOMAIN,FREEMAIL_FROM, HEADER_FROM_DIFFERENT_DOMAINS,MAILING_LIST_MULTI,RCVD_IN_DNSWL_MED, RCVD_IN_VALIDITY_CERTIFIED_BLOCKED,RCVD_IN_VALIDITY_RPBL_BLOCKED, RCVD_IN_VALIDITY_SAFE_BLOCKED,SPF_PASS autolearn=unavailable autolearn_force=no version=4.0.1 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1762613227; x=1763218027; darn=lists.libvirt.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=SbWJjKyOb6gq6rQfqjGERt2Nru0AF2flfVXWdtuXMHM=; b=l///Zpca3vTWT2oxTccF9/ms9FcfCziwCQzpyFHb+NW0P0+YRp6LZBvNPf7BubGq22 3q3bfwQr78JTIVHCphyYpNB5rbgySbq7u5kh6YO8nxbGNPNTRBAJPnWx+wSrl3M55wbn yWpyZKYwsazVv2ddB9ju1n/ktozZmFnmfY+o97kXPAZeU+/ztRehNwEUm+vFvn72jaTF /TFIxyr+RK8MPCtuJzVn/dw9Z7DTB+iFIeNKM5iNKuiRsHNnL1GisLq5lgyk6SZApQNd hDnhIkSrwzVkI7EwO/CtggD/VM1m8u3rU7iOj/mEg7nV1mbKDe1ngSlSxJDjn+Eo8gsd jBkQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1762613227; x=1763218027; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-gg:x-gm-message-state:from :to:cc:subject:date:message-id:reply-to; bh=SbWJjKyOb6gq6rQfqjGERt2Nru0AF2flfVXWdtuXMHM=; b=mNZWZfvpQob11KWgUk1x3JhZNtFCIqSkWx+Vl0xovgHTNGKg4UbaTB9AQM7VGLLFqC tpL9wV8GOlkjdmS9s8mMQvvwZ17VDvCOsqw0SotzqR5w7mxzgNtSC6rmTY/VEO+MC9mJ F6SemfVV0kqQKp3Fw4IgtCwAh7TSWueD/Kl6yqRB6XPti+IeNI7a6kr+nOqhh2hRg/UZ v080NaNgLu4m2D4XwHAR8NJaH6gi4Ed2XDfwsw+jlEL2dGA/85GzW7JbbTvuhD8vGPo2 EeeOuz+cl9A6oRcS6F8fEkTWqHWdWeUhCAZLUYk2/xZyCr0mk1zPInZPT1yG2eLfoEXY 2SLA== X-Gm-Message-State: AOJu0YyXa36iOWlM/ohcivKuXP8qbk3N+oQi3dzA21R0AXO6eqNmZXC4 LQoRxCZBqPdSV7CliKxZVt3vVmlHV8IiD6waTg4yg1OxzZEg8HsjHe6w1kSXvg2Py4pDSA== X-Gm-Gg: ASbGncsaF0LlQgClpx5VabTZvvkgKAJrcTsKQQE5OwAf2jKUljno0EnsdveQyGS19iI BQCFYYq681g2g0cey5rudpq1fJdVudWFRuyUag6tNYUqXU6l+nWknby+y28tbr7it5nj3G7bwl8 pdlEB0xD0b4m6KMcvtPYn6z1aP9bT9aZKFcLzoWFZPTf8P7Cu5NInc7+Xf2Jgw7XR+5HZX/hRp3 UVbKfWXcDEeXE0OcPveumynTfmZXSCd5e+h/tU+VWU5eQJA1KrXeocjJrt4ZICNA5OBUOhARepw 2hfUZbXD7O25bQDvjUy1sbM4t/X3+tLh5430Y6yxPvdH46NxGdYNZBW+9gwPQzHXe6i1T9HYYOD ZOUNs8LMt2xKP6wlHh7sXgBAer+1OasUdUw1eMRhSD1aapqBS5DOkD2s2WNU0UqsggmpMLyuVtL YhiG/psDXpDTnX17AvvFQWoIA/PHKp32ujKpfITmaQU6ymPTXQjhVof55IqKwFBUg3mWI= X-Google-Smtp-Source: AGHT+IHz86ukS+P0oJaBrCPFMm/dwAfSLCO38WMqVOAPJk023PjmwfpXIpE/vDCI+t3Js1uSLra/Uw== X-Received: by 2002:a17:906:730a:b0:b72:5d4a:45eb with SMTP id a640c23a62f3a-b72e031378amr277649366b.14.1762613227026; Sat, 08 Nov 2025 06:47:07 -0800 (PST) From: Roman Bogorodskiy To: devel@lists.libvirt.org Subject: [PATCH 1/3] docs: drvbhyve: document device passthrough Date: Sat, 8 Nov 2025 15:45:08 +0100 Message-ID: <20251108144510.80378-2-bogorodskiy@gmail.com> X-Mailer: git-send-email 2.51.0 In-Reply-To: <20251108144510.80378-1-bogorodskiy@gmail.com> References: <20251108144510.80378-1-bogorodskiy@gmail.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Message-ID-Hash: AHRJT3QKIAG3GFULO7PAUJJCI2W27KYH X-Message-ID-Hash: AHRJT3QKIAG3GFULO7PAUJJCI2W27KYH X-MailFrom: bogorodskiy@gmail.com X-Mailman-Rule-Misses: dmarc-mitigation; no-senders; approved; loop; banned-address; header-match-devel.lists.libvirt.org-0; emergency; member-moderation; nonmember-moderation; administrivia; implicit-dest; max-recipients; max-size; news-moderation; no-subject; digests; suspicious-header CC: Roman Bogorodskiy X-Mailman-Version: 3.3.10 Precedence: list List-Id: Development discussions about the libvirt library & tools Archived-At: List-Archive: List-Help: List-Owner: List-Post: List-Subscribe: List-Unsubscribe: X-ZohoMail-DKIM: pass (identity @gmail.com) X-ZM-MESSAGEID: 1762613328772158500 Content-Type: text/plain; charset="utf-8" Signed-off-by: Roman Bogorodskiy --- docs/drvbhyve.rst | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) diff --git a/docs/drvbhyve.rst b/docs/drvbhyve.rst index 9db17e55e3..94f6b65d77 100644 --- a/docs/drvbhyve.rst +++ b/docs/drvbhyve.rst @@ -659,3 +659,27 @@ As ``bhyve(1)`` uses one NVMe device per PCI address, = it's modeled in a way that there is one device per controller. That is, if using more than one NVMe device, for device name users should increment controller number rath= er than namespace number, i.e.: ``nvme0n1``, ``nvme1n1``, etc. + +Device passthrough +~~~~~~~~~~~~~~~~~~ +:since:`Since 11.10.0`, it is possible to passthrough PCI devices. + +Example: + +:: + + ... + + +
+ + + ... + +Using passthrough devices requires wiring guest memory, see `Wiring guest = memory`_. + +Note: currently, the `nodedev `_ driver is not supported +on FreeBSD. +Users must configure the device for passthrough manually either by +using ``devctl(8)`` or by setting ``pptdevs`` in ``loader.conf(5)``. +Please refer to the ``vmm(4)`` manual page for more details. --=20 2.51.0