qemu/docs/about
Zhao Liu 54c4ea8f3a hw/core/machine-smp: Deprecate unsupported "parameter=1" SMP configurations
Currently, it was allowed for users to specify the unsupported
topology parameter as "1". For example, x86 PC machine doesn't
support drawer/book/cluster topology levels, but user could specify
"-smp drawers=1,books=1,clusters=1".

This is meaningless and confusing, so that the support for this kind of
configurations is marked deprecated since 9.0. And report warning
message for such case like:

qemu-system-x86_64: warning: Deprecated CPU topology (considered invalid):
                    Unsupported clusters parameter mustn't be specified as 1
qemu-system-x86_64: warning: Deprecated CPU topology (considered invalid):
                    Unsupported books parameter mustn't be specified as 1
qemu-system-x86_64: warning: Deprecated CPU topology (considered invalid):
                    Unsupported drawers parameter mustn't be specified as 1

Users have to ensure that all the topology members described with -smp
are supported by the target machine.

Signed-off-by: Zhao Liu <zhao1.liu@intel.com>
Reviewed-by: Thomas Huth <thuth@redhat.com>
Message-ID: <20240308160148.3130837-3-zhao1.liu@linux.intel.com>
Signed-off-by: Philippe Mathieu-Daudé <philmd@linaro.org>
2024-03-09 19:17:01 +01:00
..
build-platforms.rst docs: Document that 32-bit Windows is unsupported 2024-02-23 08:13:52 +01:00
deprecated.rst hw/core/machine-smp: Deprecate unsupported "parameter=1" SMP configurations 2024-03-09 19:17:01 +01:00
emulation.rst docs/emulation: expand warning about semihosting 2023-11-23 14:10:06 +00:00
index.rst accel: Remove HAX accelerator 2023-08-31 19:46:43 +02:00
license.rst docs/about/license: Update LICENSE URL 2023-08-23 09:04:33 -04:00
removed-features.rst hw/core/machine-smp: Remove deprecated "parameter=0" SMP configurations 2024-03-09 19:17:01 +01:00