qemu/qapi/machine-target.json

1 # -*- Mode: Python -*-
4 # This work is licensed under the terms of the GNU GPL, version 2 or later.
5 # See the COPYING file in the top-level directory.
7 { 'include': 'machine-common.json' }
14 # A CPU model consists of the name of a CPU definition, to which delta
20 # @name: the name of the CPU definition the model is based on
22 # @props: a dictionary of QOM properties to be applied
33 # An enumeration of CPU model expansion types.
35 # @static: Expand to a static CPU model, a combination of a static
38 #     same, independent of QEMU version, machine type, machine
41 #     compatibility machine - e.g. when displaying the "host" model.
42 #     The @static CPU models are migration-safe.
45 #     to be migration-safe, but allows tooling to get an insight and
48 # .. note:: When a non-migration-safe CPU model is expanded in static
52 #    x86).  If you need an accurate representation of the features
53 #    enabled by a non-migration-safe CPU model, use @full.  If you
55 #    even when changing QEMU version or machine-type, use @static (but
66 # An enumeration of CPU model comparison results.  The result is
75 # @superset: If model A is a superset of model B, model B is
79 # @subset: If model A is a subset of model B, model A is guaranteed to
86   'data': [ 'incompatible', 'identical', 'superset', 'subset' ] }
91 # The result of a CPU model baseline.
104 # The result of a CPU model comparison.
106 # @result: The result of the compare operation.
108 # @responsible-properties: List of properties that led to the
111 # @responsible-properties is a list of QOM property names that led to
113 # this list is empty.  If a QOM property is read-only, that means
122             'responsible-properties': ['str'] },
126 # @query-cpu-model-comparison:
136 # model of a certain configuration (e.g. the "host" model for KVM).
137 # If that CPU model is identical or a subset, it will run in that
144 #   query-cpu-definitions.)
145 # * machine-type: CPU model may look different depending on the
146 #   machine-type.  (Except for CPU models reported as "static" in
147 #   query-cpu-definitions.)
151 #   query-cpu-definitions.)
152 # * "-cpu" arguments and global properties: arguments to the -cpu
153 #   option and global properties may affect expansion of CPU models.
154 #   Using query-cpu-model-expansion while using these is not advised.
159 # @modela: description of the first CPU model to compare, referred to
162 # @modelb: description of the second CPU model to compare, referred to
169 #     - if comparing CPU models is not supported
170 #     - if a model cannot be used
171 #     - if a model contains an unknown cpu definition name, unknown
179 { 'command': 'query-cpu-model-comparison',
185 # @query-cpu-model-baseline:
189 # migration-safe CPU model (see "static" CPU model expansion for
194 # to or a subset of both CPU models when comparing them.  Therefore,
202 #   query-cpu-definitions.)
203 # * machine-type: CPU model may look different depending on the
204 #   machine-type.  (Except for CPU models reported as "static" in
205 #   query-cpu-definitions.)
209 #   query-cpu-definitions.)
210 # * "-cpu" arguments and global properties: arguments to the -cpu
211 #   option and global properties may affect expansion of CPU models.
212 #   Using query-cpu-model-expansion while using these is not advised.
217 # @modela: description of the first CPU model to baseline
219 # @modelb: description of the second CPU model to baseline
224 #     - if baselining CPU models is not supported
225 #     - if a model cannot be used
226 #     - if a model contains an unknown cpu definition name, unknown
234 { 'command': 'query-cpu-model-baseline',
243 # The result of a cpu model expansion.
247 # @deprecated-props: a list of properties that are flagged as
249 #     CpuModelExpansionType: "static" properties are a subset of the
250 #     enabled-properties for the expanded model; "full" properties are
251 #     a set of properties that are deprecated across all models for
258             'deprecated-props' : { 'type': ['str'],
267 # @query-cpu-model-expansion:
269 # Expands a given CPU model, @model, (or a combination of CPU model +
280 #   query-cpu-definitions.)
281 # * machine-type: CPU model may look different depending on the
282 #   machine-type.  (Except for CPU models reported as "static" in
283 #   query-cpu-definitions.)
287 #   query-cpu-definitions.)
288 # * "-cpu" arguments and global properties: arguments to the -cpu
289 #   option and global properties may affect expansion of CPU models.
290 #   Using query-cpu-model-expansion while using these is not advised.
295 # @model: description of the CPU model to expand
302 #     - if expanding CPU models is not supported
303 #     - if the model cannot be expanded
304 #     - if the model contains an unknown CPU definition name, unknown
306 #     - if an expansion type is not supported
310 { 'command': 'query-cpu-model-expansion',
325 # @name: the name of the CPU definition
327 # @migration-safe: whether a CPU definition can be safely used for
330 #     different sets of (hardware or software) capabilities.  If not
332 #     assume the CPU definition to be migration-safe.  (since 2.8)
336 #     accelerator options.  A static model is always migration-safe.
339 # @unavailable-features: List of properties that prevent the CPU model
343 #     @device-list-properties, to introspect properties configurable
344 #     using -cpu or -global.  (since 2.9)
346 # @alias-of: Name of CPU model this model is an alias for.  The target
347 #     of the CPU model alias may change depending on the machine type.
350 #     migration-safe in the future (since 4.1)
353 #     removed in in some future version of QEMU according to the QEMU
356 # @unavailable-features is a list of QOM property names that represent
358 # property is read-only, that means there's no known way to make the
361 # the property is read-write, it means that it MAY be possible to run
366 # @unavailable-features is an empty list, the CPU model is runnable
367 # using the current host and machine-type.  If @unavailable-features
375             '*migration-safe': 'bool',
377             '*unavailable-features': [ 'str' ],
379             '*alias-of' : 'str',
390 # @query-cpu-definitions:
392 # Return a list of supported virtual CPU definitions
394 # Returns: a list of CpuDefinitionInfo
398 { 'command': 'query-cpu-definitions', 'returns': ['CpuDefinitionInfo'],
410 # An enumeration of CPU polarization that can be assumed by a virtual
421 # @set-cpu-topology:
424 # by changing a modifier attribute of a CPU.  Absent values will not
427 # @core-id: the vCPU ID to be moved
429 # @socket-id: destination socket to move the vCPU to
431 # @book-id: destination book to move the vCPU to
433 # @drawer-id: destination drawer to move the vCPU to
437 # @dedicated: whether the provisioning of real to virtual CPU is
446 { 'command': 'set-cpu-topology',
448       'core-id': 'uint16',
449       '*socket-id': 'uint16',
450       '*book-id': 'uint16',
451       '*drawer-id': 'uint16',
472 # differently.  The guest will get information on the details of the
483 # .. qmp-example::
485 #     <- { "event": "CPU_POLARIZATION_CHANGE",
498 # The result of a CPU polarization query.
510 # @query-s390x-cpu-polarization:
520 { 'command': 'query-s390x-cpu-polarization', 'returns': 'CpuPolarizationInfo',