summaryrefslogtreecommitdiffstats
path: root/qapi-schema.json
diff options
context:
space:
mode:
authorEduardo Habkost2017-01-16 22:11:22 +0100
committerEduardo Habkost2017-02-27 17:23:13 +0100
commita357a65b66a59488f3f5f09298a01df31319c624 (patch)
tree642afe57d3d0b1aa0b111d70ae8aea9a4e4bb819 /qapi-schema.json
parenti386: Reorganize and document CPUID initialization steps (diff)
downloadqemu-a357a65b66a59488f3f5f09298a01df31319c624.tar.gz
qemu-a357a65b66a59488f3f5f09298a01df31319c624.tar.xz
qemu-a357a65b66a59488f3f5f09298a01df31319c624.zip
qapi-schema: Comment about full expansion of non-migration-safe models
Add a note warning that static expansion may not be 100% accurate when the CPU model is not migration-safe. This will be the case on x86 when expansing the "host" CPU model, because there are "host" features that can't have a migration-safe representation (e.g. "host-cache-info"). Message-Id: <20170116211124.29245-3-ehabkost@redhat.com> Signed-off-by: Eduardo Habkost <ehabkost@redhat.com>
Diffstat (limited to 'qapi-schema.json')
-rw-r--r--qapi-schema.json9
1 files changed, 9 insertions, 0 deletions
diff --git a/qapi-schema.json b/qapi-schema.json
index 150ee98e9e..2051c46cfc 100644
--- a/qapi-schema.json
+++ b/qapi-schema.json
@@ -4274,6 +4274,15 @@
# migration-safe, but allows tooling to get an insight and work with
# model details.
#
+# Note: When a non-migration-safe CPU model is expanded in static mode, some
+# features enabled by the CPU model may be omitted, because they can't be
+# implemented by a static CPU model definition (e.g. cache info passthrough and
+# PMU passthrough in x86). If you need an accurate representation of the
+# features enabled by a non-migration-safe CPU model, use @full. If you need a
+# static representation that will keep ABI compatibility even when changing QEMU
+# version or machine-type, use @static (but keep in mind that some features may
+# be omitted).
+#
# Since: 2.8.0
##
{ 'enum': 'CpuModelExpansionType',