qemu/qapi/machine-target.json

12 # Virtual CPU model.
14 # A CPU model consists of the name of a CPU definition, to which delta
19 # @name: the name of the CPU definition the model is based on
32 # An enumeration of CPU model expansion types.
34 # @static: Expand to a static CPU model, a combination of a static
35 #     base model name and property delta changes.  As the static base
36 #     model will never change, the expanded CPU model will be the
39 #     model can be used by tooling without having to specify a
40 #     compatibility machine - e.g. when displaying the "host" model.
43 # @full: Expand all properties.  The produced model is not guaranteed
45 #     work with model details.
47 # Note: When a non-migration-safe CPU model is expanded in static
48 #     mode, some features enabled by the CPU model may be omitted,
49 #     because they can't be implemented by a static CPU model
52 #     enabled by a non-migration-safe CPU model, use @full.  If you
65 # An enumeration of CPU model comparison results.  The result is
68 # @incompatible: If model A is incompatible to model B, model A is not
69 #     guaranteed to run where model B runs and the other way around.
71 # @identical: If model A is identical to model B, model A is
72 #     guaranteed to run where model B runs and the other way around.
74 # @superset: If model A is a superset of model B, model B is
75 #     guaranteed to run where model A runs.  There are no guarantees
78 # @subset: If model A is a subset of model B, model A is guaranteed to
79 #     run where model B runs.  There are no guarantees about the other
90 # The result of a CPU model baseline.
92 # @model: the baselined CpuModelInfo.
97   'data': { 'model': 'CpuModelInfo' },
103 # The result of a CPU model comparison.
125 # @query-cpu-model-comparison:
130 # decisions if a certain CPU model will run in a certain configuration
131 # or if a compatible CPU model has to be created by baselining.
133 # Usually, a CPU model is compared against the maximum possible CPU
134 # model of a certain configuration (e.g. the "host" model for KVM).
135 # If that CPU model is identical or a subset, it will run in that
143 # * machine-type: CPU model may look different depending on the
152 #   Using query-cpu-model-expansion while using these is not advised.
158 #     models is not supported, if a model cannot be used, if a model
167 { 'command': 'query-cpu-model-comparison',
173 # @query-cpu-model-baseline:
175 # Baseline two CPU models, creating a compatible third model.  The
176 # created model will always be a static, migration-safe CPU model (see
177 # "static" CPU model expansion for details).
180 # model out two CPU models.  The created CPU model will be identical
182 # the created CPU model is guaranteed to run where the given CPU
190 # * machine-type: CPU model may look different depending on the
199 #   Using query-cpu-model-expansion while using these is not advised.
205 #     models is not supported, if a model cannot be used, if a model
214 { 'command': 'query-cpu-model-baseline',
223 # The result of a cpu model expansion.
225 # @model: the expanded CpuModelInfo.
230   'data': { 'model': 'CpuModelInfo' },
238 # @query-cpu-model-expansion:
240 # Expands a given CPU model (or a combination of CPU model +
242 # get an understanding what a specific CPU model looks like in QEMU
245 # This interface can be used to query the "host" CPU model.
252 # * machine-type: CPU model may look different depending on the
261 #   Using query-cpu-model-expansion while using these is not advised.
267 #     models is not supported, if the model cannot be expanded, if the
268 #     model contains an unknown CPU definition name, unknown
274 { 'command': 'query-cpu-model-expansion',
276             'model': 'CpuModelInfo' },
300 #     accelerator options.  A static model is always migration-safe.
303 # @unavailable-features: List of properties that prevent the CPU model
310 # @alias-of: Name of CPU model this model is an alias for.  The target
311 #     of the CPU model alias may change depending on the machine type.
312 #     Management software is supposed to translate CPU model aliases
316 # @deprecated: If true, this CPU model is deprecated and may be
321 # CPU model attributes that prevent the CPU from running.  If the QOM
323 # CPU model run in the current host.  Implementations that choose not
326 # the CPU model in the current host if that property is changed.
329 # messages explaining why the CPU model can't be used.  If
330 # @unavailable-features is an empty list, the CPU model is runnable