[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[PATCH v25 01/21] qapi: machine.json: change docs regarding CpuInstanceP
From: |
Nina Schoetterl-Glausch |
Subject: |
[PATCH v25 01/21] qapi: machine.json: change docs regarding CpuInstanceProperties |
Date: |
Thu, 5 Oct 2023 18:01:35 +0200 |
Clarify roles of different architectures.
Also change things a bit in anticipation of additional members being
added.
Suggested-by: Markus Armbruster <armbru@redhat.com>
Signed-off-by: Nina Schoetterl-Glausch <nsg@linux.ibm.com>
---
qapi/machine.json | 15 ++++++++-------
1 file changed, 8 insertions(+), 7 deletions(-)
diff --git a/qapi/machine.json b/qapi/machine.json
index a08b6576ca..40b835e28e 100644
--- a/qapi/machine.json
+++ b/qapi/machine.json
@@ -71,8 +71,8 @@
#
# @thread-id: ID of the underlying host thread
#
-# @props: properties describing to which node/socket/core/thread
-# virtual CPU belongs to, provided if supported by board
+# @props: properties of type CpuInstanceProperties associated with a
+# virtual CPU, e.g. the socket id
#
# @target: the QEMU system emulation target, which determines which
# additional fields will be listed (since 3.0)
@@ -899,6 +899,9 @@
# should be passed by management with device_add command when a CPU is
# being hotplugged.
#
+# Which members are optional and which mandatory depends on the architecture
+# and board.
+#
# @node-id: NUMA node ID the CPU belongs to
#
# @socket-id: socket number within node/board the CPU belongs to
@@ -912,15 +915,13 @@
#
# @thread-id: thread number within core the CPU belongs to
#
-# Note: currently there are 6 properties that could be present but
-# management should be prepared to pass through other properties
-# with device_add command to allow for future interface extension.
-# This also requires the filed names to be kept in sync with the
-# properties passed to -device/device_add.
+# Note: management should be prepared to pass through additional
+# properties with device_add.
#
# Since: 2.7
##
{ 'struct': 'CpuInstanceProperties',
+ # Keep these in sync with the properties device_add accepts
'data': { '*node-id': 'int',
'*socket-id': 'int',
'*die-id': 'int',
--
2.39.2
- [PATCH v25 04/21] target/s390x/cpu topology: handle STSI(15) and build the SYSIB, (continued)
- [PATCH v25 04/21] target/s390x/cpu topology: handle STSI(15) and build the SYSIB, Nina Schoetterl-Glausch, 2023/10/05
- [PATCH v25 03/21] s390x/cpu topology: add topology entries on CPU hotplug, Nina Schoetterl-Glausch, 2023/10/05
- [PATCH v25 07/21] s390x/cpu topology: interception of PTF instruction, Nina Schoetterl-Glausch, 2023/10/05
- [PATCH v25 09/21] qapi/s390x/cpu topology: set-cpu-topology qmp command, Nina Schoetterl-Glausch, 2023/10/05
- [PATCH v25 10/21] machine: adding s390 topology to query-cpu-fast, Nina Schoetterl-Glausch, 2023/10/05
- [PATCH v25 01/21] qapi: machine.json: change docs regarding CpuInstanceProperties,
Nina Schoetterl-Glausch <=
- [PATCH v25 06/21] s390x/cpu topology: resetting the Topology-Change-Report, Nina Schoetterl-Glausch, 2023/10/05
- [PATCH v25 20/21] tests/avocado: s390x cpu topology dedicated errors, Nina Schoetterl-Glausch, 2023/10/05
- [PATCH v25 19/21] tests/avocado: s390x cpu topology test socket full, Nina Schoetterl-Glausch, 2023/10/05