qapi/common.json

   1 # -*- Mode: Python -*-
   2
   3 ##
   4 # = QAPI common definitions
   5 ##
   6
   7 ##
   8 # @QapiErrorClass:
   9 #
  10 # QEMU error classes
  11 #
  12 # @GenericError: this is used for errors that don't require a specific error
  13 #                class. This should be the default case for most errors
  14 #
  15 # @CommandNotFound: the requested command has not been found
  16 #
  17 # @DeviceEncrypted: the requested operation can't be fulfilled because the
  18 #                   selected device is encrypted
  19 #
  20 # @DeviceNotActive: a device has failed to be become active
  21 #
  22 # @DeviceNotFound: the requested device has not been found
  23 #
  24 # @KVMMissingCap: the requested operation can't be fulfilled because a
  25 #                 required KVM capability is missing
  26 #
  27 # Since: 1.2
  28 ##
  29 { 'enum': 'QapiErrorClass',
  30   # Keep this in sync with ErrorClass in error.h
  31   'data': [ 'GenericError', 'CommandNotFound', 'DeviceEncrypted',
  32             'DeviceNotActive', 'DeviceNotFound', 'KVMMissingCap' ] }
  33
  34 ##
  35 # @VersionTriple:
  36 #
  37 # A three-part version number.
  38 #
  39 # @major:  The major version number.
  40 #
  41 # @minor:  The minor version number.
  42 #
  43 # @micro:  The micro version number.
  44 #
  45 # Since: 2.4
  46 ##
  47 { 'struct': 'VersionTriple',
  48   'data': {'major': 'int', 'minor': 'int', 'micro': 'int'} }
  49
  50
  51 ##
  52 # @VersionInfo:
  53 #
  54 # A description of QEMU's version.
  55 #
  56 # @qemu:        The version of QEMU.  By current convention, a micro
  57 #               version of 50 signifies a development branch.  A micro version
  58 #               greater than or equal to 90 signifies a release candidate for
  59 #               the next minor version.  A micro version of less than 50
  60 #               signifies a stable release.
  61 #
  62 # @package:     QEMU will always set this field to an empty string.  Downstream
  63 #               versions of QEMU should set this to a non-empty string.  The
  64 #               exact format depends on the downstream however it highly
  65 #               recommended that a unique name is used.
  66 #
  67 # Since: 0.14.0
  68 ##
  69 { 'struct': 'VersionInfo',
  70   'data': {'qemu': 'VersionTriple', 'package': 'str'} }
  71
  72 ##
  73 # @query-version:
  74 #
  75 # Returns the current version of QEMU.
  76 #
  77 # Returns:  A @VersionInfo object describing the current version of QEMU.
  78 #
  79 # Since: 0.14.0
  80 #
  81 # Example:
  82 #
  83 # -> { "execute": "query-version" }
  84 # <- {
  85 #       "return":{
  86 #          "qemu":{
  87 #             "major":0,
  88 #             "minor":11,
  89 #             "micro":5
  90 #          },
  91 #          "package":""
  92 #       }
  93 #    }
  94 #
  95 ##
  96 { 'command': 'query-version', 'returns': 'VersionInfo' }
  97
  98 ##
  99 # @CommandInfo:
 100 #
 101 # Information about a QMP command
 102 #
 103 # @name: The command name
 104 #
 105 # Since: 0.14.0
 106 ##
 107 { 'struct': 'CommandInfo', 'data': {'name': 'str'} }
 108
 109 ##
 110 # @query-commands:
 111 #
 112 # Return a list of supported QMP commands by this server
 113 #
 114 # Returns: A list of @CommandInfo for all supported commands
 115 #
 116 # Since: 0.14.0
 117 ##
 118 { 'command': 'query-commands', 'returns': ['CommandInfo'] }
 119
 120 ##
 121 # @OnOffAuto:
 122 #
 123 # An enumeration of three options: on, off, and auto
 124 #
 125 # @auto: QEMU selects the value between on and off
 126 #
 127 # @on: Enabled
 128 #
 129 # @off: Disabled
 130 #
 131 # Since: 2.2
 132 ##
 133 { 'enum': 'OnOffAuto',
 134   'data': [ 'auto', 'on', 'off' ] }
 135
 136 ##
 137 # @OnOffSplit:
 138 #
 139 # An enumeration of three values: on, off, and split
 140 #
 141 # @on: Enabled
 142 #
 143 # @off: Disabled
 144 #
 145 # @split: Mixed
 146 #
 147 # Since: 2.6
 148 ##
 149 { 'enum': 'OnOffSplit',
 150   'data': [ 'on', 'off', 'split' ] }