Re: [Qemu-devel] qapi/misc.json is too big, let's bite off a few chunks

[Markus Armbruster <armbru@redhat.com>]

Paolo Bonzini <pbonzini@redhat.com> writes:

> On 07/06/19 10:25, Markus Armbruster wrote:
>> Paolo Bonzini <pbonzini@redhat.com> writes:
>> 
>>> On 23/05/19 18:14, Markus Armbruster wrote:
>>>> * Machine core (Eduardo, Marcel)
>>>>
>>>>   query-machines, query-current-machine, 
>>>>
>>>>   ~60 lines.  Hardly worthwhile from a "let's shrink misc.json" point of
>>>>   view.  Might be worthwhile from a "let's make get_maintainers.pl
>>>>   work".
>>>>
>>>> * CPUs (Paolo, Richard)
>>>>
>>>>   query-cpus, query-cpus-fast
>>>>
>>>>   ~300 lines.  The commands are implemented in cpus.c, which MAINTAINERS
>>>>   covers both under "Main loop" and under "Guest CPU cores (TCG) /
>>>>   Overall".  Neither feels right to me for these QMP commands.
>>>>
>>>> * NUMA (Eduardo)
>>>>
>>>>   query-memdev, set-numa-node
>>>>
>>>>   ~200 lines.
>>>
>>> I would move all three of these and add a new entry to MAINTAINERS.
>> 
>> Double-checking: do you propose to move all three to a single new QAPI
>> module, with a new MAINTAINERS entry covering just the new QAPI module?
>> If yes, care to propose a QAPI module file name, a MAINTAINERS head
>> line, and maintainers?
>
> Just one, qapi/machine.json, with a MAINTAINERS patch based on this one.

Okay, I'd like to take care of that.

>  We could probably create a new directory hw/machine too.

I'd prefer to leave that to you, because making you explain to me what
exactly you want moved is likely more work for both of us :)

> diff --git a/MAINTAINERS b/MAINTAINERS
> index a96829ea83..9bf3e6b670 100644
> --- a/MAINTAINERS
> +++ b/MAINTAINERS
> @@ -1274,8 +1274,12 @@ S: Supported
>  F: hw/core/machine.c
>  F: hw/core/null-machine.c
>  F: hw/cpu/cluster.c
> +F: numa.c
> +F: qom/cpu.c
>  F: include/hw/boards.h
>  F: include/hw/cpu/cluster.h
> +F: include/qom/cpu.h
> +F: include/sysemu/numa.h
>  T: git https://github.com/ehabkost/qemu.git machine-next
>
>  Xtensa Machines
> @@ -1839,12 +1843,6 @@ M: Markus Armbruster <armbru@redhat.com>
>  S: Supported
>  F: scripts/coverity-model.c
>
> -CPU
> -L: qemu-devel@nongnu.org
> -S: Supported
> -F: qom/cpu.c
> -F: include/qom/cpu.h
> -
>  Device Tree
>  M: Alistair Francis <alistair.francis@wdc.com>
>  R: David Gibson <david@gibson.dropbear.id.au>
> @@ -1947,13 +1945,6 @@ W: http://info.iet.unipi.it/~luigi/netmap/
>  S: Maintained
>  F: net/netmap.c
>
> -NUMA
> -M: Eduardo Habkost <ehabkost@redhat.com>
> -S: Maintained
> -F: numa.c
> -F: include/sysemu/numa.h
> -T: git https://github.com/ehabkost/qemu.git machine-next
> -
>  Host Memory Backends
>  M: Eduardo Habkost <ehabkost@redhat.com>
>  M: Igor Mammedov <imammedo@redhat.com>

This merges MAINTAINERS section "NUMA" into "Machine core" (with section
"CPU" thrown in for good measure).  Moving their QAPI schema bits from
misc.json to new machine.json then makes sense.  Good.

The part I'm unsure about is item "CPUs" from my list, i.e. query-cpus
and query-cpus-fast.  If I move these QAPI schema bits to machine.json
as well, then the QAPI schema for query-cpus, query-cpus-fast is covered
by section "Machine core", while the C code (in cpus.c) is covered by
"Main loop" and "Guest CPU cores (TCG) / Overall".  I hate that.  Would
you like me to try moving the C code out of cpus.c so it can be covered
by "Machine core"?

[...]