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

#

# Since: 1.2

##

{ 'enum': 'ErrorClass',

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

            'DeviceNotActive', 'DeviceNotFound', 'KVMMissingCap' ] }

##

# LostTickPolicy:

#

# Policy for handling lost ticks in timer devices.

#

# @discard: throw away the missed tick(s) and continue with future injection

#           normally.  Guest time may be delayed, unless the OS has explicit

#           handling of lost ticks

#

# @delay: continue to deliver ticks at the normal rate.  Guest time will be

#         delayed due to the late tick

#

# @merge: merge the missed tick(s) into one tick and inject.  Guest time

#         may be delayed, depending on how the OS reacts to the merging

#         of ticks

#

# @slew: deliver ticks at a higher rate to catch up with the missed tick. The

#        guest time should not be delayed once catchup is complete.

#

# Since: 2.0

##

{ 'enum': 'LostTickPolicy',

  'data': ['discard', 'delay', 'merge', 'slew' ] }

##

# BiosAtaTranslation:

#

# Policy that BIOS should use to interpret cylinder/head/sector

# addresses.  Note that Bochs BIOS and SeaBIOS will not actually

# translate logical CHS to physical; instead, they will use logical

# block addressing.

#

# @auto: If cylinder/heads/sizes are passed, choose between none and LBA

#        depending on the size of the disk.  If they are not passed,

#        choose none if QEMU can guess that the disk had 16 or fewer

#        heads, large if QEMU can guess that the disk had 131072 or

#        fewer tracks across all heads (i.e. cylinders*heads<131072),

#        otherwise LBA.

#

# @none: The physical disk geometry is equal to the logical geometry.

#

# @lba: Assume 63 sectors per track and one of 16, 32, 64, 128 or 255

#       heads (if fewer than 255 are enough to cover the whole disk

#       with 1024 cylinders/head).  The number of cylinders/head is

#       then computed based on the number of sectors and heads.

#

# @large: The number of cylinders per head is scaled down to 1024

#         by correspondingly scaling up the number of heads.

#

# @rechs: Same as @large, but first convert a 16-head geometry to

#         15-head, by proportionally scaling up the number of

#         cylinders/head.

#

# Since: 2.0

##

{ 'enum': 'BiosAtaTranslation',

  'data': ['auto', 'none', 'lba', 'large', 'rechs']}

# @add_client

#

# Allow client connections for VNC, Spice and socket based

# character devices to be passed in to QEMU via SCM_RIGHTS.

#

# @protocol: protocol name. Valid names are "vnc", "spice" or the

#            name of a character device (eg. from -chardev id=XXXX)

#

# @fdname: file descriptor name previously passed via 'getfd' command

#

# @skipauth: #optional whether to skip authentication. Only applies

#            to "vnc" and "spice" protocols

#

# @tls: #optional whether to perform TLS. Only applies to the "spice"

#       protocol

#

# Returns: nothing on success.

#

# Since: 0.14.0

##

{ 'command': 'add_client',

  'data': { 'protocol': 'str', 'fdname': 'str', '*skipauth': 'bool',

            '*tls': 'bool' } }

##

# @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 enumeration 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.  Note

# that this state does not tell whether the machine will start at the

# end of the migration.  This depends on the command-line -S option and

# any invocation of 'stop' or 'cont' that has happened since QEMU was

# started.

#

# @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

#

# @guest-panicked: guest has been panicked as a result of guest OS panic

##

{ 'enum': 'RunState',

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

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

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

            'guest-panicked' ] }

##

# @SnapshotInfo

#

# @id: unique snapshot id

#

# @name: user chosen name

#

# @vm-state-size: size of the VM state

#

# @date-sec: UTC date of the snapshot in seconds

#

# @date-nsec: fractional part in nano seconds to be used with date-sec

#

# @vm-clock-sec: VM clock relative to boot in seconds

#

# @vm-clock-nsec: fractional part in nano seconds to be used with vm-clock-sec

#

# Since: 1.3

#

##

{ 'type': 'SnapshotInfo',

  'data': { 'id': 'str', 'name': 'str', 'vm-state-size': 'int',

            'date-sec': 'int', 'date-nsec': 'int',

            'vm-clock-sec': 'int', 'vm-clock-nsec': 'int' } }

##

# @ImageInfoSpecificQCow2: