mirrors/qemu
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

qapi: Normalize version references x.y.0 to just x.y

Browse Source 
We use x.y most of the time, and x.y.0 sometimes.  Normalize for
consistency.

Reported-by: Eduardo Habkost <ehabkost@redhat.com>
Signed-off-by: Markus Armbruster <armbru@redhat.com>
Message-Id: <20201118064158.3359056-1-armbru@redhat.com>
Reviewed-by: Eric Blake <eblake@redhat.com>
This commit is contained in:
Markus Armbruster 2020-11-18 07:41:58 +01:00
parent 6cc0667d9b
commit 9bc6e893b7
15 changed files with 123 additions and 123 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

28
qapi/block-core.json
View File

@ -302,7 +302,7 @@
# @ro: true if the backing device was open read-only # @ro: true if the backing device was open read-only
# #
# @drv: the name of the block format used to open the backing device. As of # @drv: the name of the block format used to open the backing device. As of
# 0.14.0 this can be: 'blkdebug', 'bochs', 'cloop', 'cow', 'dmg', # 0.14 this can be: 'blkdebug', 'bochs', 'cloop', 'cow', 'dmg',
# 'file', 'file', 'ftp', 'ftps', 'host_cdrom', 'host_device', # 'file', 'file', 'ftp', 'ftps', 'host_cdrom', 'host_device',
# 'http', 'https', 'luks', 'nbd', 'parallels', 'qcow', # 'http', 'https', 'luks', 'nbd', 'parallels', 'qcow',
# 'qcow2', 'raw', 'vdi', 'vmdk', 'vpc', 'vvfat' # 'qcow2', 'raw', 'vdi', 'vmdk', 'vpc', 'vvfat'
@ -389,7 +389,7 @@
# @deprecated: Member @encryption_key_missing is deprecated. It is # @deprecated: Member @encryption_key_missing is deprecated. It is
# always false. # always false.
# #
# Since: 0.14.0 # Since: 0.14
# #
## ##
{ 'struct': 'BlockDeviceInfo', { 'struct': 'BlockDeviceInfo',
@ -607,7 +607,7 @@
# @deprecated: Member @dirty-bitmaps is deprecated. Use @inserted # @deprecated: Member @dirty-bitmaps is deprecated. Use @inserted
# member @dirty-bitmaps instead. # member @dirty-bitmaps instead.
# #
# Since: 0.14.0 # Since: 0.14
## ##
{ 'struct': 'BlockInfo', { 'struct': 'BlockInfo',
'data': {'device': 'str', '*qdev': 'str', 'type': 'str', 'removable': 'bool', 'data': {'device': 'str', '*qdev': 'str', 'type': 'str', 'removable': 'bool',
@ -655,7 +655,7 @@
# Returns: a list of @BlockInfo describing each virtual block device. Filter # Returns: a list of @BlockInfo describing each virtual block device. Filter
# nodes that were created implicitly are skipped over. # nodes that were created implicitly are skipped over.
# #
# Since: 0.14.0 # Since: 0.14
# #
# Example: # Example:
# #
@ -812,17 +812,17 @@
# @wr_operations: The number of write operations performed by the device. # @wr_operations: The number of write operations performed by the device.
# #
# @flush_operations: The number of cache flush operations performed by the # @flush_operations: The number of cache flush operations performed by the
# device (since 0.15.0) # device (since 0.15)
# #
# @unmap_operations: The number of unmap operations performed by the device # @unmap_operations: The number of unmap operations performed by the device
# (Since 4.2) # (Since 4.2)
# #
# @rd_total_time_ns: Total time spent on reads in nanoseconds (since 0.15.0). # @rd_total_time_ns: Total time spent on reads in nanoseconds (since 0.15).
# #
# @wr_total_time_ns: Total time spent on writes in nanoseconds (since 0.15.0). # @wr_total_time_ns: Total time spent on writes in nanoseconds (since 0.15).
# #
# @flush_total_time_ns: Total time spent on cache flushes in nanoseconds # @flush_total_time_ns: Total time spent on cache flushes in nanoseconds
# (since 0.15.0). # (since 0.15).
# #
# @unmap_total_time_ns: Total time spent on unmap operations in nanoseconds # @unmap_total_time_ns: Total time spent on unmap operations in nanoseconds
# (Since 4.2) # (Since 4.2)
@ -884,7 +884,7 @@
# #
# @flush_latency_histogram: @BlockLatencyHistogramInfo. (Since 4.0) # @flush_latency_histogram: @BlockLatencyHistogramInfo. (Since 4.0)
# #
# Since: 0.14.0 # Since: 0.14
## ##
{ 'struct': 'BlockDeviceStats', { 'struct': 'BlockDeviceStats',
'data': {'rd_bytes': 'int', 'wr_bytes': 'int', 'unmap_bytes' : 'int', 'data': {'rd_bytes': 'int', 'wr_bytes': 'int', 'unmap_bytes' : 'int',
@ -987,7 +987,7 @@
# @backing: This describes the backing block device if it has one. # @backing: This describes the backing block device if it has one.
# (Since 2.0) # (Since 2.0)
# #
# Since: 0.14.0 # Since: 0.14
## ##
{ 'struct': 'BlockStats', { 'struct': 'BlockStats',
'data': {'*device': 'str', '*qdev': 'str', '*node-name': 'str', 'data': {'*device': 'str', '*qdev': 'str', '*node-name': 'str',
@ -1011,7 +1011,7 @@
# #
# Returns: A list of @BlockStats for each virtual block devices. # Returns: A list of @BlockStats for each virtual block devices.
# #
# Since: 0.14.0 # Since: 0.14
# #
# Example: # Example:
# #
@ -1299,7 +1299,7 @@
# Returns: - nothing on success # Returns: - nothing on success
# - If @device is not a valid block device, DeviceNotFound # - If @device is not a valid block device, DeviceNotFound
# #
# Since: 0.14.0 # Since: 0.14
# #
# Example: # Example:
# #
@ -1484,7 +1484,7 @@
# Returns: - nothing on success # Returns: - nothing on success
# - If @device is not a valid block device, DeviceNotFound # - If @device is not a valid block device, DeviceNotFound
# #
# Since: 0.14.0 # Since: 0.14
# #
# Example: # Example:
# #
@ -4852,7 +4852,7 @@
# Note: If action is "stop", a STOP event will eventually follow the # Note: If action is "stop", a STOP event will eventually follow the
# BLOCK_IO_ERROR event # BLOCK_IO_ERROR event
# #
# Since: 0.13.0 # Since: 0.13
# #
# Example: # Example:
# #

6
qapi/block-export.json
View File

@ -54,7 +54,7 @@
# #
# Returns: error if the server is already running. # Returns: error if the server is already running.
# #
# Since: 1.3.0 # Since: 1.3
## ##
{ 'command': 'nbd-server-start', { 'command': 'nbd-server-start',
'data': { 'addr': 'SocketAddressLegacy', 'data': { 'addr': 'SocketAddressLegacy',
@ -155,7 +155,7 @@
# Returns: error if the server is not running, or export with the same name # Returns: error if the server is not running, or export with the same name
# already exists. # already exists.
# #
# Since: 1.3.0 # Since: 1.3
## ##
{ 'command': 'nbd-server-add', { 'command': 'nbd-server-add',
'data': 'NbdServerAddOptions', 'boxed': true, 'features': ['deprecated'] } 'data': 'NbdServerAddOptions', 'boxed': true, 'features': ['deprecated'] }
@ -211,7 +211,7 @@
# Stop QEMU's embedded NBD server, and unregister all devices previously # Stop QEMU's embedded NBD server, and unregister all devices previously
# added via @nbd-server-add. # added via @nbd-server-add.
# #
# Since: 1.3.0 # Since: 1.3
## ##
{ 'command': 'nbd-server-stop' } { 'command': 'nbd-server-stop' }

2
qapi/block.json
View File

@ -107,7 +107,7 @@
# - If @device is not a valid block device, DeviceNotFound # - If @device is not a valid block device, DeviceNotFound
# Notes: Ejecting a device with no media results in success # Notes: Ejecting a device with no media results in success
# #
# Since: 0.14.0 # Since: 0.14
# #
# Example: # Example:
# #

4
qapi/char.json
View File

@ -24,7 +24,7 @@
# Notes: @filename is encoded using the QEMU command line character device # Notes: @filename is encoded using the QEMU command line character device
# encoding. See the QEMU man page for details. # encoding. See the QEMU man page for details.
# #
# Since: 0.14.0 # Since: 0.14
## ##
{ 'struct': 'ChardevInfo', { 'struct': 'ChardevInfo',
'data': { 'label': 'str', 'data': { 'label': 'str',
@ -38,7 +38,7 @@
# #
# Returns: a list of @ChardevInfo # Returns: a list of @ChardevInfo
# #
# Since: 0.14.0 # Since: 0.14
# #
# Example: # Example:
# #

14
qapi/control.json
View File

@ -87,7 +87,7 @@
# exact format depends on the downstream however it highly # exact format depends on the downstream however it highly
# recommended that a unique name is used. # recommended that a unique name is used.
# #
# Since: 0.14.0 # Since: 0.14
## ##
{ 'struct': 'VersionInfo', { 'struct': 'VersionInfo',
'data': {'qemu': 'VersionTriple', 'package': 'str'} } 'data': {'qemu': 'VersionTriple', 'package': 'str'} }
@ -99,7 +99,7 @@
# #
# Returns: A @VersionInfo object describing the current version of QEMU. # Returns: A @VersionInfo object describing the current version of QEMU.
# #
# Since: 0.14.0 # Since: 0.14
# #
# Example: # Example:
# #
@ -126,7 +126,7 @@
# #
# @name: The command name # @name: The command name
# #
# Since: 0.14.0 # Since: 0.14
## ##
{ 'struct': 'CommandInfo', 'data': {'name': 'str'} } { 'struct': 'CommandInfo', 'data': {'name': 'str'} }
@ -137,7 +137,7 @@
# #
# Returns: A list of @CommandInfo for all supported commands # Returns: A list of @CommandInfo for all supported commands
# #
# Since: 0.14.0 # Since: 0.14
# #
# Example: # Example:
# #
@ -166,7 +166,7 @@
# #
# @name: The event name # @name: The event name
# #
# Since: 1.2.0 # Since: 1.2
## ##
{ 'struct': 'EventInfo', 'data': {'name': 'str'} } { 'struct': 'EventInfo', 'data': {'name': 'str'} }
@ -182,7 +182,7 @@
# #
# Returns: A list of @EventInfo. # Returns: A list of @EventInfo.
# #
# Since: 1.2.0 # Since: 1.2
# #
# Example: # Example:
# #
@ -212,7 +212,7 @@
# guaranteed. When using this interface, a premature EOF would not be # guaranteed. When using this interface, a premature EOF would not be
# unexpected. # unexpected.
# #
# Since: 0.14.0 # Since: 0.14
# #
# Example: # Example:
# #

22
qapi/machine-target.json
View File

@ -17,7 +17,7 @@
# @name: the name of the CPU definition the model is based on # @name: the name of the CPU definition the model is based on
# @props: a dictionary of QOM properties to be applied # @props: a dictionary of QOM properties to be applied
# #
# Since: 2.8.0 # Since: 2.8
## ##
{ 'struct': 'CpuModelInfo', { 'struct': 'CpuModelInfo',
'data': { 'name': 'str', 'data': { 'name': 'str',
@ -49,7 +49,7 @@
# version or machine-type, use @static (but keep in mind that some features may # version or machine-type, use @static (but keep in mind that some features may
# be omitted). # be omitted).
# #
# Since: 2.8.0 # Since: 2.8
## ##
{ 'enum': 'CpuModelExpansionType', { 'enum': 'CpuModelExpansionType',
'data': [ 'static', 'full' ] } 'data': [ 'static', 'full' ] }
@ -73,7 +73,7 @@
# @subset: If model A is a subset of model B, model A is guaranteed to run # @subset: If model A is a subset of model B, model A is guaranteed to run
# where model B runs. There are no guarantees about the other way. # where model B runs. There are no guarantees about the other way.
# #
# Since: 2.8.0 # Since: 2.8
## ##
{ 'enum': 'CpuModelCompareResult', { 'enum': 'CpuModelCompareResult',
'data': [ 'incompatible', 'identical', 'superset', 'subset' ] } 'data': [ 'incompatible', 'identical', 'superset', 'subset' ] }
@ -85,7 +85,7 @@
# #
# @model: the baselined CpuModelInfo. # @model: the baselined CpuModelInfo.
# #
# Since: 2.8.0 # Since: 2.8
## ##
{ 'struct': 'CpuModelBaselineInfo', { 'struct': 'CpuModelBaselineInfo',
'data': { 'model': 'CpuModelInfo' }, 'data': { 'model': 'CpuModelInfo' },
@ -107,7 +107,7 @@
# CPU models identical. If the special property name "type" is included, the # CPU models identical. If the special property name "type" is included, the
# models are by definition not identical and cannot be made identical. # models are by definition not identical and cannot be made identical.
# #
# Since: 2.8.0 # Since: 2.8
## ##
{ 'struct': 'CpuModelCompareInfo', { 'struct': 'CpuModelCompareInfo',
'data': { 'result': 'CpuModelCompareResult', 'data': { 'result': 'CpuModelCompareResult',
@ -151,7 +151,7 @@
# Note: this command isn't specific to s390x, but is only implemented # Note: this command isn't specific to s390x, but is only implemented
# on this architecture currently. # on this architecture currently.
# #
# Since: 2.8.0 # Since: 2.8
## ##
{ 'command': 'query-cpu-model-comparison', { 'command': 'query-cpu-model-comparison',
'data': { 'modela': 'CpuModelInfo', 'modelb': 'CpuModelInfo' }, 'data': { 'modela': 'CpuModelInfo', 'modelb': 'CpuModelInfo' },
@ -194,7 +194,7 @@
# Note: this command isn't specific to s390x, but is only implemented # Note: this command isn't specific to s390x, but is only implemented
# on this architecture currently. # on this architecture currently.
# #
# Since: 2.8.0 # Since: 2.8
## ##
{ 'command': 'query-cpu-model-baseline', { 'command': 'query-cpu-model-baseline',
'data': { 'modela': 'CpuModelInfo', 'data': { 'modela': 'CpuModelInfo',
@ -209,7 +209,7 @@
# #
# @model: the expanded CpuModelInfo. # @model: the expanded CpuModelInfo.
# #
# Since: 2.8.0 # Since: 2.8
## ##
{ 'struct': 'CpuModelExpansionInfo', { 'struct': 'CpuModelExpansionInfo',
'data': { 'model': 'CpuModelInfo' }, 'data': { 'model': 'CpuModelInfo' },
@ -246,7 +246,7 @@
# with a wrong type. Also returns an error if an expansion type is # with a wrong type. Also returns an error if an expansion type is
# not supported. # not supported.
# #
# Since: 2.8.0 # Since: 2.8
## ##
{ 'command': 'query-cpu-model-expansion', { 'command': 'query-cpu-model-expansion',
'data': { 'type': 'CpuModelExpansionType', 'data': { 'type': 'CpuModelExpansionType',
@ -306,7 +306,7 @@
# If @unavailable-features is not present, runnability # If @unavailable-features is not present, runnability
# information for the CPU is not available. # information for the CPU is not available.
# #
# Since: 1.2.0 # Since: 1.2
## ##
{ 'struct': 'CpuDefinitionInfo', { 'struct': 'CpuDefinitionInfo',
'data': { 'name': 'str', 'data': { 'name': 'str',
@ -325,7 +325,7 @@
# #
# Returns: a list of CpuDefInfo # Returns: a list of CpuDefInfo
# #
# Since: 1.2.0 # Since: 1.2
## ##
{ 'command': 'query-cpu-definitions', 'returns': ['CpuDefinitionInfo'], { 'command': 'query-cpu-definitions', 'returns': ['CpuDefinitionInfo'],
'if': 'defined(TARGET_PPC) || defined(TARGET_ARM) || defined(TARGET_I386) || defined(TARGET_S390X) || defined(TARGET_MIPS)' } 'if': 'defined(TARGET_PPC) || defined(TARGET_ARM) || defined(TARGET_I386) || defined(TARGET_S390X) || defined(TARGET_MIPS)' }

46
qapi/machine.json
View File

@ -71,7 +71,7 @@
# @arch: architecture of the cpu, which determines which additional fields # @arch: architecture of the cpu, which determines which additional fields
# will be listed (since 2.6) # will be listed (since 2.6)
# #
# Since: 0.14.0 # Since: 0.14
# #
# Notes: @halted is a transient state that changes frequently. By the time the # Notes: @halted is a transient state that changes frequently. By the time the
# data is sent to the client, the guest may no longer be halted. # data is sent to the client, the guest may no longer be halted.
@ -196,7 +196,7 @@
# #
# Returns: a list of @CpuInfo for each virtual CPU # Returns: a list of @CpuInfo for each virtual CPU
# #
# Since: 0.14.0 # Since: 0.14
# #
# Example: # Example:
# #
@ -319,23 +319,23 @@
# @is-default: whether the machine is default # @is-default: whether the machine is default
# #
# @cpu-max: maximum number of CPUs supported by the machine type # @cpu-max: maximum number of CPUs supported by the machine type
# (since 1.5.0) # (since 1.5)
# #
# @hotpluggable-cpus: cpu hotplug via -device is supported (since 2.7.0) # @hotpluggable-cpus: cpu hotplug via -device is supported (since 2.7)
# #
# @numa-mem-supported: true if '-numa node,mem' option is supported by # @numa-mem-supported: true if '-numa node,mem' option is supported by
# the machine type and false otherwise (since 4.1) # the machine type and false otherwise (since 4.1)
# #
# @deprecated: if true, the machine type is deprecated and may be removed # @deprecated: if true, the machine type is deprecated and may be removed
# in future versions of QEMU according to the QEMU deprecation # in future versions of QEMU according to the QEMU deprecation
# policy (since 4.1.0) # policy (since 4.1)
# #
# @default-cpu-type: default CPU model typename if none is requested via # @default-cpu-type: default CPU model typename if none is requested via
# the -cpu argument. (since 4.2) # the -cpu argument. (since 4.2)
# #
# @default-ram-id: the default ID of initial RAM memory backend (since 5.2) # @default-ram-id: the default ID of initial RAM memory backend (since 5.2)
# #
# Since: 1.2.0 # Since: 1.2
## ##
{ 'struct': 'MachineInfo', { 'struct': 'MachineInfo',
'data': { 'name': 'str', '*alias': 'str', 'data': { 'name': 'str', '*alias': 'str',
@ -351,7 +351,7 @@
# #
# Returns: a list of MachineInfo # Returns: a list of MachineInfo
# #
# Since: 1.2.0 # Since: 1.2
## ##
{ 'command': 'query-machines', 'returns': ['MachineInfo'] } { 'command': 'query-machines', 'returns': ['MachineInfo'] }
@ -386,7 +386,7 @@
# #
# @arch: the target architecture # @arch: the target architecture
# #
# Since: 1.2.0 # Since: 1.2
## ##
{ 'struct': 'TargetInfo', { 'struct': 'TargetInfo',
'data': { 'arch': 'SysEmuTarget' } } 'data': { 'arch': 'SysEmuTarget' } }
@ -398,7 +398,7 @@
# #
# Returns: TargetInfo # Returns: TargetInfo
# #
# Since: 1.2.0 # Since: 1.2
## ##
{ 'command': 'query-target', 'returns': 'TargetInfo' } { 'command': 'query-target', 'returns': 'TargetInfo' }
@ -409,7 +409,7 @@
# #
# @UUID: the UUID of the guest # @UUID: the UUID of the guest
# #
# Since: 0.14.0 # Since: 0.14
# #
# Notes: If no UUID was specified for the guest, a null UUID is returned. # Notes: If no UUID was specified for the guest, a null UUID is returned.
## ##
@ -422,7 +422,7 @@
# #
# Returns: The @UuidInfo for the guest # Returns: The @UuidInfo for the guest
# #
# Since: 0.14.0 # Since: 0.14
# #
# Example: # Example:
# #
@ -457,7 +457,7 @@
# #
# Performs a hard reset of a guest. # Performs a hard reset of a guest.
# #
# Since: 0.14.0 # Since: 0.14
# #
# Example: # Example:
# #
@ -472,7 +472,7 @@
# #
# Requests that a guest perform a powerdown operation. # Requests that a guest perform a powerdown operation.
# #
# Since: 0.14.0 # Since: 0.14
# #
# Notes: A guest may or may not respond to this command. This command # Notes: A guest may or may not respond to this command. This command
# returning does not indicate that a guest has accepted the request or # returning does not indicate that a guest has accepted the request or
@ -549,7 +549,7 @@
# #
# Returns: If successful, nothing # Returns: If successful, nothing
# #
# Since: 0.14.0 # Since: 0.14
# #
# Note: prior to 2.1, this command was only supported for x86 and s390 VMs # Note: prior to 2.1, this command was only supported for x86 and s390 VMs
# #
@ -570,7 +570,7 @@
# #
# @present: true if KVM acceleration is built into this executable # @present: true if KVM acceleration is built into this executable
# #
# Since: 0.14.0 # Since: 0.14
## ##
{ 'struct': 'KvmInfo', 'data': {'enabled': 'bool', 'present': 'bool'} } { 'struct': 'KvmInfo', 'data': {'enabled': 'bool', 'present': 'bool'} }
@ -581,7 +581,7 @@
# #
# Returns: @KvmInfo # Returns: @KvmInfo
# #
# Since: 0.14.0 # Since: 0.14
# #
# Example: # Example:
# #
@ -933,7 +933,7 @@
# #
# Returns: Nothing on success # Returns: Nothing on success
# #
# Since: 0.14.0 # Since: 0.14
# #
# Notes: Errors were not reliably returned until 1.1 # Notes: Errors were not reliably returned until 1.1
# #
@ -962,7 +962,7 @@
# #
# Returns: Nothing on success # Returns: Nothing on success
# #
# Since: 0.14.0 # Since: 0.14
# #
# Notes: Errors were not reliably returned until 1.1 # Notes: Errors were not reliably returned until 1.1
# #
@ -1185,7 +1185,7 @@
# the balloon size may not have changed. A guest can change the balloon # the balloon size may not have changed. A guest can change the balloon
# size independent of this command. # size independent of this command.
# #
# Since: 0.14.0 # Since: 0.14
# #
# Example: # Example:
# #
@ -1205,7 +1205,7 @@
# @actual: the logical size of the VM in bytes # @actual: the logical size of the VM in bytes
# Formula used: logical_vm_size = vm_ram_size - balloon_size # Formula used: logical_vm_size = vm_ram_size - balloon_size
# #
# Since: 0.14.0 # Since: 0.14
# #
## ##
{ 'struct': 'BalloonInfo', 'data': {'actual': 'int' } } { 'struct': 'BalloonInfo', 'data': {'actual': 'int' } }
@ -1220,7 +1220,7 @@
# kernel module cannot support it, KvmMissingCap # kernel module cannot support it, KvmMissingCap
# - If no balloon device is present, DeviceNotActive # - If no balloon device is present, DeviceNotActive
# #
# Since: 0.14.0 # Since: 0.14
# #
# Example: # Example:
# #
@ -1268,7 +1268,7 @@
# is omitted if target doesn't support memory hotplug # is omitted if target doesn't support memory hotplug
# (i.e. CONFIG_MEM_DEVICE not defined at build time). # (i.e. CONFIG_MEM_DEVICE not defined at build time).
# #
# Since: 2.11.0 # Since: 2.11
## ##
{ 'struct': 'MemoryInfo', { 'struct': 'MemoryInfo',
'data' : { 'base-memory': 'size', '*plugged-memory': 'size' } } 'data' : { 'base-memory': 'size', '*plugged-memory': 'size' } }
@ -1284,7 +1284,7 @@
# -> { "execute": "query-memory-size-summary" } # -> { "execute": "query-memory-size-summary" }
# <- { "return": { "base-memory": 4294967296, "plugged-memory": 0 } } # <- { "return": { "base-memory": 4294967296, "plugged-memory": 0 } }
# #
# Since: 2.11.0 # Since: 2.11
## ##
{ 'command': 'query-memory-size-summary', 'returns': 'MemoryInfo' } { 'command': 'query-memory-size-summary', 'returns': 'MemoryInfo' }

16
qapi/migration.json
View File

@ -46,7 +46,7 @@
# @pages-per-second: the number of memory pages transferred per second # @pages-per-second: the number of memory pages transferred per second
# (Since 4.0) # (Since 4.0)
# #
# Since: 0.14.0 # Since: 0.14
## ##
{ 'struct': 'MigrationStats', { 'struct': 'MigrationStats',
'data': {'transferred': 'int', 'remaining': 'int', 'total': 'int' , 'data': {'transferred': 'int', 'remaining': 'int', 'total': 'int' ,
@ -224,7 +224,7 @@
# only returned if VFIO device is present, migration is supported by all # only returned if VFIO device is present, migration is supported by all
# VFIO devices and status is 'active' or 'completed' (since 5.2) # VFIO devices and status is 'active' or 'completed' (since 5.2)
# #
# Since: 0.14.0 # Since: 0.14
## ##
{ 'struct': 'MigrationInfo', { 'struct': 'MigrationInfo',
'data': {'*status': 'MigrationStatus', '*ram': 'MigrationStats', 'data': {'*status': 'MigrationStatus', '*ram': 'MigrationStats',
@ -252,7 +252,7 @@
# #
# Returns: @MigrationInfo # Returns: @MigrationInfo
# #
# Since: 0.14.0 # Since: 0.14
# #
# Example: # Example:
# #
@ -1143,7 +1143,7 @@
# @tls-port: spice tcp port for tls-secured channels # @tls-port: spice tcp port for tls-secured channels
# @cert-subject: server certificate subject # @cert-subject: server certificate subject
# #
# Since: 0.14.0 # Since: 0.14
# #
# Example: # Example:
# #
@ -1343,7 +1343,7 @@
# #
# Notes: This command succeeds even if there is no migration process running. # Notes: This command succeeds even if there is no migration process running.
# #
# Since: 0.14.0 # Since: 0.14
# #
# Example: # Example:
# #
@ -1383,7 +1383,7 @@
# #
# Returns: nothing on success # Returns: nothing on success
# #
# Since: 0.14.0 # Since: 0.14
# #
# Example: # Example:
# #
@ -1407,7 +1407,7 @@
# #
# Returns: nothing on success # Returns: nothing on success
# #
# Since: 0.14.0 # Since: 0.14
# #
# Example: # Example:
# #
@ -1486,7 +1486,7 @@
# #
# Returns: nothing on success # Returns: nothing on success
# #
# Since: 0.14.0 # Since: 0.14
# #
# Notes: # Notes:
# #

2
qapi/misc-target.json
View File

@ -12,7 +12,7 @@
# #
# Note: This event is rate-limited. # Note: This event is rate-limited.
# #
# Since: 0.13.0 # Since: 0.13
# #
# Example: # Example:
# #

30
qapi/misc.json
View File

@ -27,7 +27,7 @@
# #
# Returns: nothing on success. # Returns: nothing on success.
# #
# Since: 0.14.0 # Since: 0.14
# #
# Example: # Example:
# #
@ -47,7 +47,7 @@
# #
# @name: The name of the guest # @name: The name of the guest
# #
# Since: 0.14.0 # Since: 0.14
## ##
{ 'struct': 'NameInfo', 'data': {'*name': 'str'} } { 'struct': 'NameInfo', 'data': {'*name': 'str'} }
@ -58,7 +58,7 @@
# #
# Returns: @NameInfo of the guest # Returns: @NameInfo of the guest
# #
# Since: 0.14.0 # Since: 0.14
# #
# Example: # Example:
# #
@ -132,7 +132,7 @@
# #
# Stop all guest VCPU execution. # Stop all guest VCPU execution.
# #
# Since: 0.14.0 # Since: 0.14
# #
# Notes: This function will succeed even if the guest is already in the stopped # Notes: This function will succeed even if the guest is already in the stopped
# state. In "inmigrate" state, it will ensure that the guest # state. In "inmigrate" state, it will ensure that the guest
@ -152,7 +152,7 @@
# #
# Resume guest VCPU execution. # Resume guest VCPU execution.
# #
# Since: 0.14.0 # Since: 0.14
# #
# Returns: If successful, nothing # Returns: If successful, nothing
# #
@ -210,7 +210,7 @@
# #
# Returns: the output of the command as a string # Returns: the output of the command as a string
# #
# Since: 0.14.0 # Since: 0.14
# #
# Notes: This command only exists as a stop-gap. Its use is highly # Notes: This command only exists as a stop-gap. Its use is highly
# discouraged. The semantics of this command are not # discouraged. The semantics of this command are not
@ -264,7 +264,7 @@
# Returns: - Nothing on success. # Returns: - Nothing on success.
# - If @device is not a valid block device, DeviceNotFound # - If @device is not a valid block device, DeviceNotFound
# #
# Since: 0.14.0 # Since: 0.14
# #
# Example: # Example:
# #
@ -296,7 +296,7 @@
# #
# Returns: Nothing on success # Returns: Nothing on success
# #
# Since: 0.14.0 # Since: 0.14
# #
# Notes: If @fdname already exists, the file descriptor assigned to # Notes: If @fdname already exists, the file descriptor assigned to
# it will be closed and replaced by the received file # it will be closed and replaced by the received file
@ -322,7 +322,7 @@
# #
# Returns: Nothing on success # Returns: Nothing on success
# #
# Since: 0.14.0 # Since: 0.14
# #
# Example: # Example:
# #
@ -342,7 +342,7 @@
# @fd: The file descriptor that was received via SCM rights and # @fd: The file descriptor that was received via SCM rights and
# added to the fd set. # added to the fd set.
# #
# Since: 1.2.0 # Since: 1.2
## ##
{ 'struct': 'AddfdInfo', 'data': {'fdset-id': 'int', 'fd': 'int'} } { 'struct': 'AddfdInfo', 'data': {'fdset-id': 'int', 'fd': 'int'} }
@ -363,7 +363,7 @@
# #
# If @fdset-id is not specified, a new fd set will be created. # If @fdset-id is not specified, a new fd set will be created.
# #
# Since: 1.2.0 # Since: 1.2
# #
# Example: # Example:
# #
@ -388,7 +388,7 @@
# Returns: - Nothing on success # Returns: - Nothing on success
# - If @fdset-id or @fd is not found, FdNotFound # - If @fdset-id or @fd is not found, FdNotFound
# #
# Since: 1.2.0 # Since: 1.2
# #
# Notes: The list of fd sets is shared by all monitor connections. # Notes: The list of fd sets is shared by all monitor connections.
# #
@ -412,7 +412,7 @@
# #
# @opaque: A free-form string that can be used to describe the fd. # @opaque: A free-form string that can be used to describe the fd.
# #
# Since: 1.2.0 # Since: 1.2
## ##
{ 'struct': 'FdsetFdInfo', { 'struct': 'FdsetFdInfo',
'data': {'fd': 'int', '*opaque': 'str'} } 'data': {'fd': 'int', '*opaque': 'str'} }
@ -426,7 +426,7 @@
# #
# @fds: A list of file descriptors that belong to this fd set. # @fds: A list of file descriptors that belong to this fd set.
# #
# Since: 1.2.0 # Since: 1.2
## ##
{ 'struct': 'FdsetInfo', { 'struct': 'FdsetInfo',
'data': {'fdset-id': 'int', 'fds': ['FdsetFdInfo']} } 'data': {'fdset-id': 'int', 'fds': ['FdsetFdInfo']} }
@ -438,7 +438,7 @@
# #
# Returns: A list of @FdsetInfo # Returns: A list of @FdsetInfo
# #
# Since: 1.2.0 # Since: 1.2
# #
# Note: The list of fd sets is shared by all monitor connections. # Note: The list of fd sets is shared by all monitor connections.
# #

6
qapi/net.json
View File

@ -20,7 +20,7 @@
# Returns: Nothing on success # Returns: Nothing on success
# If @name is not a valid network device, DeviceNotFound # If @name is not a valid network device, DeviceNotFound
# #
# Since: 0.14.0 # Since: 0.14
# #
# Notes: Not all network adapters support setting link status. This command # Notes: Not all network adapters support setting link status. This command
# will succeed even if the network adapter does not support link status # will succeed even if the network adapter does not support link status
@ -42,7 +42,7 @@
# #
# Additional arguments depend on the type. # Additional arguments depend on the type.
# #
# Since: 0.14.0 # Since: 0.14
# #
# Returns: Nothing on success # Returns: Nothing on success
# If @type is not a valid network backend, DeviceNotFound # If @type is not a valid network backend, DeviceNotFound
@ -67,7 +67,7 @@
# Returns: Nothing on success # Returns: Nothing on success
# If @id is not a valid network backend, DeviceNotFound # If @id is not a valid network backend, DeviceNotFound
# #
# Since: 0.14.0 # Since: 0.14
# #
# Example: # Example:
# #

12
qapi/pci.json
View File

@ -18,7 +18,7 @@
# #
# @limit: the ending address (guest physical) # @limit: the ending address (guest physical)
# #
# Since: 0.14.0 # Since: 0.14
## ##
{ 'struct': 'PciMemoryRange', 'data': {'base': 'int', 'limit': 'int'} } { 'struct': 'PciMemoryRange', 'data': {'base': 'int', 'limit': 'int'} }
@ -38,7 +38,7 @@
# #
# @mem_type_64: if @type is 'memory', true if the BAR is 64-bit # @mem_type_64: if @type is 'memory', true if the BAR is 64-bit
# #
# Since: 0.14.0 # Since: 0.14
## ##
{ 'struct': 'PciMemoryRegion', { 'struct': 'PciMemoryRegion',
'data': {'bar': 'int', 'type': 'str', 'address': 'int', 'size': 'int', 'data': {'bar': 'int', 'type': 'str', 'address': 'int', 'size': 'int',
@ -82,7 +82,7 @@
# #
# @devices: a list of @PciDeviceInfo for each device on this bridge # @devices: a list of @PciDeviceInfo for each device on this bridge
# #
# Since: 0.14.0 # Since: 0.14
## ##
{ 'struct': 'PciBridgeInfo', { 'struct': 'PciBridgeInfo',
'data': {'bus': 'PciBusInfo', '*devices': ['PciDeviceInfo']} } 'data': {'bus': 'PciBusInfo', '*devices': ['PciDeviceInfo']} }
@ -148,7 +148,7 @@
# Notes: the contents of @class_info.desc are not stable and should only be # Notes: the contents of @class_info.desc are not stable and should only be
# treated as informational. # treated as informational.
# #
# Since: 0.14.0 # Since: 0.14
## ##
{ 'struct': 'PciDeviceInfo', { 'struct': 'PciDeviceInfo',
'data': {'bus': 'int', 'slot': 'int', 'function': 'int', 'data': {'bus': 'int', 'slot': 'int', 'function': 'int',
@ -165,7 +165,7 @@
# #
# @devices: a list of devices on this bus # @devices: a list of devices on this bus
# #
# Since: 0.14.0 # Since: 0.14
## ##
{ 'struct': 'PciInfo', 'data': {'bus': 'int', 'devices': ['PciDeviceInfo']} } { 'struct': 'PciInfo', 'data': {'bus': 'int', 'devices': ['PciDeviceInfo']} }
@ -179,7 +179,7 @@
# all PCI devices attached to it. Each device is represented by a # all PCI devices attached to it. Each device is represented by a
# json-object. # json-object.
# #
# Since: 0.14.0 # Since: 0.14
# #
# Example: # Example:
# #

2
qapi/qdev.json
View File

@ -86,7 +86,7 @@
# DEVICE_DELETED event. Guest reset will automatically complete removal # DEVICE_DELETED event. Guest reset will automatically complete removal
# for all devices. # for all devices.
# #
# Since: 0.14.0 # Since: 0.14
# #
# Example: # Example:
# #

16
qapi/run-state.json
View File

@ -107,7 +107,7 @@
# #
# @status: the virtual machine @RunState # @status: the virtual machine @RunState
# #
# Since: 0.14.0 # Since: 0.14
# #
# Notes: @singlestep is enabled through the GDB stub # Notes: @singlestep is enabled through the GDB stub
## ##
@ -121,7 +121,7 @@
# #
# Returns: @StatusInfo reflecting all VCPUs # Returns: @StatusInfo reflecting all VCPUs
# #
# Since: 0.14.0 # Since: 0.14
# #
# Example: # Example:
# #
@ -149,7 +149,7 @@
# Note: If the command-line option "-no-shutdown" has been specified, qemu will # Note: If the command-line option "-no-shutdown" has been specified, qemu will
# not exit, and a STOP event will eventually follow the SHUTDOWN event # not exit, and a STOP event will eventually follow the SHUTDOWN event
# #
# Since: 0.12.0 # Since: 0.12
# #
# Example: # Example:
# #
@ -165,7 +165,7 @@
# Emitted when the virtual machine is powered down through the power control # Emitted when the virtual machine is powered down through the power control
# system, such as via ACPI. # system, such as via ACPI.
# #
# Since: 0.12.0 # Since: 0.12
# #
# Example: # Example:
# #
@ -187,7 +187,7 @@
# #
# @reason: The @ShutdownCause of the RESET. (since 4.0) # @reason: The @ShutdownCause of the RESET. (since 4.0)
# #
# Since: 0.12.0 # Since: 0.12
# #
# Example: # Example:
# #
@ -202,7 +202,7 @@
# #
# Emitted when the virtual machine is stopped # Emitted when the virtual machine is stopped
# #
# Since: 0.12.0 # Since: 0.12
# #
# Example: # Example:
# #
@ -217,7 +217,7 @@
# #
# Emitted when the virtual machine resumes execution # Emitted when the virtual machine resumes execution
# #
# Since: 0.12.0 # Since: 0.12
# #
# Example: # Example:
# #
@ -288,7 +288,7 @@
# #
# Note: This event is rate-limited. # Note: This event is rate-limited.
# #
# Since: 0.13.0 # Since: 0.13
# #
# Example: # Example:
# #

40
qapi/ui.json
View File

@ -27,7 +27,7 @@
# Returns: - Nothing on success # Returns: - Nothing on success
# - If Spice is not enabled, DeviceNotFound # - If Spice is not enabled, DeviceNotFound
# #
# Since: 0.14.0 # Since: 0.14
# #
# Example: # Example:
# #
@ -56,7 +56,7 @@
# Returns: - Nothing on success # Returns: - Nothing on success
# - If @protocol is 'spice' and Spice is not active, DeviceNotFound # - If @protocol is 'spice' and Spice is not active, DeviceNotFound
# #
# Since: 0.14.0 # Since: 0.14
# #
# Notes: Time is relative to the server and currently there is no way to # Notes: Time is relative to the server and currently there is no way to
# coordinate server time with client time. It is not recommended to # coordinate server time with client time. It is not recommended to
@ -88,7 +88,7 @@
# #
# Returns: Nothing on success # Returns: Nothing on success
# #
# Since: 0.14.0 # Since: 0.14
# #
# Example: # Example:
# #
@ -156,7 +156,7 @@
# #
# @tls: true if the channel is encrypted, false otherwise. # @tls: true if the channel is encrypted, false otherwise.
# #
# Since: 0.14.0 # Since: 0.14
## ##
{ 'struct': 'SpiceChannel', { 'struct': 'SpiceChannel',
'base': 'SpiceBasicInfo', 'base': 'SpiceBasicInfo',
@ -215,7 +215,7 @@
# #
# @channels: a list of @SpiceChannel for each active spice channel # @channels: a list of @SpiceChannel for each active spice channel
# #
# Since: 0.14.0 # Since: 0.14
## ##
{ 'struct': 'SpiceInfo', { 'struct': 'SpiceInfo',
'data': {'enabled': 'bool', 'migrated': 'bool', '*host': 'str', '*port': 'int', 'data': {'enabled': 'bool', 'migrated': 'bool', '*host': 'str', '*port': 'int',
@ -230,7 +230,7 @@
# #
# Returns: @SpiceInfo # Returns: @SpiceInfo
# #
# Since: 0.14.0 # Since: 0.14
# #
# Example: # Example:
# #
@ -278,7 +278,7 @@
# #
# @client: client information # @client: client information
# #
# Since: 0.14.0 # Since: 0.14
# #
# Example: # Example:
# #
@ -305,7 +305,7 @@
# #
# @client: client information # @client: client information
# #
# Since: 0.14.0 # Since: 0.14
# #
# Example: # Example:
# #
@ -333,7 +333,7 @@
# #
# @client: client information # @client: client information
# #
# Since: 0.14.0 # Since: 0.14
# #
# Example: # Example:
# #
@ -420,7 +420,7 @@
# @sasl_username: If SASL authentication is in use, the SASL username # @sasl_username: If SASL authentication is in use, the SASL username
# used for authentication. # used for authentication.
# #
# Since: 0.14.0 # Since: 0.14
## ##
{ 'struct': 'VncClientInfo', { 'struct': 'VncClientInfo',
'base': 'VncBasicInfo', 'base': 'VncBasicInfo',
@ -462,7 +462,7 @@
# #
# @clients: a list of @VncClientInfo of all currently connected clients # @clients: a list of @VncClientInfo of all currently connected clients
# #
# Since: 0.14.0 # Since: 0.14
## ##
{ 'struct': 'VncInfo', { 'struct': 'VncInfo',
'data': {'enabled': 'bool', '*host': 'str', 'data': {'enabled': 'bool', '*host': 'str',
@ -555,7 +555,7 @@
# #
# Returns: @VncInfo # Returns: @VncInfo
# #
# Since: 0.14.0 # Since: 0.14
# #
# Example: # Example:
# #
@ -619,7 +619,7 @@
# Note: This event is emitted before any authentication takes place, thus # Note: This event is emitted before any authentication takes place, thus
# the authentication ID is not provided # the authentication ID is not provided
# #
# Since: 0.13.0 # Since: 0.13
# #
# Example: # Example:
# #
@ -647,7 +647,7 @@
# #
# @client: client information # @client: client information
# #
# Since: 0.13.0 # Since: 0.13
# #
# Example: # Example:
# #
@ -674,7 +674,7 @@
# #
# @client: client information # @client: client information
# #
# Since: 0.13.0 # Since: 0.13
# #
# Example: # Example:
# #
@ -709,7 +709,7 @@
# #
# @absolute: true if this device supports absolute coordinates as input # @absolute: true if this device supports absolute coordinates as input
# #
# Since: 0.14.0 # Since: 0.14
## ##
{ 'struct': 'MouseInfo', { 'struct': 'MouseInfo',
'data': {'name': 'str', 'index': 'int', 'current': 'bool', 'data': {'name': 'str', 'index': 'int', 'current': 'bool',
@ -722,7 +722,7 @@
# #
# Returns: a list of @MouseInfo for each device # Returns: a list of @MouseInfo for each device
# #
# Since: 0.14.0 # Since: 0.14
# #
# Example: # Example:
# #
@ -792,7 +792,7 @@
# 'sysrq' will be transparently changed to 'print', so they # 'sysrq' will be transparently changed to 'print', so they
# are effectively synonyms. # are effectively synonyms.
# #
# Since: 1.3.0 # Since: 1.3
# #
## ##
{ 'enum': 'QKeyCode', { 'enum': 'QKeyCode',
@ -824,7 +824,7 @@
# #
# Represents a keyboard key. # Represents a keyboard key.
# #
# Since: 1.3.0 # Since: 1.3
## ##
{ 'union': 'KeyValue', { 'union': 'KeyValue',
'data': { 'data': {
@ -847,7 +847,7 @@
# Returns: - Nothing on success # Returns: - Nothing on success
# - If key is unknown or redundant, InvalidParameter # - If key is unknown or redundant, InvalidParameter
# #
# Since: 1.3.0 # Since: 1.3
# #
# Example: # Example:
# #