[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [PATCH v5 01/14] qemu-options: Improve readability of SMP related Do
From: |
Philippe Mathieu-Daudé |
Subject: |
Re: [PATCH v5 01/14] qemu-options: Improve readability of SMP related Docs |
Date: |
Tue, 28 Dec 2021 20:11:00 +0100 |
User-agent: |
Mozilla/5.0 (X11; Linux x86_64; rv:91.0) Gecko/20100101 Thunderbird/91.4.0 |
On 12/28/21 10:22, Yanan Wang wrote:
> We have a description in qemu-options.hx for each CPU topology
> parameter to explain what it exactly means, and also an extra
> declaration for the target-specific one, e.g. "for PC only"
> when describing "dies", and "for PC, it's on one die" when
> describing "cores".
>
> Now we are going to introduce one more non-generic parameter
> "clusters", it will make the Doc less readable and if we still
> continue to use the legacy way to describe it.
>
> So let's at first make two tweaks of the Docs to improve the
> readability and also scalability:
> 1) In the -help text: Delete the extra specific declaration and
> describe each topology parameter level by level. Then add a
> note to declare that different machines may support different
> subsets and the actual meaning of the supported parameters
> will vary accordingly.
> 2) In the rST text: List all the sub-hierarchies currently
> supported in QEMU, and correspondingly give an example of
> -smp configuration for each of them.
>
> Signed-off-by: Yanan Wang <wangyanan55@huawei.com>
> ---
> qemu-options.hx | 76 ++++++++++++++++++++++++++++++++++++++-----------
> 1 file changed, 59 insertions(+), 17 deletions(-)
Reviewed-by: Philippe Mathieu-Daudé <philmd@redhat.com>
[PATCH v5 06/14] tests/unit/test-smp-parse: Keep default MIN/MAX CPUs in machine_base_class_init, Yanan Wang, 2021/12/28
[PATCH v5 05/14] tests/unit/test-smp-parse: No need to explicitly zero MachineClass members, Yanan Wang, 2021/12/28