[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [Qemu-devel] [PATCH v5 18/22] s390x: implement query-hotpluggable-cp
From: |
Markus Armbruster |
Subject: |
Re: [Qemu-devel] [PATCH v5 18/22] s390x: implement query-hotpluggable-cpus |
Date: |
Wed, 04 Oct 2017 14:42:55 +0200 |
User-agent: |
Gnus/5.13 (Gnus v5.13) Emacs/25.3 (gnu/linux) |
Cornelia Huck <address@hidden> writes:
> On Mon, 02 Oct 2017 09:46:41 +0200
> Markus Armbruster <address@hidden> wrote:
>
>> David Hildenbrand <address@hidden> writes:
>>
>> > CPU hotplug is only possible on a per core basis on s390x. So let's
>> > add possible_cpus and properly wire everything up.
>> >
>> > Signed-off-by: David Hildenbrand <address@hidden>
>> [...]
>> > diff --git a/qapi-schema.json b/qapi-schema.json
>> > index f3af2cb851..79e9f85404 100644
>> > --- a/qapi-schema.json
>> > +++ b/qapi-schema.json
>> > @@ -3121,6 +3121,22 @@
>> > # }
>> > # ]}
>> > #
>> > +# For s390x-virtio-ccw machine type started with -smp 1,maxcpus=2 -cpu
>> > qemu
>> > +# (Since: 2.11):
>> > +#
>> > +# -> { "execute": "query-hotpluggable-cpus" }
>> > +# <- {"return": [
>> > +# {
>> > +# "type": "qemu-s390-cpu", "vcpus-count": 1,
>> > +# "props": { "core-id": 1 }
>> > +# },
>> > +# {
>> > +# "qom-path": "/machine/unattached/device[0]",
>> > +# "type": "qemu-s390-cpu", "vcpus-count": 1,
>> > +# "props": { "core-id": 0 }
>> > +# }
>> > +# ]}
>> > +#
>> > ##
>> > { 'command': 'query-hotpluggable-cpus', 'returns': ['HotpluggableCPU'] }
>>
>> Please stick in '# Example:' like we do in query-hotpluggable-cpus's doc
>> comment. I expect the generated documentation to be illegible[*]
>> without it.
>
> Should '# Example:' go before each of the examples (instead of the
> beginning of the example block), then?
Whatever makes the generated documentation look better.
>> [*] If you want to perform a quick eye-over, try running "make
>> tests/qapi-schema/doc-good.test.txt" and examine the result.
>
> Hmm... I might be missing something in my setup:
>
> address@hidden build]$ make tests/qapi-schema/doc-good.test.txt
> GEN tests/qapi-schema/doc-good.test.txt
> tests/qapi-schema/doc-good.test.texi:79: @subsection seen before @end deftp
> tests/qapi-schema/doc-good.test.texi:90: unmatched address@hidden deftp'
> make: *** [Makefile:695: tests/qapi-schema/doc-good.test.txt] Error 1
Pasto, sorry! Try "make docs/interop/qemu-qmp-ref.txt". .pdf and .html
also work.