From nobody Mon Sep 8 17:08:16 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=fail; spf=pass (zohomail.com: domain of lists.libvirt.org designates 8.43.85.245 as permitted sender) smtp.mailfrom=devel-bounces@lists.libvirt.org; arc=fail (Bad Signature); dmarc=pass(p=reject dis=none) header.from=lists.libvirt.org Return-Path: Received: from lists.libvirt.org (lists.libvirt.org [8.43.85.245]) by mx.zohomail.com with SMTPS id 1757164968128280.656968814817; Sat, 6 Sep 2025 06:22:48 -0700 (PDT) Received: by lists.libvirt.org (Postfix, from userid 993) id 347E04456E; Sat, 6 Sep 2025 09:22:47 -0400 (EDT) Received: from [172.19.199.3] (lists.libvirt.org [8.43.85.245]) by lists.libvirt.org (Postfix) with ESMTP id BC05A445D6; Sat, 6 Sep 2025 09:17:06 -0400 (EDT) Received: by lists.libvirt.org (Postfix, from userid 993) id D0542444C0; Sat, 6 Sep 2025 09:16:59 -0400 (EDT) Received: from NAM02-BN1-obe.outbound.protection.outlook.com (mail-bn1nam02on2048.outbound.protection.outlook.com [40.107.212.48]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by lists.libvirt.org (Postfix) with ESMTPS id 2D6E9444E1 for ; Sat, 6 Sep 2025 09:14:40 -0400 (EDT) Received: from LV8PR12MB9620.namprd12.prod.outlook.com (2603:10b6:408:2a1::19) by BL3PR12MB6379.namprd12.prod.outlook.com (2603:10b6:208:3b2::11) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.9073.27; Sat, 6 Sep 2025 13:14:38 +0000 Received: from LV8PR12MB9620.namprd12.prod.outlook.com ([fe80::1b59:c8a2:4c00:8a2c]) by LV8PR12MB9620.namprd12.prod.outlook.com ([fe80::1b59:c8a2:4c00:8a2c%5]) with mapi id 15.20.9094.018; Sat, 6 Sep 2025 13:14:38 +0000 X-Spam-Checker-Version: SpamAssassin 4.0.1 (2024-03-26) on lists.libvirt.org X-Spam-Level: X-Spam-Status: No, score=-1.5 required=5.0 tests=ARC_SIGNED,ARC_VALID, DKIM_INVALID,DKIM_SIGNED,MAILING_LIST_MULTI,RCVD_IN_DNSWL_LOW, 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 ARC-Seal: i=1; a=rsa-sha256; s=arcselector10001; d=microsoft.com; cv=none; b=dDTyDSrcG50yx/H8QCqZB9ZpnozdBjJI0WLUtGuxnuAxZW514NAilmlt9TgO8baR8sWGPGjDOn48oiM0baewZoTNZJNWMKtWQ69sQcOQ+lN7vVpo825F3oxBdumDfuHnuRwzB7geAZ8/Flxd/Ju32pMOQxDmcYL9D6pKQSE/5XzNVXBwGmAmU0tcf+UKagKnEse5/eOc4OkGdV8dXm2KotO/Wfeo4ysKsjGpaXyW1LggMJ2xHASMuWTfwrpQNd80dlUzURX9uowrqNTs1gHoLYiJPmOORMcnKsXXzY/ljQxlpca5hW8IStjPnPcmxTke7U1ReB2LGELGBjEMbngigA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector10001; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=RaTxZC4Xoyj03R0/BEgdS69xirhn68PPsFE23th2WXU=; b=S+yeXoQNQSbZX71LGtOSP9M0tIOoSP7wYUMd8NSq8OIUIRU2pCQg/n+ecttzL48ILgjUPrNhXx9lV6XpIda8VnkTJCUPuHtPcdwXVkfWQIajRcr2Cgw/+2tyDfG/CY1QTWeafnlhwLKk/VZKwWqkqI3fFWHnx2/rZ9nZcc54AGSqI5YO1rD357Pv/JduXwxNL+sSdPoVKP3M75oWdzn4Be0v7TBw+T84cPNWzBLeQMNotpwg4h4oFg6RNkfeh4Gn6JIMQesdDALFtOKjBZhHUurjumbRHBfKKD1EEQjMHPX/1piELfX6Jzca95dBx7tEJKja3hZ76u2FegFXzKAHrw== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=nvidia.com; dmarc=pass action=none header.from=nvidia.com; dkim=pass header.d=nvidia.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=Nvidia.com; s=selector2; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=RaTxZC4Xoyj03R0/BEgdS69xirhn68PPsFE23th2WXU=; b=ACgJSD70xdHCHzW/3uvwMbWH3zRifWX/xREsa9xBB8GwUm1Raec1ZdfhuwpzLfw7rUgMh7X0wWDDc7CKqrmf8uZ9aeknl2WjLVcQleW+Mf+NIQdy9IayrhNs2VCIWLtbye88uBylFxnPx95Dw8K6FctYva0T4sccDeG4gqgl0E9Bex7sKLclzV+nVuj1oJzXgvlrmZwzLnNq54NvtqUw7qOM7EwO9MQV5+qsAKCm3jx6R6f93jBsBpqzPUHTrNdR5yEoRULEo9Oy+urOFa7SXXM3UUfRgvn9O5XxCHskiHb/yhQqfPOAWUx8uqgLgHrJUI6kYE//UhJd8BtjsTiZxg== Authentication-Results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=nvidia.com; To: devel@lists.libvirt.org Subject: [PATCH 7/8] docs: Document acpi nodeset in hostdev Date: Sat, 6 Sep 2025 15:09:02 +0200 Message-ID: <20250906131214.654188-8-arighi@nvidia.com> X-Mailer: git-send-email 2.51.0 In-Reply-To: <20250906131214.654188-1-arighi@nvidia.com> References: <20250906131214.654188-1-arighi@nvidia.com> Content-Transfer-Encoding: quoted-printable X-ClientProxiedBy: MRXP264CA0020.FRAP264.PROD.OUTLOOK.COM (2603:10a6:500:15::32) To LV8PR12MB9620.namprd12.prod.outlook.com (2603:10b6:408:2a1::19) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: LV8PR12MB9620:EE_|BL3PR12MB6379:EE_ X-MS-Office365-Filtering-Correlation-Id: 6b25ae3a-5043-4f94-4f77-08dded475527 X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0;ARA:13230040|376014|1800799024|366016; X-Microsoft-Antispam-Message-Info: =?us-ascii?Q?CogRvyKzAf5G6CwcWduU+TMifD6i1ij/BbUIp4yw7E5oJcxRECZpFvvx3zBp?= =?us-ascii?Q?w7+aZ6x0RwB0HBAdy4AfRxX/RQDWlbufnUUB/FUTzEwiao9h7sfYXZ/cxOu4?= =?us-ascii?Q?geF0LZ6bRlsr5XYxQjiAh1U7r9tM/Qac78qKZG+kZGkY8MmC+IErJ8QsrTZ2?= =?us-ascii?Q?JajacTawWc/tgeYVUKB3nG6Z9HlWQh5O+suumUb2ndeWlSRfeyzrLKu6J1Bl?= =?us-ascii?Q?Rzl1yzrykVCeuc9cBOFTQcB4cEP5js5qAOgiVUVyv5/e6wu6itkNdIka5UFS?= =?us-ascii?Q?SRjtdk7RoV1F8u+Os+Nmk531g0lp3wam16SvGDiX2l1aNHcOp4MfVE6mn4hg?= =?us-ascii?Q?lB8nmskfPxl3HL3YSd7OSanyx8olEi0vKjmanLmUdjN0KjSrf347/3GwGUdR?= =?us-ascii?Q?RbewcuK+HTWyGbETky/+Pj0Ud9nrceKvIEGkKAR+pNXjAwThxIvSNYnPI9SU?= =?us-ascii?Q?2Kq8qyiF8IlOfWbr+Aeg53Ht8yY7LqeWoiQoHrnjWrvtAWwgeStjPWBrjaLD?= =?us-ascii?Q?HNhTu+HzPuZvKJzLbE+dOqMWCZgSAsz4Zgq4ePeyTcGYZF5tdYWOAYfi/HXo?= =?us-ascii?Q?4L9qDPMas8UJMup6PlWwhGJ46gurZsJIz/zIzkhVw0YX80WEPzJfKVFJucm3?= =?us-ascii?Q?I8zCZ5fqqoaBM9Mi6O182bjDHD0UX/3SiutaMizn4lgV4lESQKFI8VcP7te6?= =?us-ascii?Q?obpRsEJ6dOmAUu9zirFxBzd0CSxmg9L/ZA3R9+YTajoAWW/uAEGKmJxM33Fm?= =?us-ascii?Q?WvT0lH5E20FRL/JBpWv11daV4kT0tIJVOGdisNOz58Mom6O5ET15eypi32Mj?= =?us-ascii?Q?j8/Gfzr4oFydI0DuUGgf2HMIynCVne1mvWJ1XVnVVkGGEYC7cvutKoH6SHGP?= =?us-ascii?Q?Zxa77LYD6QmjrklY81uelnCJqBu/VBq1YmbyNF5YSiQWBrhBaO8rE1LMrCrr?= =?us-ascii?Q?29pneT6t27uyVaW11QYhaeBLCTrssHcRWz2xvKu7vI4ImgZ0DzvOqfnduqel?= =?us-ascii?Q?ksb3bku+QKVXMgxFUsgqmtbYl1HDWSbFSt0fuOvj2pzLbNEBUuT6h1g0P4Iv?= =?us-ascii?Q?tuvfRDWIq27Avbzs019OZt0xiLAf+uvJeEu49K8Y0JCve+hpji9le9FpuyTU?= =?us-ascii?Q?pt6wHiNPcj5COqbdt4tCl0k2q/LLFRBTUYVPke6SSkLtQlb8Tp6Ezc0LGWwC?= =?us-ascii?Q?5CmyFM7yDqIH+ugM0ZtC35mkYhhqFregxLb95hfoVvkyahjbuks5Er3UqPVX?= =?us-ascii?Q?AMkuSwMcNrZWcnF6RldzXbM8vNMuchm44ljrhcdo55UGzcaxMUclreoywBBJ?= =?us-ascii?Q?4xJ8tIVLpzfeExA1xJ0a1Zt3YBiBDvH0ZSHlYN5ADZiJ0NyC6bEdbCM7s0vQ?= =?us-ascii?Q?oZtJzXwbO/IuByhNczxD7JMjML0gL5dQ8sheiJj+23O2i5j+OxN6BYJHeMXQ?= =?us-ascii?Q?GhyKf0B1RJg=3D?= X-Forefront-Antispam-Report: CIP:255.255.255.255;CTRY:;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:LV8PR12MB9620.namprd12.prod.outlook.com;PTR:;CAT:NONE;SFS:(13230040)(376014)(1800799024)(366016);DIR:OUT;SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?us-ascii?Q?WFSktsD+mitSXcqmxFC67jDJYNCBzFJmskbvA3UqDdhxtjRXt59DD8VFkB+6?= =?us-ascii?Q?WFD/6AAVqczrR8apFddWRbg+ijj0An2PgS0e6/22FzDjbuGGvP5913nh6xrA?= =?us-ascii?Q?2qqBXdcxmdqOxCZQ2ZxvF5Fn4EpzYyp4d8duxh/VZLgiu/KfVMPIo4U3NoB9?= =?us-ascii?Q?3dynSFaOzJho5MfzOOuI3ljhbO8z4EW1YdGNA4vrINP/uFTkfQ5ZOjJzLPhb?= =?us-ascii?Q?CVGOxm1A7k25aiVunhldLqZRX13BglX6SyiOkfcg9+wOkKTbOP1wJ6kvPNAC?= =?us-ascii?Q?1U0st2cp4qt048FFrVvpUpkx7fIsD0cRoWt75dWLCxOMO1Jx1T+UoPiIfG56?= =?us-ascii?Q?7LMGq8Um1wrJLxMCbpGpOGhbRWQupiziV819jvTK1ZD3NfM8i//Gw54fxu/a?= =?us-ascii?Q?eU6xeRGRTFKxR9LYGIthIL/KjmxanLw6MyLHdvhvu71DEeXvboLQfga0R3Yv?= =?us-ascii?Q?N0iO7VxyhQ3HU0pHicwAp9YYbJgJlXZUNgLQhP/t5aBUmMSXCZxk2TNtXLpG?= =?us-ascii?Q?Qw3f6KTfQZwzsVes/ad7hyPeS468xqSrgl9FcaYzh7YMfAalwk+hAOKoIC8d?= =?us-ascii?Q?kuqh0YFm+PtyEKW2XzbH2KgTSgLmXCnW0COS3PKQx3ildE4a02oNLy+jp91Y?= =?us-ascii?Q?FtGkoJu7Qa0pUgwFLCyGPAcR6ZoKImqBe2PiV31EVUbcpE06sf1puzsJzVPe?= =?us-ascii?Q?1srPhr7kENhyaTqzKo14IwI7JyDDoWpyoupBsqxtc85eJUmYqxJCEcga5Enf?= =?us-ascii?Q?2Umzv10wrzNc+W7xfern+DXgw6I0K+93phDTHg9tN9yQFGPK6GdQ3XUrtlyJ?= =?us-ascii?Q?7WsyWJjaVgrPPBk77rVw3NT1GhvKgTFc1TyE1ZZxiWX5nJXCTcoTkPZ8l7So?= =?us-ascii?Q?wz1nWuIn4OhfvDpwW5EEyYfSH0Auda5mWchVtbKyvI7r8AgrKFH9SKdPYmR/?= =?us-ascii?Q?DpXgz4LQogcf657TVb1DJunB79jMVTBQWKk5zMuKFipAP7LFMpmYmLUpKsyB?= =?us-ascii?Q?K1ypPMp73c6gIIhufdRcn7JKiDed2xYNvZfrp0zXZt3ujYLKVcWzw0fRSXkV?= =?us-ascii?Q?Jwu+Lyb14W0Q789hBn46v3djH3cOvK0Ue3hr/daKe8hmG0e6l+cIwi8vfLud?= =?us-ascii?Q?yo9sxPWzWwLmFU+HMDneXC9csYXqGUJxhrKYqYumchpRtTmw9d/r8BjIi1kK?= =?us-ascii?Q?rAYeF1U4dy37wynhCEuhBCNAgqdRbqmtUMLGj6bl52BlGyRO9puJZTsPeej6?= =?us-ascii?Q?CJjr9oZB1Zb0ta8XeRlkosfIPIiV7wQ32k8bBmKI80AKo4i88bL8WKF+gHQm?= =?us-ascii?Q?7r9c5hCmcN2PGGMPmp7FT4rGLhsYzp2ATnROUDBxQ2C0kLf5zU7aAl3R+Gbf?= =?us-ascii?Q?f9pIsA5MeElZDvhC4+gheHwBmPZUeMYITqaI+Q/tapw8UCHOxeyUHgnPWoIt?= =?us-ascii?Q?lPAeqnOp9PqXuc0p0F2G78MSmTtZtkB9aM8qUtLlXpbjjKIzgC3+Cp+MZUkZ?= =?us-ascii?Q?iPkGj7gO4z3oMpPPdwNT8H9VnlwsynsUyx9Q5b1PJFz5ZMHErpuodvAlH6YU?= =?us-ascii?Q?Vg8qK2k+3Y2KGLjZUWckvif4lVnPPKiEj974aEWs?= X-OriginatorOrg: Nvidia.com X-MS-Exchange-CrossTenant-Network-Message-Id: 6b25ae3a-5043-4f94-4f77-08dded475527 X-MS-Exchange-CrossTenant-AuthSource: LV8PR12MB9620.namprd12.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 06 Sep 2025 13:14:38.4707 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 43083d15-7273-40c1-b7db-39efd9ccc17a X-MS-Exchange-CrossTenant-MailboxType: HOSTED X-MS-Exchange-CrossTenant-UserPrincipalName: Xy3S8adT94WRK0+bjnW07SMBvmHvJjPqIevN4YN7CwG/C8BJc7Q43BkamgNeLGJS+DRyMSYlYxRbPkU05kAz2Q== X-MS-Exchange-Transport-CrossTenantHeadersStamped: BL3PR12MB6379 Message-ID-Hash: TSSOCVK25OV7YDUO56B5SB3C5VABQSBK X-Message-ID-Hash: TSSOCVK25OV7YDUO56B5SB3C5VABQSBK X-MailFrom: arighi@nvidia.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: Michal Privoznik 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: From: Andrea Righi via Devel Reply-To: Andrea Righi X-ZohoMail-DKIM: fail (Header signature does not verify) X-ZM-MESSAGEID: 1757164968802116600 Content-Type: text/plain; charset="utf-8" Add documentation for the new element in hostdev, which allows associating devices with ACPI Generic Initiator objects in QEMU. A typical use case is NVIDIA Multi-Instance GPU (MIG), where a physical GPU is partitioned into multiple isolated instances, each tied to one or more virtual NUMA nodes. The documentation includes an example showing how to configure cells together with a MIG device. Signed-off-by: Andrea Righi --- docs/formatdomain.rst | 49 +++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 49 insertions(+) diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst index 9f7311b6d5..24f7cdd018 100644 --- a/docs/formatdomain.rst +++ b/docs/formatdomain.rst @@ -4894,6 +4894,55 @@ or: host device. :since:`Since 1.0.6`, but only works as expected :since:`since 1.2.2`. =20 +ACPI Generic Initiators +^^^^^^^^^^^^^^^^^^^^^^^^ + +A host device may include an ```` element to create ACPI Generic +Initiator objects for the device in QEMU. + +This can be used for **NVIDIA Multi-Instance GPU (MIG)** configurations, +where a physical GPU is partitioned into multiple isolated instances, each +associated with one or more virtual NUMA nodes. + +By attaching an ```` element to the MIG device in the +domain XML, the guest will configure the correct partitioning for that +instance. + +.. code-block:: xml + + + + + + + + + + + + + ... + + +
+ + +
+ + +Attributes of ````: + +``nodeset`` + A list of NUMA node IDs that will be associated with the device. + Each node in the set causes libvirt to create an + ``acpi-generic-initiator`` object in QEMU, tied to this device. + + The value uses the standard libvirt *nodeset* syntax (e.g. ``0-3,5``). + +If the ```` element is omitted, no acpi-generic-initiator objects are +created for the device. + Block / character devices ^^^^^^^^^^^^^^^^^^^^^^^^^ =20 --=20 2.51.0