qemu/qapi/machine.json

185 # @default-cpu-type: default CPU model typename if none is requested
1863 # Virtual CPU model.
1865 # A CPU model consists of the name of a CPU definition, to which delta
1871 # @name: the name of the CPU definition the model is based on
1884 # An enumeration of CPU model expansion types.
1886 # @static: Expand to a static CPU model, a combination of a static
1887 #     base model name and property delta changes.  As the static base
1888 #     model will never change, the expanded CPU model will be the
1891 #     model can be used by tooling without having to specify a
1892 #     compatibility machine - e.g. when displaying the "host" model.
1895 # @full: Expand all properties.  The produced model is not guaranteed
1897 #     work with model details.
1899 # .. note:: When a non-migration-safe CPU model is expanded in static
1900 #    mode, some features enabled by the CPU model may be omitted,
1901 #    because they can't be implemented by a static CPU model
1904 #    enabled by a non-migration-safe CPU model, use @full.  If you
1917 # An enumeration of CPU model comparison results.  The result is
1920 # @incompatible: If model A is incompatible to model B, model A is not
1921 #     guaranteed to run where model B runs and the other way around.
1923 # @identical: If model A is identical to model B, model A is
1924 #     guaranteed to run where model B runs and the other way around.
1926 # @superset: If model A is a superset of model B, model B is
1927 #     guaranteed to run where model A runs.  There are no guarantees
1930 # @subset: If model A is a subset of model B, model A is guaranteed to
1931 #     run where model B runs.  There are no guarantees about the other
1942 # The result of a CPU model baseline.
1944 # @model: the baselined `CpuModelInfo`.
1949   'data': { 'model': 'CpuModelInfo' } }
1954 # The result of a CPU model comparison.
1975 # @query-cpu-model-comparison:
1980 # used by tooling to make decisions if a certain CPU model will
1981 # run in a certain configuration or if a compatible CPU model has
1984 # Usually, a CPU model is compared against the maximum possible CPU
1985 # model of a certain configuration (e.g. the "host" model for KVM).
1986 # If that CPU model is identical or a subset, it will run in that
1994 # * machine-type: CPU model may look different depending on the
2003 #   Using `query-cpu-model-expansion` while using these is not advised.
2008 # @modela: description of the first CPU model to compare, referred to
2009 #     as "model A" in `CpuModelCompareResult`
2011 # @modelb: description of the second CPU model to compare, referred to
2012 #     as "model B" in `CpuModelCompareResult`
2019 #     - if a model cannot be used
2020 #     - if a model contains an unknown cpu definition name, unknown
2025 { 'command': 'query-cpu-model-comparison',
2030 # @query-cpu-model-baseline:
2033 # third model.  The created model will always be a static,
2034 # migration-safe CPU model (see "static" CPU model expansion for
2038 # model out two CPU models.  The created CPU model will be identical
2040 # the created CPU model is guaranteed to run where the given CPU
2048 # * machine-type: CPU model may look different depending on the
2057 #   Using `query-cpu-model-expansion` while using these is not advised.
2062 # @modela: description of the first CPU model to baseline
2064 # @modelb: description of the second CPU model to baseline
2066 # Returns: a `CpuModelBaselineInfo` describing the baselined CPU model
2070 #     - if a model cannot be used
2071 #     - if a model contains an unknown cpu definition name, unknown
2076 { 'command': 'query-cpu-model-baseline',
2084 # The result of a cpu model expansion.
2086 # @model: the expanded `CpuModelInfo`.
2091 #     enabled-properties for the expanded model; "full" properties are
2098   'data': { 'model': 'CpuModelInfo',
2102 # @query-cpu-model-expansion:
2104 # Expands a given CPU model, @model, (or a combination of CPU model +
2106 # allowing tooling to get an understanding what a specific CPU model
2109 # This interface can be used to query the "host" CPU model.
2116 # * machine-type: CPU model may look different depending on the
2125 #   Using `query-cpu-model-expansion` while using these is not advised.
2130 # @model: description of the CPU model to expand
2132 # @type: expansion type, specifying how to expand the CPU model
2134 # Returns: a `CpuModelExpansionInfo` describing the expanded CPU model
2138 #     - if the model cannot be expanded
2139 #     - if the model contains an unknown CPU definition name, unknown
2145 { 'command': 'query-cpu-model-expansion',
2147             'model': 'CpuModelInfo' },
2166 #     accelerator options.  A static model is always migration-safe.
2169 # @unavailable-features: List of properties that prevent the CPU model
2176 # @alias-of: Name of CPU model this model is an alias for.  The target
2177 #     of the CPU model alias may change depending on the machine type.
2178 #     Management software is supposed to translate CPU model aliases
2182 # @deprecated: If true, this CPU model is deprecated and may be
2187 # CPU model attributes that prevent the CPU from running.  If the QOM
2189 # CPU model run in the current host.  Implementations that choose not
2192 # the CPU model in the current host if that property is changed.
2195 # messages explaining why the CPU model can't be used.  If
2196 # @unavailable-features is an empty list, the CPU model is runnable