qemu/qapi/event.json

   1 ##
   2 # @SHUTDOWN
   3 #
   4 # Emitted when the virtual machine has shut down, indicating that qemu is
   5 # about to exit.
   6 #
   7 # Note: If the command-line option "-no-shutdown" has been specified, qemu will
   8 # not exit, and a STOP event will eventually follow the SHUTDOWN event
   9 #
  10 # Since: 0.12.0
  11 ##
  12 { 'event': 'SHUTDOWN' }
  13
  14 ##
  15 # @POWERDOWN
  16 #
  17 # Emitted when the virtual machine is powered down through the power control
  18 # system, such as via ACPI.
  19 #
  20 # Since: 0.12.0
  21 ##
  22 { 'event': 'POWERDOWN' }
  23
  24 ##
  25 # @RESET
  26 #
  27 # Emitted when the virtual machine is reset
  28 #
  29 # Since: 0.12.0
  30 ##
  31 { 'event': 'RESET' }
  32
  33 ##
  34 # @STOP
  35 #
  36 # Emitted when the virtual machine is stopped
  37 #
  38 # Since: 0.12.0
  39 ##
  40 { 'event': 'STOP' }
  41
  42 ##
  43 # @RESUME
  44 #
  45 # Emitted when the virtual machine resumes execution
  46 #
  47 # Since: 0.12.0
  48 ##
  49 { 'event': 'RESUME' }
  50
  51 ##
  52 # @SUSPEND
  53 #
  54 # Emitted when guest enters a hardware suspension state, for example, S3 state,
  55 # which is sometimes called standby state
  56 #
  57 # Since: 1.1
  58 ##
  59 { 'event': 'SUSPEND' }
  60
  61 ##
  62 # @SUSPEND_DISK
  63 #
  64 # Emitted when guest enters a hardware suspension state with data saved on
  65 # disk, for example, S4 state, which is sometimes called hibernate state
  66 #
  67 # Note: QEMU shuts down (similar to event @SHUTDOWN) when entering this state
  68 #
  69 # Since: 1.2
  70 ##
  71 { 'event': 'SUSPEND_DISK' }
  72
  73 ##
  74 # @WAKEUP
  75 #
  76 # Emitted when the guest has woken up from suspend state and is running
  77 #
  78 # Since: 1.1
  79 ##
  80 { 'event': 'WAKEUP' }
  81
  82 ##
  83 # @RTC_CHANGE
  84 #
  85 # Emitted when the guest changes the RTC time.
  86 #
  87 # @offset: offset between base RTC clock (as specified by -rtc base), and
  88 #          new RTC clock value
  89 #
  90 # Since: 0.13.0
  91 ##
  92 { 'event': 'RTC_CHANGE',
  93   'data': { 'offset': 'int' } }
  94
  95 ##
  96 # @WATCHDOG
  97 #
  98 # Emitted when the watchdog device's timer is expired
  99 #
 100 # @action: action that has been taken
 101 #
 102 # Note: If action is "reset", "shutdown", or "pause" the WATCHDOG event is
 103 # followed respectively by the RESET, SHUTDOWN, or STOP events
 104 #
 105 # Since: 0.13.0
 106 ##
 107 { 'event': 'WATCHDOG',
 108   'data': { 'action': 'WatchdogExpirationAction' } }
 109
 110 ##
 111 # @DEVICE_DELETED
 112 #
 113 # Emitted whenever the device removal completion is acknowledged by the guest.
 114 # At this point, it's safe to reuse the specified device ID. Device removal can
 115 # be initiated by the guest or by HMP/QMP commands.
 116 #
 117 # @device: #optional, device name
 118 #
 119 # @path: device path
 120 #
 121 # Since: 1.5
 122 ##
 123 { 'event': 'DEVICE_DELETED',
 124   'data': { '*device': 'str', 'path': 'str' } }
 125
 126 ##
 127 # @NIC_RX_FILTER_CHANGED
 128 #
 129 # Emitted once until the 'query-rx-filter' command is executed, the first event
 130 # will always be emitted
 131 #
 132 # @name: #optional, net client name
 133 #
 134 # @path: device path
 135 #
 136 # Since: 1.6
 137 ##
 138 { 'event': 'NIC_RX_FILTER_CHANGED',
 139   'data': { '*name': 'str', 'path': 'str' } }
 140
 141 ##
 142 # @VNC_CONNECTED
 143 #
 144 # Emitted when a VNC client establishes a connection
 145 #
 146 # @server: server information
 147 #
 148 # @client: client information
 149 #
 150 # Note: This event is emitted before any authentication takes place, thus
 151 # the authentication ID is not provided
 152 #
 153 # Since: 0.13.0
 154 ##
 155 { 'event': 'VNC_CONNECTED',
 156   'data': { 'server': 'VncServerInfo',
 157             'client': 'VncBasicInfo' } }
 158
 159 ##
 160 # @VNC_INITIALIZED
 161 #
 162 # Emitted after authentication takes place (if any) and the VNC session is
 163 # made active
 164 #
 165 # @server: server information
 166 #
 167 # @client: client information
 168 #
 169 # Since: 0.13.0
 170 ##
 171 { 'event': 'VNC_INITIALIZED',
 172   'data': { 'server': 'VncServerInfo',
 173             'client': 'VncClientInfo' } }
 174
 175 ##
 176 # @VNC_DISCONNECTED
 177 #
 178 # Emitted when the connection is closed
 179 #
 180 # @server: server information
 181 #
 182 # @client: client information
 183 #
 184 # Since: 0.13.0
 185 ##
 186 { 'event': 'VNC_DISCONNECTED',
 187   'data': { 'server': 'VncServerInfo',
 188             'client': 'VncClientInfo' } }
 189
 190 ##
 191 # @SPICE_CONNECTED
 192 #
 193 # Emitted when a SPICE client establishes a connection
 194 #
 195 # @server: server information
 196 #
 197 # @client: client information
 198 #
 199 # Since: 0.14.0
 200 ##
 201 { 'event': 'SPICE_CONNECTED',
 202   'data': { 'server': 'SpiceBasicInfo',
 203             'client': 'SpiceBasicInfo' } }
 204
 205 ##
 206 # @SPICE_INITIALIZED
 207 #
 208 # Emitted after initial handshake and authentication takes place (if any)
 209 # and the SPICE channel is up and running
 210 #
 211 # @server: server information
 212 #
 213 # @client: client information
 214 #
 215 # Since: 0.14.0
 216 ##
 217 { 'event': 'SPICE_INITIALIZED',
 218   'data': { 'server': 'SpiceServerInfo',
 219             'client': 'SpiceChannel' } }
 220
 221 ##
 222 # @SPICE_DISCONNECTED
 223 #
 224 # Emitted when the SPICE connection is closed
 225 #
 226 # @server: server information
 227 #
 228 # @client: client information
 229 #
 230 # Since: 0.14.0
 231 ##
 232 { 'event': 'SPICE_DISCONNECTED',
 233   'data': { 'server': 'SpiceBasicInfo',
 234             'client': 'SpiceBasicInfo' } }
 235
 236 ##
 237 # @SPICE_MIGRATE_COMPLETED
 238 #
 239 # Emitted when SPICE migration has completed
 240 #
 241 # Since: 1.3
 242 ##
 243 { 'event': 'SPICE_MIGRATE_COMPLETED' }
 244
 245 ##
 246 # @MIGRATION
 247 #
 248 # Emitted when a migration event happens
 249 #
 250 # @status: @MigrationStatus describing the current migration status.
 251 #
 252 # Since: 2.4
 253 ##
 254 { 'event': 'MIGRATION',
 255   'data': {'status': 'MigrationStatus'}}
 256
 257 ##
 258 # @ACPI_DEVICE_OST
 259 #
 260 # Emitted when guest executes ACPI _OST method.
 261 #
 262 # Since: 2.1
 263 #
 264 # @info: ACPIOSTInfo type as described in qapi-schema.json
 265 ##
 266 { 'event': 'ACPI_DEVICE_OST',
 267      'data': { 'info': 'ACPIOSTInfo' } }
 268
 269 ##
 270 # @BALLOON_CHANGE
 271 #
 272 # Emitted when the guest changes the actual BALLOON level. This value is
 273 # equivalent to the @actual field return by the 'query-balloon' command
 274 #
 275 # @actual: actual level of the guest memory balloon in bytes
 276 #
 277 # Since: 1.2
 278 ##
 279 { 'event': 'BALLOON_CHANGE',
 280   'data': { 'actual': 'int' } }
 281
 282 ##
 283 # @GUEST_PANICKED
 284 #
 285 # Emitted when guest OS panic is detected
 286 #
 287 # @action: action that has been taken, currently always "pause"
 288 #
 289 # Since: 1.5
 290 ##
 291 { 'event': 'GUEST_PANICKED',
 292   'data': { 'action': 'GuestPanicAction' } }
 293
 294 ##
 295 # @QUORUM_FAILURE
 296 #
 297 # Emitted by the Quorum block driver if it fails to establish a quorum
 298 #
 299 # @reference: device name if defined else node name
 300 #
 301 # @sector-num: number of the first sector of the failed read operation
 302 #
 303 # @sectors-count: failed read operation sector count
 304 #
 305 # Since: 2.0
 306 ##
 307 { 'event': 'QUORUM_FAILURE',
 308   'data': { 'reference': 'str', 'sector-num': 'int', 'sectors-count': 'int' } }
 309
 310 ##
 311 # @QUORUM_REPORT_BAD
 312 #
 313 # Emitted to report a corruption of a Quorum file
 314 #
 315 # @error: #optional, error message. Only present on failure. This field
 316 #         contains a human-readable error message. There are no semantics other
 317 #         than that the block layer reported an error and clients should not
 318 #         try to interpret the error string.
 319 #
 320 # @node-name: the graph node name of the block driver state
 321 #
 322 # @sector-num: number of the first sector of the failed read operation
 323 #
 324 # @sectors-count: failed read operation sector count
 325 #
 326 # Since: 2.0
 327 ##
 328 { 'event': 'QUORUM_REPORT_BAD',
 329   'data': { '*error': 'str', 'node-name': 'str',
 330             'sector-num': 'int', 'sectors-count': 'int' } }
 331
 332 ##
 333 # @VSERPORT_CHANGE
 334 #
 335 # Emitted when the guest opens or closes a virtio-serial port.
 336 #
 337 # @id: device identifier of the virtio-serial port
 338 #
 339 # @open: true if the guest has opened the virtio-serial port
 340 #
 341 # Since: 2.1
 342 ##
 343 { 'event': 'VSERPORT_CHANGE',
 344   'data': { 'id': 'str', 'open': 'bool' } }
 345
 346 ##
 347 # @MEM_UNPLUG_ERROR
 348 #
 349 # Emitted when memory hot unplug error occurs.
 350 #
 351 # @device: device name
 352 #
 353 # @msg: Informative message
 354 #
 355 # Since: 2.4
 356 ##
 357 { 'event': 'MEM_UNPLUG_ERROR',
 358   'data': { 'device': 'str', 'msg': 'str' } }