From d983a6bf3bb04d9ab6f60edc527c76ba22b5d3ae Mon Sep 17 00:00:00 2001 From: Andrea Righi Date: Sat, 6 Sep 2025 15:09:02 +0200 Subject: [PATCH] docs: Document acpi nodeset in hostdev MIME-Version: 1.0 Content-Type: text/plain; charset=utf8 Content-Transfer-Encoding: 8bit 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. Reviewed-by: Daniel P. Berrangé 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..b327ff87a7 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`. +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. + +:: + + + + + + + + + + + + + ... + + +
+ + +
+ + +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 ^^^^^^^^^^^^^^^^^^^^^^^^^ -- 2.47.3