From nobody Tue Sep 9 23:43:08 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 (BodyHash is different from the expected one); 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 17494159915161015.0595911929453; Sun, 8 Jun 2025 13:53:11 -0700 (PDT) Received: by lists.libvirt.org (Postfix, from userid 996) id 72EC816A0; Sun, 8 Jun 2025 16:53:10 -0400 (EDT) Received: from lists.libvirt.org (localhost [IPv6:::1]) by lists.libvirt.org (Postfix) with ESMTP id 2D9D01637; Sun, 8 Jun 2025 16:48:50 -0400 (EDT) Received: by lists.libvirt.org (Postfix, from userid 996) id D679A1637; Sun, 8 Jun 2025 16:48:44 -0400 (EDT) Received: from NAM10-MW2-obe.outbound.protection.outlook.com (mail-mw2nam10on2050.outbound.protection.outlook.com [40.107.94.50]) (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 B15161580 for ; Sun, 8 Jun 2025 16:48:19 -0400 (EDT) Received: from LV8PR12MB9620.namprd12.prod.outlook.com (2603:10b6:408:2a1::19) by PH7PR12MB9255.namprd12.prod.outlook.com (2603:10b6:510:30c::19) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.8792.34; Sun, 8 Jun 2025 20:48:16 +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.8792.039; Sun, 8 Jun 2025 20:48:16 +0000 X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on lists.libvirt.org X-Spam-Level: X-Spam-Status: No, score=-0.8 required=5.0 tests=DKIM_INVALID,DKIM_SIGNED, FORGED_SPF_HELO,MAILING_LIST_MULTI,RCVD_IN_DNSWL_NONE, RCVD_IN_MSPIKE_H2,RCVD_IN_VALIDITY_RPBL_BLOCKED, RCVD_IN_VALIDITY_SAFE_BLOCKED,SPF_HELO_PASS autolearn=unavailable autolearn_force=no version=3.4.4 ARC-Seal: i=1; a=rsa-sha256; s=arcselector10001; d=microsoft.com; cv=none; b=MgtI5z1t8bUaARgviuvj8PUhi8+j9k260zloN82FD+HTT2/efGEQ4x9ZS+iT4SzXPivxKyZXGz6CjUuL5qQNc3kpDiSUyM1CPXOZmfwh+2X9QPdgDUDuzMW2/nCFH5puXrP7iZ0Jjxe9E8uhagHfiZoAOx6BJlezp5YCRx8sWqP0u11VLljem5obvD/evFZhbqX+AObmhIC47qbt3dZQqTacqPunV8RJvIXv0329Mb6al8XBWjIbXbFjeqtPeC7dOnSbahkXpsvvr6CRebJcyTqVHjd/SCnO888Tkkqefms43B7YvZvNttG9nzpxCB/aSB2NAuSnFI1nSaCn/up5xw== 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=Wg2ZEAszmhR532xfZmzEZnpT3nns7pa6grt2qce+DCM=; b=qxlyrSLez2SKU4/NCmTfoM/GVwESLgOF0nhkmOybpglVvCyg1tu3/yMj5/wrDIbp/70ranixXQwSX/xCF3Q4kMbldNVfdT255/kUZADM7bBgugOjm42WMTF+D1kMKSOP4DzPi/thLA/pCsXNo5p0XBEyRMo8IEf3o8v/ebVwzR+cp5IAhVaCM/RSboBCcuxmvLpV+edBSyiADJCg9K183YJGXF8zHUECC4cERUedaj3ZxoZaRVge9H4mPSWmgR0+H5HZJ0D142EH0VIpyGCriyA2qdwrd8I2/6P5vnxA2YK/GspPHaTYxdXgQBdDAXNZ84JzrykwV8H0SctCu+vOOA== 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=Wg2ZEAszmhR532xfZmzEZnpT3nns7pa6grt2qce+DCM=; b=tWUUS4L1ljqpDFdCW+v9b5mZkugFiPn7kp9DwoRvkSddSoCcrnlkCVYti8EZXmwceoFfSNunsIuBo5yyHvqtaFsBFqoJg7ewF/Fmwc6vfnwvekC9+vGjTZEvRi+82NQOVGk8M7FyYxewSACCdy/tmo9rlBXNTKW/bFRbOOQa7KHyvc8b9udD7qFozIiQGUjyYpu5sHQixta2NrDEs8gnNZ7efbANeOZk7qW30EJRIuALqXsU5Ouam8PeEsaHlLDBffOTCoTk27BIrtIw4J4M2NO0hWjEXzHGQmucWZ5bmj0bKWeALybuRr2BB858EaG0wmYyuUAqHruv74RQ3fqfPw== 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-generic-initiator device Date: Sun, 8 Jun 2025 22:44:15 +0200 Message-ID: <20250608204744.518118-8-arighi@nvidia.com> X-Mailer: git-send-email 2.49.0 In-Reply-To: <20250608204744.518118-1-arighi@nvidia.com> References: <20250608204744.518118-1-arighi@nvidia.com> X-ClientProxiedBy: MI0P293CA0006.ITAP293.PROD.OUTLOOK.COM (2603:10a6:290:44::17) To LV8PR12MB9620.namprd12.prod.outlook.com (2603:10b6:408:2a1::19) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: LV8PR12MB9620:EE_|PH7PR12MB9255:EE_ X-MS-Office365-Filtering-Correlation-Id: 645fe07c-fe12-474b-3181-08dda6cdcb58 X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0;ARA:13230040|1800799024|366016|376014; X-Microsoft-Antispam-Message-Info: =?us-ascii?Q?WRMfEvIKroLxIThsd6nuQ2DD1NRuPPqy1SLUOSMpbV1Grc5klZhlfN7M0zsr?= =?us-ascii?Q?PBt89fAgEDnRjZpCSmBdRsYlqhb4OlnnqjqtKnMMw2qlQvTYmAnELRwA/2Nk?= =?us-ascii?Q?fOGZX7DBu9Q41KUi+g3KfSWoKzdI97K4NhHsTaqr9W6qjBIG2OuvESMattmg?= =?us-ascii?Q?FDTVpoDOmARVd85GyAfNMG0K5NV87AHTiG44SlhquEqLPHduroGbNep8Mos/?= =?us-ascii?Q?I3kN/vxn4hbuYeN0RK8BQVoVxnjaAoAnsoRgKO/Ez7k+yam4nXT+hoRWIHp4?= =?us-ascii?Q?H8DNlIBNokydreKerysTKIMKw49eUx/FoJqKcShxagC725P7Fg/n4HwwgDUX?= =?us-ascii?Q?IFd4aCawyP6lKQRxmzctVnoxjnf5DL9X7DmH51lNxWrjuKoswVAnfMx2/Ftw?= =?us-ascii?Q?Mdt5o5qbLDUPt5t7NK9hYlAl3I8RFbgRz7GyQM85e6huV5h8PM700tzdtghr?= =?us-ascii?Q?Z50iSW/t+maV3jYkkEwyidwZrCewKKhvGOBSvgUm+YXI+bClMK2eD8GoU2O+?= =?us-ascii?Q?hzABwvgMtfBWczpg4+pK5+/lmhg+vo3meRDsgcQlT7sfE2z4Mf4EEMfImEm0?= =?us-ascii?Q?GV7B3IvopRhOXfqrmWDLDI66oBjtWGdeRyCEsaUihJHb3nSoVVVKWKm0gbKI?= =?us-ascii?Q?V30tkmzCdIgxFLMryQ7BcasyZ4ZBc+3ysD7T/KTRZvGwPkyfOgc57sOIqoaz?= =?us-ascii?Q?U05GIvXeoQn/k/OFN+3zaiK6Far2Utf+9yFy/4wvXGxehjhYFzX6orYagBzU?= =?us-ascii?Q?eG8XuFCJEPFZOr7uxIVr/BmchO7X00gVB8L38QVtg4q+ahU4iG+4xQ1h2Ii9?= =?us-ascii?Q?kQbUzWQUxfHlCx2iy6+PCrZPL51u7ls4JvVpovjChITYTD9ZBsW++/RDwSDx?= =?us-ascii?Q?gXE8NHkRqG4Bt8MfZtkT/olwvla6p3A8a2Doe9vjKFcFj8JtvUpYUPQu9qQ3?= =?us-ascii?Q?1Bp/LGgfYidhnt4kVacs4lqmXY5Q8S5sZ1MOZ5R03qywgW5Rn+Nd0g8+ur2X?= =?us-ascii?Q?Wr7US7FCG0SY5NwhOq7UjWos2T6Leyw+94omdzJWqJKnlSyXag3zch9Fgw7I?= =?us-ascii?Q?+nP3gvtWTZPeB2g3mOenyqXShpTp+0F4SZ2948pF7+q57HiYR1PDuTvqxy8X?= =?us-ascii?Q?75gaNUPjCqIj2pt5jnX8dJz+XoQXGe37mKOFf74f2YVwyK+BB07V41prVg/b?= =?us-ascii?Q?DUYJEYclrDbEeT2gkL44Z5cpzpIit5mhT8XvT8+lDFVms9wgsOXd2kuX6cuS?= =?us-ascii?Q?mbpzQOSMyVhsUvvXO3iMdUhmhVbZtKUPgKpEOkyWycyA58yI7jpQ4XZtPm4u?= =?us-ascii?Q?uIBS3iIQRP5l9YPt3+Sj2Z44PChjk9Z56052xitrHd4l0sHXWC66lejesPSN?= =?us-ascii?Q?mFk8C5OJSkSIbrBuS+kalkoSuX3nSeOokWZIV9o25wE5/0rURYguMz2AQcHp?= =?us-ascii?Q?yvTTHUEDlSI=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)(1800799024)(366016)(376014);DIR:OUT;SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?us-ascii?Q?0qRAXTujLvGg6wu0w6uW8BBLG6tmU/RYmDa7VidOnT8l4iRR8p7qzbQJdvLL?= =?us-ascii?Q?9gZxqLG8B48nuOeAtKg9A7RRuqkD3dxeWk3roexaGgAkCMEc7Fn0jZJv/MZ1?= =?us-ascii?Q?96yCrgvX8NCJHpO/64E6Ht0lm/Ogoqtr/ifF1blK+jAJ1KCoQduGicmMguHZ?= =?us-ascii?Q?kLnQSCfQMYJpeRE221ySMnbfe/VzJrvnz3WK3HD11EzwLbzTlz9nCKKmmjdW?= =?us-ascii?Q?WpksaB5Ivbb/ED9hsON58phObd00IElC2ylssYA0NA7GN6b0Z+k3g0f/JdfA?= =?us-ascii?Q?CxCHA6zfgF8E1v2LALD3LX0Yftvfb+Y6QBWmX+WQruK+sMoosd9lvalEuvmv?= =?us-ascii?Q?5795i5wMsqv8ogoeIMamce52bXTmQrfhlsStKXZmT/gnABmFfq2AFPNGgaYT?= =?us-ascii?Q?aOnIWzT5LrJl9qvp4Y5F8umxHGSfgaNqwdvLVcIHURsYKQ4FLZYgbXFqZQxg?= =?us-ascii?Q?HRzZ8bcC7SUgscs909fY+OKgOUKv9H9y7fV/8pUsj6faGacrh7tkcyWkL0RP?= =?us-ascii?Q?cBokHS8tcawdKzIADAwZ7EQ0AORPaAWX1cd846TNBLIFxREEzE61TfBfF7IG?= =?us-ascii?Q?i/JvZRdtLlnrew9Gd4UwbaG//Vy8ZLpDpuaTpEN/inA/Dhw+wonrYnK0Vr3A?= =?us-ascii?Q?jz8cXmspP0OTPkWzhM3YMSM/Mh1JSoxYia2Ix7tbvgV6xLL5HiIKPKxcUOs2?= =?us-ascii?Q?nfwMgWn/hPC7gXcRItjaT6ZrjP9HGB0ZqNdcph7wfRJeiAqs5si854habIwy?= =?us-ascii?Q?QNdeAnPtN8jEqFexfGzuySxTK5k9Tqz2m6wJK2nl1TGww7/ku5tJKqZgKtom?= =?us-ascii?Q?6fcCNXix/6IbXycxDDCxrItQZSx8EiUSW+2O18u0mfgr5qwnonp5i/PWqJp+?= =?us-ascii?Q?qGHo4KHyK1omCcmPNfxPliVu4/B/WxxBboQUHB8kp/MdvNuB1UcSy/wKidjk?= =?us-ascii?Q?igkjJw0D+NfaQ7mOwD7Xho8PPnzKXNo+6fnDEWWeHWQEajZBqj2nuaXGsiSc?= =?us-ascii?Q?Zi1CWBf/i9j/2JnLEQqrLNG7U4kY66t/sdmZmNrBu7fZKGb/VgRd3o92GNzM?= =?us-ascii?Q?EHVMR/9SIPHyXtcxBFPktX22vUIKZkCT/XFCdZ3drpVOjDdorAMEAHHlzwq6?= =?us-ascii?Q?S5MOaAlyxbOFca6SEAlhIQpgxb4m2PL6k50+vCq9ARwETOg3L2wvXuZ1gmSj?= =?us-ascii?Q?5U9LfZu6ieXdPEbkBxB9vcYeQmQW/TOv2+kKn/BI1x9kB/KZs2pLq/XmE2RF?= =?us-ascii?Q?rY+7PA1DgxBpo0prxkmYhV0BUrLMV2gA/7wAoKti8cgVd41rIfZdyPMZGy5i?= =?us-ascii?Q?U0hvYVhYuLP5rPM+W1NgsVd+RGgbYEZAZ8OqQebxF2px4Ytikz77R6wWRRLB?= =?us-ascii?Q?FC9CvCvbIr8qIvxdV/ZyMkXHMLZOtRfnmn1aFFfUTEOD0k8cF57jkbgNLeC+?= =?us-ascii?Q?qnNvBM6RkA/u7Z9AhJ8cCFW+kBtq91XdGCRR3+eWNHI0H5s52mzvAapY5JbR?= =?us-ascii?Q?azwAhPL0kveQG84hiVHygxxaHiTrb1cYQRWtb630YnwH4m1CZc6USjN0K5bB?= =?us-ascii?Q?hD5sjmJur7tfOstl+vimx2K/A3RN5iFSthieo7MY?= X-OriginatorOrg: Nvidia.com X-MS-Exchange-CrossTenant-Network-Message-Id: 645fe07c-fe12-474b-3181-08dda6cdcb58 X-MS-Exchange-CrossTenant-AuthSource: LV8PR12MB9620.namprd12.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 08 Jun 2025 20:48:16.7493 (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: +NR1egSNZo3BGVLljbZ+6JSbhyNpHEx+PZp2LoH/wT7Vq+7CHwVoIJeX5LnikiuJqpthvTsXlWOuovTO+iiNzw== X-MS-Exchange-Transport-CrossTenantHeadersStamped: PH7PR12MB9255 Content-Transfer-Encoding: quoted-printable Message-ID-Hash: HZNUUP7MHRZA75VUGHZBVOIOLPORQPL4 X-Message-ID-Hash: HZNUUP7MHRZA75VUGHZBVOIOLPORQPL4 X-MailFrom: arighi@nvidia.com X-Mailman-Rule-Misses: dmarc-mitigation; no-senders; approved; emergency; loop; banned-address; member-moderation; header-match-config-1; header-match-config-2; header-match-config-3; header-match-devel.lists.libvirt.org-0; nonmember-moderation; administrivia; implicit-dest; max-recipients; max-size; news-moderation; no-subject; suspicious-header X-Mailman-Version: 3.2.2 Precedence: list List-Id: Development discussions about the libvirt library & tools Archived-At: List-Archive: List-Help: 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: 1749415993342116600 Content-Type: text/plain; charset="utf-8" Signed-off-by: Andrea Righi --- docs/formatdomain.rst | 36 ++++++++++++++++++++++++++++++++++++ 1 file changed, 36 insertions(+) diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst index 1acf203d18..17c7ca2ae3 100644 --- a/docs/formatdomain.rst +++ b/docs/formatdomain.rst @@ -9093,6 +9093,42 @@ The ``virtio`` IOMMU devices can further have ``addr= ess`` element as described in `Device addresses`_ (address has to by type of ``pci``). =20 =20 +ACPI generic initiator +~~~~~~~~~~~~~~~~~~~~~~ + +The ACPI Generic Initiator device (GI) allows associating a PCI device with +a specific NUMA node in the guest through the ACPI Generic Initiator +namespace. + +This is required for certain accelerator configurations, such as NVIDIA +Multi-Instance GPU (MIG), where each virtual instance must be exposed to +the guest as a separate NUMA node. + +:since:`Since v11.5.0` + +:: + + ... + + dev0 + 1 + + ... + +The ``acpi-generic-initiator`` element has the following child elements: + +``pci-dev`` + Mandatory. Refers to the alias of a PCI device defined in the domain + configuration. + +``numa-node`` + Mandatory. Specifies the guest NUMA node that the PCI device should be + associated with through the GI mechanism. + +Multiple ``acpi-generic-initiator`` elements can be defined to map differe= nt PCI +devices to different guest NUMA nodes. + + Vsock ~~~~~ =20 --=20 2.49.0