On Mon, Jan 08, 2024 at 20:26:08 +0100, Andrea Bolognani wrote: > Mention that support for the "dies" attribute was introduced in > libvirt 6.1.0 and clarify that the ability to use non-default > values is subject to architecuture and machine limitations. > > Signed-off-by: Andrea Bolognani <abologna@xxxxxxxxxx> > --- > docs/formatdomain.rst | 16 ++++++++++------ > 1 file changed, 10 insertions(+), 6 deletions(-) > > diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst > index 298ad46a45..b883b5b479 100644 > --- a/docs/formatdomain.rst > +++ b/docs/formatdomain.rst > @@ -1578,14 +1578,18 @@ In case no restrictions need to be put on CPU model and its features, a simpler > supported vendors can be found in ``cpu_map/*_vendors.xml``. > ``topology`` > The ``topology`` element specifies requested topology of virtual CPU provided > - to the guest. Four attributes, ``sockets``, ``dies``, ``cores``, and > - ``threads``, accept non-zero positive integer values. They refer to the > - total number of CPU sockets, number of dies per socket, number of cores per > - die, and number of threads per core, respectively. The ``dies`` attribute is > - optional and will default to 1 if omitted, while the other attributes are all > - mandatory. Hypervisors may require that the maximum number of vCPUs specified > + to the guest. > + Four attributes, ``sockets``, ``dies`` (:since:`Since 6.1.0`), ``cores``, and s/Four/The/ so that it doesn't need to be incremented all the time. > + ``threads``, accept non-zero positive integer values. > + They refer to the total number of CPU sockets, number of dies per socket, > + number of cores per die, and number of threads per core, respectively. > + The ``dies`` attribute is optional and will default to 1 if omitted, while > + the other attributes are all mandatory. > + Hypervisors may require that the maximum number of vCPUs specified > by the ``cpus`` element equals to the number of vcpus resulting from the > topology. > + Moreover, not all architectures and machine types support specifying a value > + other than 1 for all attributes. > ``feature`` > The ``cpu`` element can contain zero or more ``feature`` elements used to > fine-tune features provided by the selected CPU model. The list of known > -- > 2.43.0 > _______________________________________________ > Devel mailing list -- devel@xxxxxxxxxxxxxxxxx > To unsubscribe send an email to devel-leave@xxxxxxxxxxxxxxxxx Reviewed-by: Peter Krempa <pkrempa@xxxxxxxxxx> _______________________________________________ Devel mailing list -- devel@xxxxxxxxxxxxxxxxx To unsubscribe send an email to devel-leave@xxxxxxxxxxxxxxxxx
