Archipelago » qemu

# -*- Mode: Python -*-

#

# QAPI Schema

##

# @ErrorClass

#

# QEMU error classes

#

# @GenericError: this is used for errors that don't require a specific error

#                class. This should be the default case for most errors

#

# @CommandNotFound: the requested command has not been found

#

# @DeviceEncrypted: the requested operation can't be fulfilled because the

#                   selected device is encrypted

#

# @DeviceNotActive: a device has failed to be become active

#

# @DeviceNotFound: the requested device has not been found

#

# @KVMMissingCap: the requested operation can't be fulfilled because a

#                 required KVM capability is missing

#

# @MigrationExpected: the requested operation can't be fulfilled because a

#                     migration process is expected

#

# Since: 1.2

##

{ 'enum': 'ErrorClass',

  'data': [ 'GenericError', 'CommandNotFound', 'DeviceEncrypted',

            'DeviceNotActive', 'DeviceNotFound', 'KVMMissingCap',

            'MigrationExpected' ] }

##

# @NameInfo:

#

# Guest name information.

#

# @name: #optional The name of the guest

#

# Since 0.14.0

##

{ 'type': 'NameInfo', 'data': {'*name': 'str'} }

##

# @query-name:

#

# Return the name information of a guest.

#

# Returns: @NameInfo of the guest

#

# Since 0.14.0

##

{ 'command': 'query-name', 'returns': 'NameInfo' }

##

# @VersionInfo:

#

# A description of QEMU's version.

#

# @qemu.major:  The major version of QEMU

#

# @qemu.minor:  The minor version of QEMU

#

# @qemu.micro:  The micro version of QEMU.  By current convention, a micro

#               version of 50 signifies a development branch.  A micro version

#               greater than or equal to 90 signifies a release candidate for

#               the next minor version.  A micro version of less than 50

#               signifies a stable release.

#

# @package:     QEMU will always set this field to an empty string.  Downstream

#               versions of QEMU should set this to a non-empty string.  The

#               exact format depends on the downstream however it highly

#               recommended that a unique name is used.

#

# Since: 0.14.0

##

{ 'type': 'VersionInfo',

  'data': {'qemu': {'major': 'int', 'minor': 'int', 'micro': 'int'},

           'package': 'str'} }

##

# @query-version:

#

# Returns the current version of QEMU.

#

# Returns:  A @VersionInfo object describing the current version of QEMU.

#

# Since: 0.14.0

##

{ 'command': 'query-version', 'returns': 'VersionInfo' }

##

# @KvmInfo:

#

# Information about support for KVM acceleration

#

# @enabled: true if KVM acceleration is active

#

# @present: true if KVM acceleration is built into this executable

#

# Since: 0.14.0

##

{ 'type': 'KvmInfo', 'data': {'enabled': 'bool', 'present': 'bool'} }

##

# @query-kvm:

#

# Returns information about KVM acceleration

#

# Returns: @KvmInfo

#

# Since: 0.14.0

##

{ 'command': 'query-kvm', 'returns': 'KvmInfo' }

##

# @RunState

#

# An enumation of VM run states.

#

# @debug: QEMU is running on a debugger

#

# @finish-migrate: guest is paused to finish the migration process

#

# @inmigrate: guest is paused waiting for an incoming migration

#

# @internal-error: An internal error that prevents further guest execution

# has occurred

#

# @io-error: the last IOP has failed and the device is configured to pause

# on I/O errors

#

# @paused: guest has been paused via the 'stop' command

#

# @postmigrate: guest is paused following a successful 'migrate'

#

# @prelaunch: QEMU was started with -S and guest has not started

#

# @restore-vm: guest is paused to restore VM state

#

# @running: guest is actively running

#

# @save-vm: guest is paused to save the VM state

#

# @shutdown: guest is shut down (and -no-shutdown is in use)

#

# @suspended: guest is suspended (ACPI S3)

#

# @watchdog: the watchdog action is configured to pause and has been triggered

##

{ 'enum': 'RunState',

  'data': [ 'debug', 'inmigrate', 'internal-error', 'io-error', 'paused',

            'postmigrate', 'prelaunch', 'finish-migrate', 'restore-vm',

            'running', 'save-vm', 'shutdown', 'suspended', 'watchdog' ] }

##

# @StatusInfo:

#

# Information about VCPU run state

#

# @running: true if all VCPUs are runnable, false if not runnable

#

# @singlestep: true if VCPUs are in single-step mode

#

# @status: the virtual machine @RunState

#

# Since:  0.14.0

#

# Notes: @singlestep is enabled through the GDB stub

##

{ 'type': 'StatusInfo',

  'data': {'running': 'bool', 'singlestep': 'bool', 'status': 'RunState'} }

##

# @query-status:

#

# Query the run status of all VCPUs

#

# Returns: @StatusInfo reflecting all VCPUs

#

# Since:  0.14.0

##

{ 'command': 'query-status', 'returns': 'StatusInfo' }

##

# @UuidInfo:

#

# Guest UUID information.

#

# @UUID: the UUID of the guest

#

# Since: 0.14.0

#

# Notes: If no UUID was specified for the guest, a null UUID is returned.

##

{ 'type': 'UuidInfo', 'data': {'UUID': 'str'} }

##

# @query-uuid:

#

# Query the guest UUID information.

#

# Returns: The @UuidInfo for the guest

#

# Since 0.14.0

##

{ 'command': 'query-uuid', 'returns': 'UuidInfo' }

##

# @ChardevInfo:

#

# Information about a character device.

#

# @label: the label of the character device

#

# @filename: the filename of the character device

#

# Notes: @filename is encoded using the QEMU command line character device

#        encoding.  See the QEMU man page for details.

#

# Since: 0.14.0

##

{ 'type': 'ChardevInfo', 'data': {'label': 'str', 'filename': 'str'} }

##

# @query-chardev:

#

# Returns information about current character devices.

#

# Returns: a list of @ChardevInfo

#

# Since: 0.14.0

##

{ 'command': 'query-chardev', 'returns': ['ChardevInfo'] }

##

# @CommandInfo:

#

# Information about a QMP command

#

# @name: The command name

#

# Since: 0.14.0

##

{ 'type': 'CommandInfo', 'data': {'name': 'str'} }

##

# @query-commands:

#

# Return a list of supported QMP commands by this server

#

# Returns: A list of @CommandInfo for all supported commands

#

# Since: 0.14.0

##

{ 'command': 'query-commands', 'returns': ['CommandInfo'] }

##

# @EventInfo:

#

# Information about a QMP event

#

# @name: The event name

#

# Since: 1.2.0

##

{ 'type': 'EventInfo', 'data': {'name': 'str'} }

##

# @query-events:

#

# Return a list of supported QMP events by this server

#

# Returns: A list of @EventInfo for all supported events

#

# Since: 1.2.0

##

{ 'command': 'query-events', 'returns': ['EventInfo'] }

##

# @MigrationStats

#

# Detailed migration status.

#

# @transferred: amount of bytes already transferred to the target VM

#

# @remaining: amount of bytes remaining to be transferred to the target VM

#

# @total: total amount of bytes involved in the migration process

#

# @total_time: tota0l amount of ms since migration started.  If

#        migration has ended, it returns the total migration

#        time. (since 1.2)

#

# Since: 0.14.0.

##

{ 'type': 'MigrationStats',

  'data': {'transferred': 'int', 'remaining': 'int', 'total': 'int' ,

           'total_time': 'int' } }

##

# @MigrationInfo

#

# Information about current migration process.

#

# @status: #optional string describing the current migration status.

#          As of 0.14.0 this can be 'active', 'completed', 'failed' or

#          'cancelled'. If this field is not returned, no migration process

#          has been initiated

#

# @ram: #optional @MigrationStats containing detailed migration

#       status, only returned if status is 'active' or

#       'completed'. 'comppleted' (since 1.2)

#

# @disk: #optional @MigrationStats containing detailed disk migration

#        status, only returned if status is 'active' and it is a block

#        migration

#

# Since: 0.14.0

##

{ 'type': 'MigrationInfo',

  'data': {'*status': 'str', '*ram': 'MigrationStats',

           '*disk': 'MigrationStats'} }

##

# @query-migrate

#

# Returns information about current migration process.

#

# Returns: @MigrationInfo

#

# Since: 0.14.0

##

{ 'command': 'query-migrate', 'returns': 'MigrationInfo' }

##

# @MouseInfo:

#

# Information about a mouse device.

#

# @name: the name of the mouse device

#

# @index: the index of the mouse device

#

# @current: true if this device is currently receiving mouse events

#

# @absolute: true if this device supports absolute coordinates as input

#

# Since: 0.14.0

##