[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Qemu-devel] [PATCH v5 11/12] qmp: Add runnability information to query-
From: |
Eduardo Habkost |
Subject: |
[Qemu-devel] [PATCH v5 11/12] qmp: Add runnability information to query-cpu-definitions |
Date: |
Fri, 30 Sep 2016 15:49:45 -0300 |
Add a new optional field to query-cpu-definitions schema:
"unavailable-features". It will contain a list of QOM properties
that prevent the CPU model from running in the current host.
Cc: David Hildenbrand <address@hidden>
Cc: Michael Mueller <address@hidden>
Cc: Christian Borntraeger <address@hidden>
Cc: Cornelia Huck <address@hidden>
Cc: Jiri Denemark <address@hidden>
Cc: address@hidden
Reviewed-by: Eric Blake <address@hidden>
Signed-off-by: Eduardo Habkost <address@hidden>
---
Changes v3 -> v4:
* Changed doc to "since 2.8" as we missed 2.7
* Reported-by: Eric Blake <address@hidden>
Changes v2 -> v3:
* Small documentation reword
* Suggested-by: Markus Armbruster <address@hidden>
Changes v1 -> v2:
* Remove @runnable field, non-empty @unavailable-features is
enough to report CPU model as not runnable.
* Documentation updates:
* Changed to "(since 2.7)";
* Add more details about the exact meaning of
unavailable-features, and what it would mean to see
read-only QOM properties in the list, and that
implementations can return "type" if there's
no extra information available;
---
qapi-schema.json | 23 ++++++++++++++++++++++-
1 file changed, 22 insertions(+), 1 deletion(-)
diff --git a/qapi-schema.json b/qapi-schema.json
index c3dcf11..abb163b 100644
--- a/qapi-schema.json
+++ b/qapi-schema.json
@@ -3114,10 +3114,31 @@
# QEMU version, machine type, machine options and accelerator options.
# A static model is always migration-safe. (since 2.8)
#
+# @unavailable-features: #optional List of properties that prevent
+# the CPU model from running in the current
+# host. (since 2.8)
+#
+# @unavailable-features is a list of QOM property names that
+# represent CPU model attributes that prevent the CPU from running.
+# If the QOM property is read-only, that means there's no known
+# way to make the CPU model run in the current host. Implementations
+# that choose not to provide specific information return the
+# property name "type".
+# If the property is read-write, it means that it MAY be possible
+# to run the CPU model in the current host if that property is
+# changed. Management software can use it as hints to suggest or
+# choose an alternative for the user, or just to generate meaningful
+# error messages explaining why the CPU model can't be used.
+# If @unavailable-features is an empty list, the CPU model is
+# runnable using the current host and machine-type.
+# If @unavailable-features is not present, runnability
+# information for the CPU is not available.
+#
# Since: 1.2.0
##
{ 'struct': 'CpuDefinitionInfo',
- 'data': { 'name': 'str', '*migration-safe': 'bool', 'static': 'bool' } }
+ 'data': { 'name': 'str', '*migration-safe': 'bool', 'static': 'bool',
+ '*unavailable-features': [ 'str' ] } }
##
# @query-cpu-definitions:
--
2.7.4
- [Qemu-devel] [PATCH v5 00/12] Add runnability info to query-cpu-definitions, Eduardo Habkost, 2016/09/30
- [Qemu-devel] [PATCH v5 01/12] tests: Add test case for x86 feature parsing compatibility, Eduardo Habkost, 2016/09/30
- [Qemu-devel] [PATCH v5 02/12] target-i386: List CPU models using subclass list, Eduardo Habkost, 2016/09/30
- [Qemu-devel] [PATCH v5 03/12] target-i386: Disable VME by default with TCG, Eduardo Habkost, 2016/09/30
- [Qemu-devel] [PATCH v5 04/12] target-i386: Register aliases for feature names with underscores, Eduardo Habkost, 2016/09/30
- [Qemu-devel] [PATCH v5 05/12] target-i386: Make plus_features/minus_features QOM-based, Eduardo Habkost, 2016/09/30
- [Qemu-devel] [PATCH v5 06/12] target-i386: Remove underscores from feat_names arrays, Eduardo Habkost, 2016/09/30
- [Qemu-devel] [PATCH v5 07/12] target-i386: Register properties for feature aliases manually, Eduardo Habkost, 2016/09/30
- [Qemu-devel] [PATCH v5 08/12] target-i386: xsave: Add FP and SSE bits to x86_ext_save_areas, Eduardo Habkost, 2016/09/30
- [Qemu-devel] [PATCH v5 09/12] target-i386: Move warning code outside x86_cpu_filter_features(), Eduardo Habkost, 2016/09/30
- [Qemu-devel] [PATCH v5 11/12] qmp: Add runnability information to query-cpu-definitions,
Eduardo Habkost <=
- [Qemu-devel] [PATCH v5 10/12] target-i386: x86_cpu_load_features() function, Eduardo Habkost, 2016/09/30
- [Qemu-devel] [PATCH v5 12/12] target-i386: Return runnability information on query-cpu-definitions, Eduardo Habkost, 2016/09/30