From 07e1a18accee37a2850f3825c85cb29b1599b1e0 Mon Sep 17 00:00:00 2001 From: Daniel Henrique Barboza Date: Wed, 10 Jun 2020 15:35:53 -0300 Subject: [PATCH] formatdomain.html.in: document the NUMA cpus auto fill feature We're not mentioning that we're replicating QEMU behavior on purpose. First because QEMU will one day, maybe, change the behavior and start to refuse incomplete NUMA setups, and then our documentation is now deprecated. Second, auto filling the CPUs in the first cell will work regardless of QEMU changes in the future. The idea is to encourage the user to provide a complete NUMA CPU topology, not relying on the CPU auto fill mechanic. Signed-off-by: Daniel Henrique Barboza Reviewed-by: Michal Privoznik --- docs/formatdomain.html.in | 11 ++++++++++- 1 file changed, 10 insertions(+), 1 deletion(-) diff --git a/docs/formatdomain.html.in b/docs/formatdomain.html.in index 20c28a47e3..07d0fa5c70 100644 --- a/docs/formatdomain.html.in +++ b/docs/formatdomain.html.in @@ -1829,7 +1829,16 @@

Each cell element specifies a NUMA cell or a NUMA node. cpus specifies the CPU or range of CPUs that are - part of the node. memory specifies the node memory + part of the node. Since 6.5.0 For the qemu + driver, if the emulator binary supports disjointed cpus ranges + in each cell, the sum of all CPUs declared in each cell + will be matched with the maximum number of virtual CPUs declared in the + vcpu element. This is done by filling any remaining CPUs + into the first NUMA cell. Users are encouraged to supply a + complete NUMA topology, where the sum of the NUMA CPUs matches the maximum + virtual CPUs number declared in vcpus, to make the domain + consistent across qemu and libvirt versions. + memory specifies the node memory in kibibytes (i.e. blocks of 1024 bytes). Since 1.2.11 one can use an additional unit attribute to -- 2.47.2