linux-user: stack_base is now mandatory on all targets
[qemu.git] / qapi-schema.json
1 # -*- Mode: Python -*-
2 #
3 # QAPI Schema
4
5 ##
6 # @NameInfo:
7 #
8 # Guest name information.
9 #
10 # @name: #optional The name of the guest
11 #
12 # Since 0.14.0
13 ##
14 { 'type': 'NameInfo', 'data': {'*name': 'str'} }
15
16 ##
17 # @query-name:
18 #
19 # Return the name information of a guest.
20 #
21 # Returns: @NameInfo of the guest
22 #
23 # Since 0.14.0
24 ##
25 { 'command': 'query-name', 'returns': 'NameInfo' }
26
27 ##
28 # @VersionInfo:
29 #
30 # A description of QEMU's version.
31 #
32 # @qemu.major:  The major version of QEMU
33 #
34 # @qemu.minor:  The minor version of QEMU
35 #
36 # @qemu.micro:  The micro version of QEMU.  By current convention, a micro
37 #               version of 50 signifies a development branch.  A micro version
38 #               greater than or equal to 90 signifies a release candidate for
39 #               the next minor version.  A micro version of less than 50
40 #               signifies a stable release.
41 #
42 # @package:     QEMU will always set this field to an empty string.  Downstream
43 #               versions of QEMU should set this to a non-empty string.  The
44 #               exact format depends on the downstream however it highly
45 #               recommended that a unique name is used.
46 #
47 # Since: 0.14.0
48 ##
49 { 'type': 'VersionInfo',
50   'data': {'qemu': {'major': 'int', 'minor': 'int', 'micro': 'int'},
51            'package': 'str'} }
52
53 ##
54 # @query-version:
55 #
56 # Returns the current version of QEMU.
57 #
58 # Returns:  A @VersionInfo object describing the current version of QEMU.
59 #
60 # Since: 0.14.0
61 ##
62 { 'command': 'query-version', 'returns': 'VersionInfo' }
63
64 ##
65 # @KvmInfo:
66 #
67 # Information about support for KVM acceleration
68 #
69 # @enabled: true if KVM acceleration is active
70 #
71 # @present: true if KVM acceleration is built into this executable
72 #
73 # Since: 0.14.0
74 ##
75 { 'type': 'KvmInfo', 'data': {'enabled': 'bool', 'present': 'bool'} }
76
77 ##
78 # @query-kvm:
79 #
80 # Returns information about KVM acceleration
81 #
82 # Returns: @KvmInfo
83 #
84 # Since: 0.14.0
85 ##
86 { 'command': 'query-kvm', 'returns': 'KvmInfo' }
87
88 ##
89 # @RunState
90 #
91 # An enumation of VM run states.
92 #
93 # @debug: QEMU is running on a debugger
94 #
95 # @inmigrate: guest is paused waiting for an incoming migration
96 #
97 # @internal-error: An internal error that prevents further guest execution
98 # has occurred
99 #
100 # @io-error: the last IOP has failed and the device is configured to pause
101 # on I/O errors
102 #
103 # @paused: guest has been paused via the 'stop' command
104 #
105 # @postmigrate: guest is paused following a successful 'migrate'
106 #
107 # @prelaunch: QEMU was started with -S and guest has not started
108 #
109 # @finish-migrate: guest is paused to finish the migration process
110 #
111 # @restore-vm: guest is paused to restore VM state
112 #
113 # @running: guest is actively running
114 #
115 # @save-vm: guest is paused to save the VM state
116 #
117 # @shutdown: guest is shut down (and -no-shutdown is in use)
118 #
119 # @watchdog: the watchdog action is configured to pause and has been triggered
120 ##
121 { 'enum': 'RunState',
122   'data': [ 'debug', 'inmigrate', 'internal-error', 'io-error', 'paused',
123             'postmigrate', 'prelaunch', 'finish-migrate', 'restore-vm',
124             'running', 'save-vm', 'shutdown', 'watchdog' ] }
125
126 ##
127 # @StatusInfo:
128 #
129 # Information about VCPU run state
130 #
131 # @running: true if all VCPUs are runnable, false if not runnable
132 #
133 # @singlestep: true if VCPUs are in single-step mode
134 #
135 # @status: the virtual machine @RunState
136 #
137 # Since:  0.14.0
138 #
139 # Notes: @singlestep is enabled through the GDB stub
140 ##
141 { 'type': 'StatusInfo',
142   'data': {'running': 'bool', 'singlestep': 'bool', 'status': 'RunState'} }
143
144 ##
145 # @query-status:
146 #
147 # Query the run status of all VCPUs
148 #
149 # Returns: @StatusInfo reflecting all VCPUs
150 #
151 # Since:  0.14.0
152 ##
153 { 'command': 'query-status', 'returns': 'StatusInfo' }
154
155 ##
156 # @UuidInfo:
157 #
158 # Guest UUID information.
159 #
160 # @UUID: the UUID of the guest
161 #
162 # Since: 0.14.0
163 #
164 # Notes: If no UUID was specified for the guest, a null UUID is returned.
165 ##
166 { 'type': 'UuidInfo', 'data': {'UUID': 'str'} }
167
168 ##
169 # @query-uuid:
170 #
171 # Query the guest UUID information.
172 #
173 # Returns: The @UuidInfo for the guest
174 #
175 # Since 0.14.0
176 ##
177 { 'command': 'query-uuid', 'returns': 'UuidInfo' }
178
179 ##
180 # @ChardevInfo:
181 #
182 # Information about a character device.
183 #
184 # @label: the label of the character device
185 #
186 # @filename: the filename of the character device
187 #
188 # Notes: @filename is encoded using the QEMU command line character device
189 #        encoding.  See the QEMU man page for details.
190 #
191 # Since: 0.14.0
192 ##
193 { 'type': 'ChardevInfo', 'data': {'label': 'str', 'filename': 'str'} }
194
195 ##
196 # @query-chardev:
197 #
198 # Returns information about current character devices.
199 #
200 # Returns: a list of @ChardevInfo
201 #
202 # Since: 0.14.0
203 ##
204 { 'command': 'query-chardev', 'returns': ['ChardevInfo'] }
205
206 ##
207 # @CommandInfo:
208 #
209 # Information about a QMP command
210 #
211 # @name: The command name
212 #
213 # Since: 0.14.0
214 ##
215 { 'type': 'CommandInfo', 'data': {'name': 'str'} }
216
217 ##
218 # @query-commands:
219 #
220 # Return a list of supported QMP commands by this server
221 #
222 # Returns: A list of @CommandInfo for all supported commands
223 #
224 # Since: 0.14.0
225 ##
226 { 'command': 'query-commands', 'returns': ['CommandInfo'] }
227
228 ##
229 # @MigrationStats
230 #
231 # Detailed migration status.
232 #
233 # @transferred: amount of bytes already transferred to the target VM
234 #
235 # @remaining: amount of bytes remaining to be transferred to the target VM
236 #
237 # @total: total amount of bytes involved in the migration process
238 #
239 # Since: 0.14.0.
240 ##
241 { 'type': 'MigrationStats',
242   'data': {'transferred': 'int', 'remaining': 'int', 'total': 'int' } }
243
244 ##
245 # @MigrationInfo
246 #
247 # Information about current migration process.
248 #
249 # @status: #optional string describing the current migration status.
250 #          As of 0.14.0 this can be 'active', 'completed', 'failed' or
251 #          'cancelled'. If this field is not returned, no migration process
252 #          has been initiated
253 #
254 # @ram: #optional @MigrationStats containing detailed migration status,
255 #       only returned if status is 'active'
256 #
257 # @disk: #optional @MigrationStats containing detailed disk migration
258 #        status, only returned if status is 'active' and it is a block
259 #        migration
260 #
261 # Since: 0.14.0
262 ##
263 { 'type': 'MigrationInfo',
264   'data': {'*status': 'str', '*ram': 'MigrationStats',
265            '*disk': 'MigrationStats'} }
266
267 ##
268 # @query-migrate
269 #
270 # Returns information about current migration process.
271 #
272 # Returns: @MigrationInfo
273 #
274 # Since: 0.14.0
275 ##
276 { 'command': 'query-migrate', 'returns': 'MigrationInfo' }
277
278 ##
279 # @MouseInfo:
280 #
281 # Information about a mouse device.
282 #
283 # @name: the name of the mouse device
284 #
285 # @index: the index of the mouse device
286 #
287 # @current: true if this device is currently receiving mouse events
288 #
289 # @absolute: true if this device supports absolute coordinates as input
290 #
291 # Since: 0.14.0
292 ##
293 { 'type': 'MouseInfo',
294   'data': {'name': 'str', 'index': 'int', 'current': 'bool',
295            'absolute': 'bool'} }
296
297 ##
298 # @query-mice:
299 #
300 # Returns information about each active mouse device
301 #
302 # Returns: a list of @MouseInfo for each device
303 #
304 # Since: 0.14.0
305 ##
306 { 'command': 'query-mice', 'returns': ['MouseInfo'] }
307
308 ##
309 # @CpuInfo:
310 #
311 # Information about a virtual CPU
312 #
313 # @CPU: the index of the virtual CPU
314 #
315 # @current: this only exists for backwards compatible and should be ignored
316
317 # @halted: true if the virtual CPU is in the halt state.  Halt usually refers
318 #          to a processor specific low power mode.
319 #
320 # @pc: #optional If the target is i386 or x86_64, this is the 64-bit instruction
321 #                pointer.
322 #                If the target is Sparc, this is the PC component of the
323 #                instruction pointer.
324 #
325 # @nip: #optional If the target is PPC, the instruction pointer
326 #
327 # @npc: #optional If the target is Sparc, the NPC component of the instruction
328 #                 pointer
329 #
330 # @PC: #optional If the target is MIPS, the instruction pointer
331 #
332 # @thread_id: ID of the underlying host thread
333 #
334 # Since: 0.14.0
335 #
336 # Notes: @halted is a transient state that changes frequently.  By the time the
337 #        data is sent to the client, the guest may no longer be halted.
338 ##
339 { 'type': 'CpuInfo',
340   'data': {'CPU': 'int', 'current': 'bool', 'halted': 'bool', '*pc': 'int',
341            '*nip': 'int', '*npc': 'int', '*PC': 'int', 'thread_id': 'int'} }
342
343 ##
344 # @query-cpus:
345 #
346 # Returns a list of information about each virtual CPU.
347 #
348 # Returns: a list of @CpuInfo for each virtual CPU
349 #
350 # Since: 0.14.0
351 ##
352 { 'command': 'query-cpus', 'returns': ['CpuInfo'] }
353
354 ##
355 # @BlockDeviceInfo:
356 #
357 # Information about the backing device for a block device.
358 #
359 # @file: the filename of the backing device
360 #
361 # @ro: true if the backing device was open read-only
362 #
363 # @drv: the name of the block format used to open the backing device. As of
364 #       0.14.0 this can be: 'blkdebug', 'bochs', 'cloop', 'cow', 'dmg',
365 #       'file', 'file', 'ftp', 'ftps', 'host_cdrom', 'host_device',
366 #       'host_floppy', 'http', 'https', 'nbd', 'parallels', 'qcow',
367 #       'qcow2', 'raw', 'tftp', 'vdi', 'vmdk', 'vpc', 'vvfat'
368 #
369 # @backing_file: #optional the name of the backing file (for copy-on-write)
370 #
371 # @encrypted: true if the backing device is encrypted
372 #
373 # @bps: total throughput limit in bytes per second is specified
374 #
375 # @bps_rd: read throughput limit in bytes per second is specified
376 #
377 # @bps_wr: write throughput limit in bytes per second is specified
378 #
379 # @iops: total I/O operations per second is specified
380 #
381 # @iops_rd: read I/O operations per second is specified
382 #
383 # @iops_wr: write I/O operations per second is specified
384 #
385 # Since: 0.14.0
386 #
387 # Notes: This interface is only found in @BlockInfo.
388 ##
389 { 'type': 'BlockDeviceInfo',
390   'data': { 'file': 'str', 'ro': 'bool', 'drv': 'str',
391             '*backing_file': 'str', 'encrypted': 'bool',
392             'bps': 'int', 'bps_rd': 'int', 'bps_wr': 'int',
393             'iops': 'int', 'iops_rd': 'int', 'iops_wr': 'int'} }
394
395 ##
396 # @BlockDeviceIoStatus:
397 #
398 # An enumeration of block device I/O status.
399 #
400 # @ok: The last I/O operation has succeeded
401 #
402 # @failed: The last I/O operation has failed
403 #
404 # @nospace: The last I/O operation has failed due to a no-space condition
405 #
406 # Since: 1.0
407 ##
408 { 'enum': 'BlockDeviceIoStatus', 'data': [ 'ok', 'failed', 'nospace' ] }
409
410 ##
411 # @BlockInfo:
412 #
413 # Block device information.  This structure describes a virtual device and
414 # the backing device associated with it.
415 #
416 # @device: The device name associated with the virtual device.
417 #
418 # @type: This field is returned only for compatibility reasons, it should
419 #        not be used (always returns 'unknown')
420 #
421 # @removable: True if the device supports removable media.
422 #
423 # @locked: True if the guest has locked this device from having its media
424 #          removed
425 #
426 # @tray_open: #optional True if the device has a tray and it is open
427 #             (only present if removable is true)
428 #
429 # @io-status: #optional @BlockDeviceIoStatus. Only present if the device
430 #             supports it and the VM is configured to stop on errors
431 #
432 # @inserted: #optional @BlockDeviceInfo describing the device if media is
433 #            present
434 #
435 # Since:  0.14.0
436 ##
437 { 'type': 'BlockInfo',
438   'data': {'device': 'str', 'type': 'str', 'removable': 'bool',
439            'locked': 'bool', '*inserted': 'BlockDeviceInfo',
440            '*tray_open': 'bool', '*io-status': 'BlockDeviceIoStatus'} }
441
442 ##
443 # @query-block:
444 #
445 # Get a list of BlockInfo for all virtual block devices.
446 #
447 # Returns: a list of @BlockInfo describing each virtual block device
448 #
449 # Since: 0.14.0
450 ##
451 { 'command': 'query-block', 'returns': ['BlockInfo'] }
452
453 ##
454 # @BlockDeviceStats:
455 #
456 # Statistics of a virtual block device or a block backing device.
457 #
458 # @rd_bytes:      The number of bytes read by the device.
459 #
460 # @wr_bytes:      The number of bytes written by the device.
461 #
462 # @rd_operations: The number of read operations performed by the device.
463 #
464 # @wr_operations: The number of write operations performed by the device.
465 #
466 # @flush_operations: The number of cache flush operations performed by the
467 #                    device (since 0.15.0)
468 #
469 # @flush_total_time_ns: Total time spend on cache flushes in nano-seconds
470 #                       (since 0.15.0).
471 #
472 # @wr_total_time_ns: Total time spend on writes in nano-seconds (since 0.15.0).
473 #
474 # @rd_total_time_ns: Total_time_spend on reads in nano-seconds (since 0.15.0).
475 #
476 # @wr_highest_offset: The offset after the greatest byte written to the
477 #                     device.  The intended use of this information is for
478 #                     growable sparse files (like qcow2) that are used on top
479 #                     of a physical device.
480 #
481 # Since: 0.14.0
482 ##
483 { 'type': 'BlockDeviceStats',
484   'data': {'rd_bytes': 'int', 'wr_bytes': 'int', 'rd_operations': 'int',
485            'wr_operations': 'int', 'flush_operations': 'int',
486            'flush_total_time_ns': 'int', 'wr_total_time_ns': 'int',
487            'rd_total_time_ns': 'int', 'wr_highest_offset': 'int' } }
488
489 ##
490 # @BlockStats:
491 #
492 # Statistics of a virtual block device or a block backing device.
493 #
494 # @device: #optional If the stats are for a virtual block device, the name
495 #          corresponding to the virtual block device.
496 #
497 # @stats:  A @BlockDeviceStats for the device.
498 #
499 # @parent: #optional This may point to the backing block device if this is a
500 #          a virtual block device.  If it's a backing block, this will point
501 #          to the backing file is one is present.
502 #
503 # Since: 0.14.0
504 ##
505 { 'type': 'BlockStats',
506   'data': {'*device': 'str', 'stats': 'BlockDeviceStats',
507            '*parent': 'BlockStats'} }
508
509 ##
510 # @query-blockstats:
511 #
512 # Query the @BlockStats for all virtual block devices.
513 #
514 # Returns: A list of @BlockStats for each virtual block devices.
515 #
516 # Since: 0.14.0
517 ##
518 { 'command': 'query-blockstats', 'returns': ['BlockStats'] }
519
520 ##
521 # @VncClientInfo:
522 #
523 # Information about a connected VNC client.
524 #
525 # @host: The host name of the client.  QEMU tries to resolve this to a DNS name
526 #        when possible.
527 #
528 # @family: 'ipv6' if the client is connected via IPv6 and TCP
529 #          'ipv4' if the client is connected via IPv4 and TCP
530 #          'unix' if the client is connected via a unix domain socket
531 #          'unknown' otherwise
532 #
533 # @service: The service name of the client's port.  This may depends on the
534 #           host system's service database so symbolic names should not be
535 #           relied on.
536 #
537 # @x509_dname: #optional If x509 authentication is in use, the Distinguished
538 #              Name of the client.
539 #
540 # @sasl_username: #optional If SASL authentication is in use, the SASL username
541 #                 used for authentication.
542 #
543 # Since: 0.14.0
544 ##
545 { 'type': 'VncClientInfo',
546   'data': {'host': 'str', 'family': 'str', 'service': 'str',
547            '*x509_dname': 'str', '*sasl_username': 'str'} }
548
549 ##
550 # @VncInfo:
551 #
552 # Information about the VNC session.
553 #
554 # @enabled: true if the VNC server is enabled, false otherwise
555 #
556 # @host: #optional The hostname the VNC server is bound to.  This depends on
557 #        the name resolution on the host and may be an IP address.
558 #
559 # @family: #optional 'ipv6' if the host is listening for IPv6 connections
560 #                    'ipv4' if the host is listening for IPv4 connections
561 #                    'unix' if the host is listening on a unix domain socket
562 #                    'unknown' otherwise
563 #
564 # @service: #optional The service name of the server's port.  This may depends
565 #           on the host system's service database so symbolic names should not
566 #           be relied on.
567 #
568 # @auth: #optional the current authentication type used by the server
569 #        'none' if no authentication is being used
570 #        'vnc' if VNC authentication is being used
571 #        'vencrypt+plain' if VEncrypt is used with plain text authentication
572 #        'vencrypt+tls+none' if VEncrypt is used with TLS and no authentication
573 #        'vencrypt+tls+vnc' if VEncrypt is used with TLS and VNC authentication
574 #        'vencrypt+tls+plain' if VEncrypt is used with TLS and plain text auth
575 #        'vencrypt+x509+none' if VEncrypt is used with x509 and no auth
576 #        'vencrypt+x509+vnc' if VEncrypt is used with x509 and VNC auth
577 #        'vencrypt+x509+plain' if VEncrypt is used with x509 and plain text auth
578 #        'vencrypt+tls+sasl' if VEncrypt is used with TLS and SASL auth
579 #        'vencrypt+x509+sasl' if VEncrypt is used with x509 and SASL auth
580 #
581 # @clients: a list of @VncClientInfo of all currently connected clients
582 #
583 # Since: 0.14.0
584 ##
585 { 'type': 'VncInfo',
586   'data': {'enabled': 'bool', '*host': 'str', '*family': 'str',
587            '*service': 'str', '*auth': 'str', '*clients': ['VncClientInfo']} }
588
589 ##
590 # @query-vnc:
591 #
592 # Returns information about the current VNC server
593 #
594 # Returns: @VncInfo
595 #          If VNC support is not compiled in, FeatureDisabled
596 #
597 # Since: 0.14.0
598 ##
599 { 'command': 'query-vnc', 'returns': 'VncInfo' }
600
601 ##
602 # @SpiceChannel
603 #
604 # Information about a SPICE client channel.
605 #
606 # @host: The host name of the client.  QEMU tries to resolve this to a DNS name
607 #        when possible.
608 #
609 # @family: 'ipv6' if the client is connected via IPv6 and TCP
610 #          'ipv4' if the client is connected via IPv4 and TCP
611 #          'unix' if the client is connected via a unix domain socket
612 #          'unknown' otherwise
613 #
614 # @port: The client's port number.
615 #
616 # @connection-id: SPICE connection id number.  All channels with the same id
617 #                 belong to the same SPICE session.
618 #
619 # @connection-type: SPICE channel type number.  "1" is the main control channel,
620 #                   filter for this one if you want track spice sessions only
621 #
622 # @channel-id: SPICE channel ID number.  Usually "0", might be different needed
623 #              when multiple channels of the same type exist, such as multiple
624 #              display channels in a multihead setup
625 #
626 # @tls: true if the channel is encrypted, false otherwise.
627 #
628 # Since: 0.14.0
629 ##
630 { 'type': 'SpiceChannel',
631   'data': {'host': 'str', 'family': 'str', 'port': 'str',
632            'connection-id': 'int', 'channel-type': 'int', 'channel-id': 'int',
633            'tls': 'bool'} }
634
635 ##
636 # @SpiceInfo
637 #
638 # Information about the SPICE session.
639
640 # @enabled: true if the SPICE server is enabled, false otherwise
641 #
642 # @host: #optional The hostname the SPICE server is bound to.  This depends on
643 #        the name resolution on the host and may be an IP address.
644 #
645 # @port: #optional The SPICE server's port number.
646 #
647 # @compiled-version: #optional SPICE server version.
648 #
649 # @tls-port: #optional The SPICE server's TLS port number.
650 #
651 # @auth: #optional the current authentication type used by the server
652 #        'none' if no authentication is being used
653 #        'spice' (TODO: describe)
654 #
655 # @channels: a list of @SpiceChannel for each active spice channel
656 #
657 # Since: 0.14.0
658 ##
659 { 'type': 'SpiceInfo',
660   'data': {'enabled': 'bool', '*host': 'str', '*port': 'int',
661            '*tls-port': 'int', '*auth': 'str', '*compiled-version': 'str',
662            '*channels': ['SpiceChannel']} }
663
664 ##
665 # @query-spice
666 #
667 # Returns information about the current SPICE server
668 #
669 # Returns: @SpiceInfo
670 #
671 # Since: 0.14.0
672 ##
673 { 'command': 'query-spice', 'returns': 'SpiceInfo' }
674
675 ##
676 # @BalloonInfo:
677 #
678 # Information about the guest balloon device.
679 #
680 # @actual: the number of bytes the balloon currently contains
681 #
682 # @mem_swapped_in: #optional number of pages swapped in within the guest
683 #
684 # @mem_swapped_out: #optional number of pages swapped out within the guest
685 #
686 # @major_page_faults: #optional number of major page faults within the guest
687 #
688 # @minor_page_faults: #optional number of minor page faults within the guest
689 #
690 # @free_mem: #optional amount of memory (in bytes) free in the guest
691 #
692 # @total_mem: #optional amount of memory (in bytes) visible to the guest
693 #
694 # Since: 0.14.0
695 #
696 # Notes: all current versions of QEMU do not fill out optional information in
697 #        this structure.
698 ##
699 { 'type': 'BalloonInfo',
700   'data': {'actual': 'int', '*mem_swapped_in': 'int',
701            '*mem_swapped_out': 'int', '*major_page_faults': 'int',
702            '*minor_page_faults': 'int', '*free_mem': 'int',
703            '*total_mem': 'int'} }
704
705 ##
706 # @query-balloon:
707 #
708 # Return information about the balloon device.
709 #
710 # Returns: @BalloonInfo on success
711 #          If the balloon driver is enabled but not functional because the KVM
712 #          kernel module cannot support it, KvmMissingCap
713 #          If no balloon device is present, DeviceNotActive
714 #
715 # Since: 0.14.0
716 ##
717 { 'command': 'query-balloon', 'returns': 'BalloonInfo' }
718
719 ##
720 # @PciMemoryRange:
721 #
722 # A PCI device memory region
723 #
724 # @base: the starting address (guest physical)
725 #
726 # @limit: the ending address (guest physical)
727 #
728 # Since: 0.14.0
729 ##
730 { 'type': 'PciMemoryRange', 'data': {'base': 'int', 'limit': 'int'} }
731
732 ##
733 # @PciMemoryRegion
734 #
735 # Information about a PCI device I/O region.
736 #
737 # @bar: the index of the Base Address Register for this region
738 #
739 # @type: 'io' if the region is a PIO region
740 #        'memory' if the region is a MMIO region
741 #
742 # @prefetch: #optional if @type is 'memory', true if the memory is prefetchable
743 #
744 # @mem_type_64: #optional if @type is 'memory', true if the BAR is 64-bit
745 #
746 # Since: 0.14.0
747 ##
748 { 'type': 'PciMemoryRegion',
749   'data': {'bar': 'int', 'type': 'str', 'address': 'int', 'size': 'int',
750            '*prefetch': 'bool', '*mem_type_64': 'bool' } }
751
752 ##
753 # @PciBridgeInfo:
754 #
755 # Information about a PCI Bridge device
756 #
757 # @bus.number: primary bus interface number.  This should be the number of the
758 #              bus the device resides on.
759 #
760 # @bus.secondary: secondary bus interface number.  This is the number of the
761 #                 main bus for the bridge
762 #
763 # @bus.subordinate: This is the highest number bus that resides below the
764 #                   bridge.
765 #
766 # @bus.io_range: The PIO range for all devices on this bridge
767 #
768 # @bus.memory_range: The MMIO range for all devices on this bridge
769 #
770 # @bus.prefetchable_range: The range of prefetchable MMIO for all devices on
771 #                          this bridge
772 #
773 # @devices: a list of @PciDeviceInfo for each device on this bridge
774 #
775 # Since: 0.14.0
776 ##
777 { 'type': 'PciBridgeInfo',
778   'data': {'bus': { 'number': 'int', 'secondary': 'int', 'subordinate': 'int',
779                     'io_range': 'PciMemoryRange',
780                     'memory_range': 'PciMemoryRange',
781                     'prefetchable_range': 'PciMemoryRange' },
782            '*devices': ['PciDeviceInfo']} }
783
784 ##
785 # @PciDeviceInfo:
786 #
787 # Information about a PCI device
788 #
789 # @bus: the bus number of the device
790 #
791 # @slot: the slot the device is located in
792 #
793 # @function: the function of the slot used by the device
794 #
795 # @class_info.desc: #optional a string description of the device's class
796 #
797 # @class_info.class: the class code of the device
798 #
799 # @id.device: the PCI device id
800 #
801 # @id.vendor: the PCI vendor id
802 #
803 # @irq: #optional if an IRQ is assigned to the device, the IRQ number
804 #
805 # @qdev_id: the device name of the PCI device
806 #
807 # @pci_bridge: if the device is a PCI bridge, the bridge information
808 #
809 # @regions: a list of the PCI I/O regions associated with the device
810 #
811 # Notes: the contents of @class_info.desc are not stable and should only be
812 #        treated as informational.
813 #
814 # Since: 0.14.0
815 ##
816 { 'type': 'PciDeviceInfo',
817   'data': {'bus': 'int', 'slot': 'int', 'function': 'int',
818            'class_info': {'*desc': 'str', 'class': 'int'},
819            'id': {'device': 'int', 'vendor': 'int'},
820            '*irq': 'int', 'qdev_id': 'str', '*pci_bridge': 'PciBridgeInfo',
821            'regions': ['PciMemoryRegion']} }
822
823 ##
824 # @PciInfo:
825 #
826 # Information about a PCI bus
827 #
828 # @bus: the bus index
829 #
830 # @devices: a list of devices on this bus
831 #
832 # Since: 0.14.0
833 ##
834 { 'type': 'PciInfo', 'data': {'bus': 'int', 'devices': ['PciDeviceInfo']} }
835
836 ##
837 # @query-pci:
838 #
839 # Return information about the PCI bus topology of the guest.
840 #
841 # Returns: a list of @PciInfo for each PCI bus
842 #
843 # Since: 0.14.0
844 ##
845 { 'command': 'query-pci', 'returns': ['PciInfo'] }
846
847 ##
848 # @BlockJobInfo:
849 #
850 # Information about a long-running block device operation.
851 #
852 # @type: the job type ('stream' for image streaming)
853 #
854 # @device: the block device name
855 #
856 # @len: the maximum progress value
857 #
858 # @offset: the current progress value
859 #
860 # @speed: the rate limit, bytes per second
861 #
862 # Since: 1.1
863 ##
864 { 'type': 'BlockJobInfo',
865   'data': {'type': 'str', 'device': 'str', 'len': 'int',
866            'offset': 'int', 'speed': 'int'} }
867
868 ##
869 # @query-block-jobs:
870 #
871 # Return information about long-running block device operations.
872 #
873 # Returns: a list of @BlockJobInfo for each active block job
874 #
875 # Since: 1.1
876 ##
877 { 'command': 'query-block-jobs', 'returns': ['BlockJobInfo'] }
878
879 ##
880 # @quit:
881 #
882 # This command will cause the QEMU process to exit gracefully.  While every
883 # attempt is made to send the QMP response before terminating, this is not
884 # guaranteed.  When using this interface, a premature EOF would not be
885 # unexpected.
886 #
887 # Since: 0.14.0
888 ##
889 { 'command': 'quit' }
890
891 ##
892 # @stop:
893 #
894 # Stop all guest VCPU execution.
895 #
896 # Since:  0.14.0
897 #
898 # Notes:  This function will succeed even if the guest is already in the stopped
899 #         state
900 ##
901 { 'command': 'stop' }
902
903 ##
904 # @system_reset:
905 #
906 # Performs a hard reset of a guest.
907 #
908 # Since: 0.14.0
909 ##
910 { 'command': 'system_reset' }
911
912 ##
913 # @system_powerdown:
914 #
915 # Requests that a guest perform a powerdown operation.
916 #
917 # Since: 0.14.0
918 #
919 # Notes: A guest may or may not respond to this command.  This command
920 #        returning does not indicate that a guest has accepted the request or
921 #        that it has shut down.  Many guests will respond to this command by
922 #        prompting the user in some way.
923 ##
924 { 'command': 'system_powerdown' }
925
926 ##
927 # @cpu:
928 #
929 # This command is a nop that is only provided for the purposes of compatibility.
930 #
931 # Since: 0.14.0
932 #
933 # Notes: Do not use this command.
934 ##
935 { 'command': 'cpu', 'data': {'index': 'int'} }
936
937 ##
938 # @memsave:
939 #
940 # Save a portion of guest memory to a file.
941 #
942 # @val: the virtual address of the guest to start from
943 #
944 # @size: the size of memory region to save
945 #
946 # @filename: the file to save the memory to as binary data
947 #
948 # @cpu-index: #optional the index of the virtual CPU to use for translating the
949 #                       virtual address (defaults to CPU 0)
950 #
951 # Returns: Nothing on success
952 #          If @cpu is not a valid VCPU, InvalidParameterValue
953 #          If @filename cannot be opened, OpenFileFailed
954 #          If an I/O error occurs while writing the file, IOError
955 #
956 # Since: 0.14.0
957 #
958 # Notes: Errors were not reliably returned until 1.1
959 ##
960 { 'command': 'memsave',
961   'data': {'val': 'int', 'size': 'int', 'filename': 'str', '*cpu-index': 'int'} }
962
963 ##
964 # @pmemsave:
965 #
966 # Save a portion of guest physical memory to a file.
967 #
968 # @val: the physical address of the guest to start from
969 #
970 # @size: the size of memory region to save
971 #
972 # @filename: the file to save the memory to as binary data
973 #
974 # Returns: Nothing on success
975 #          If @filename cannot be opened, OpenFileFailed
976 #          If an I/O error occurs while writing the file, IOError
977 #
978 # Since: 0.14.0
979 #
980 # Notes: Errors were not reliably returned until 1.1
981 ##
982 { 'command': 'pmemsave',
983   'data': {'val': 'int', 'size': 'int', 'filename': 'str'} }
984
985 ##
986 # @cont:
987 #
988 # Resume guest VCPU execution.
989 #
990 # Since:  0.14.0
991 #
992 # Returns:  If successful, nothing
993 #           If the QEMU is waiting for an incoming migration, MigrationExpected
994 #           If QEMU was started with an encrypted block device and a key has
995 #              not yet been set, DeviceEncrypted.
996 #
997 # Notes:  This command will succeed if the guest is currently running.
998 ##
999 { 'command': 'cont' }
1000
1001 ##
1002 # @inject-nmi:
1003 #
1004 # Injects an Non-Maskable Interrupt into all guest's VCPUs.
1005 #
1006 # Returns:  If successful, nothing
1007 #           If the Virtual Machine doesn't support NMI injection, Unsupported
1008 #
1009 # Since:  0.14.0
1010 #
1011 # Notes: Only x86 Virtual Machines support this command.
1012 ##
1013 { 'command': 'inject-nmi' }
1014
1015 ##
1016 # @set_link:
1017 #
1018 # Sets the link status of a virtual network adapter.
1019 #
1020 # @name: the device name of the virtual network adapter
1021 #
1022 # @up: true to set the link status to be up
1023 #
1024 # Returns: Nothing on success
1025 #          If @name is not a valid network device, DeviceNotFound
1026 #
1027 # Since: 0.14.0
1028 #
1029 # Notes: Not all network adapters support setting link status.  This command
1030 #        will succeed even if the network adapter does not support link status
1031 #        notification.
1032 ##
1033 { 'command': 'set_link', 'data': {'name': 'str', 'up': 'bool'} }
1034
1035 ##
1036 # @block_passwd:
1037 #
1038 # This command sets the password of a block device that has not been open
1039 # with a password and requires one.
1040 #
1041 # The two cases where this can happen are a block device is created through
1042 # QEMU's initial command line or a block device is changed through the legacy
1043 # @change interface.
1044 #
1045 # In the event that the block device is created through the initial command
1046 # line, the VM will start in the stopped state regardless of whether '-S' is
1047 # used.  The intention is for a management tool to query the block devices to
1048 # determine which ones are encrypted, set the passwords with this command, and
1049 # then start the guest with the @cont command.
1050 #
1051 # @device:   the name of the device to set the password on
1052 #
1053 # @password: the password to use for the device
1054 #
1055 # Returns: nothing on success
1056 #          If @device is not a valid block device, DeviceNotFound
1057 #          If @device is not encrypted, DeviceNotEncrypted
1058 #          If @password is not valid for this device, InvalidPassword
1059 #
1060 # Notes:  Not all block formats support encryption and some that do are not
1061 #         able to validate that a password is correct.  Disk corruption may
1062 #         occur if an invalid password is specified.
1063 #
1064 # Since: 0.14.0
1065 ##
1066 { 'command': 'block_passwd', 'data': {'device': 'str', 'password': 'str'} }
1067
1068 ##
1069 # @balloon:
1070 #
1071 # Request the balloon driver to change its balloon size.
1072 #
1073 # @value: the target size of the balloon in bytes
1074 #
1075 # Returns: Nothing on success
1076 #          If the balloon driver is enabled but not functional because the KVM
1077 #            kernel module cannot support it, KvmMissingCap
1078 #          If no balloon device is present, DeviceNotActive
1079 #
1080 # Notes: This command just issues a request to the guest.  When it returns,
1081 #        the balloon size may not have changed.  A guest can change the balloon
1082 #        size independent of this command.
1083 #
1084 # Since: 0.14.0
1085 ##
1086 { 'command': 'balloon', 'data': {'value': 'int'} }
1087
1088 ##
1089 # @block_resize
1090 #
1091 # Resize a block image while a guest is running.
1092 #
1093 # @device:  the name of the device to get the image resized
1094 #
1095 # @size:  new image size in bytes
1096 #
1097 # Returns: nothing on success
1098 #          If @device is not a valid block device, DeviceNotFound
1099 #          If @size is negative, InvalidParameterValue
1100 #          If the block device has no medium inserted, DeviceHasNoMedium
1101 #          If the block device does not support resize, Unsupported
1102 #          If the block device is read-only, DeviceIsReadOnly
1103 #          If a long-running operation is using the device, DeviceInUse
1104 #
1105 # Since: 0.14.0
1106 ##
1107 { 'command': 'block_resize', 'data': { 'device': 'str', 'size': 'int' }}
1108
1109 ##
1110 # @blockdev-snapshot-sync
1111 #
1112 # Generates a synchronous snapshot of a block device.
1113 #
1114 # @device:  the name of the device to generate the snapshot from.
1115 #
1116 # @snapshot-file: the target of the new image. If the file exists, or if it
1117 #                 is a device, the snapshot will be created in the existing
1118 #                 file/device. If does not exist, a new file will be created.
1119 #
1120 # @format: #optional the format of the snapshot image, default is 'qcow2'.
1121 #
1122 # Returns: nothing on success
1123 #          If @device is not a valid block device, DeviceNotFound
1124 #          If @snapshot-file can't be opened, OpenFileFailed
1125 #          If @format is invalid, InvalidBlockFormat
1126 #
1127 # Notes: One of the last steps taken by this command is to close the current
1128 #        image being used by @device and open the @snapshot-file one. If that
1129 #        fails, the command will try to reopen the original image file. If
1130 #        that also fails OpenFileFailed will be returned and the guest may get
1131 #        unexpected errors.
1132 #
1133 # Since 0.14.0
1134 ##
1135 { 'command': 'blockdev-snapshot-sync',
1136   'data': { 'device': 'str', 'snapshot-file': 'str', '*format': 'str' } }
1137
1138 ##
1139 # @human-monitor-command:
1140 #
1141 # Execute a command on the human monitor and return the output.
1142 #
1143 # @command-line: the command to execute in the human monitor
1144 #
1145 # @cpu-index: #optional The CPU to use for commands that require an implicit CPU
1146 #
1147 # Returns: the output of the command as a string
1148 #
1149 # Since: 0.14.0
1150 #
1151 # Notes: This command only exists as a stop-gap.  It's use is highly
1152 #        discouraged.  The semantics of this command are not guaranteed.
1153 #
1154 #        Known limitations:
1155 #
1156 #        o This command is stateless, this means that commands that depend
1157 #          on state information (such as getfd) might not work
1158 #
1159 #       o Commands that prompt the user for data (eg. 'cont' when the block
1160 #         device is encrypted) don't currently work
1161 ##
1162 { 'command': 'human-monitor-command',
1163   'data': {'command-line': 'str', '*cpu-index': 'int'},
1164   'returns': 'str' } 
1165
1166 ##
1167 # @migrate_cancel
1168 #
1169 # Cancel the current executing migration process.
1170 #
1171 # Returns: nothing on success
1172 #
1173 # Notes: This command succeeds even if there is no migration process running.
1174 #
1175 # Since: 0.14.0
1176 ##
1177 { 'command': 'migrate_cancel' }
1178
1179 ##
1180 # @migrate_set_downtime
1181 #
1182 # Set maximum tolerated downtime for migration.
1183 #
1184 # @value: maximum downtime in seconds
1185 #
1186 # Returns: nothing on success
1187 #
1188 # Since: 0.14.0
1189 ##
1190 { 'command': 'migrate_set_downtime', 'data': {'value': 'number'} }
1191
1192 ##
1193 # @migrate_set_speed
1194 #
1195 # Set maximum speed for migration.
1196 #
1197 # @value: maximum speed in bytes.
1198 #
1199 # Returns: nothing on success
1200 #
1201 # Notes: A value lesser than zero will be automatically round up to zero.
1202 #
1203 # Since: 0.14.0
1204 ##
1205 { 'command': 'migrate_set_speed', 'data': {'value': 'int'} }
1206
1207 ##
1208 # @DevicePropertyInfo:
1209 #
1210 # @name: the name of the property
1211 #
1212 # @type: the type of the property.  This will typically come in one of four
1213 #        forms:
1214 #
1215 #        1) A primitive type such as 'u8', 'u16', 'bool', 'str', or 'double'.
1216 #           These types are mapped to the appropriate JSON type.
1217 #
1218 #        2) A legacy type in the form 'legacy<subtype>' where subtype is the
1219 #           legacy qdev typename.  These types are always treated as strings.
1220 #
1221 #        3) A child type in the form 'child<subtype>' where subtype is a qdev
1222 #           device type name.  Child properties create the composition tree.
1223 #
1224 #        4) A link type in the form 'link<subtype>' where subtype is a qdev
1225 #           device type name.  Link properties form the device model graph.
1226 #
1227 # Since: 1.1
1228 #
1229 # Notes: This type is experimental.  Its syntax may change in future releases.
1230 ##
1231 { 'type': 'DevicePropertyInfo',
1232   'data': { 'name': 'str', 'type': 'str' } }
1233
1234 ##
1235 # @qom-list:
1236 #
1237 # This command will list any properties of a device given a path in the device
1238 # model.
1239 #
1240 # @path: the path within the device model.  See @qom-get for a description of
1241 #        this parameter.
1242 #
1243 # Returns: a list of @DevicePropertyInfo that describe the properties of the
1244 #          device.
1245 #
1246 # Since: 1.1
1247 #
1248 # Notes: This command is experimental.  It's syntax may change in future
1249 #        releases.
1250 ##
1251 { 'command': 'qom-list',
1252   'data': { 'path': 'str' },
1253   'returns': [ 'DevicePropertyInfo' ] }
1254
1255 ##
1256 # @qom-get:
1257 #
1258 # This command will get a property from a device model path and return the
1259 # value.
1260 #
1261 # @path: The path within the device model.  There are two forms of supported
1262 #        paths--absolute and partial paths.
1263 #
1264 #        Absolute paths are derived from the root device and can follow child<>
1265 #        or link<> properties.  Since they can follow link<> properties, they
1266 #        can be arbitrarily long.  Absolute paths look like absolute filenames
1267 #        and are prefixed  with a leading slash.
1268 #
1269 #        Partial paths look like relative filenames.  They do not begin
1270 #        with a prefix.  The matching rules for partial paths are subtle but
1271 #        designed to make specifying devices easy.  At each level of the
1272 #        composition tree, the partial path is matched as an absolute path.
1273 #        The first match is not returned.  At least two matches are searched
1274 #        for.  A successful result is only returned if only one match is
1275 #        found.  If more than one match is found, a flag is return to
1276 #        indicate that the match was ambiguous.
1277 #
1278 # @property: The property name to read
1279 #
1280 # Returns: The property value.  The type depends on the property type.  legacy<>
1281 #          properties are returned as #str.  child<> and link<> properties are
1282 #          returns as #str pathnames.  All integer property types (u8, u16, etc)
1283 #          are returned as #int.
1284 #
1285 # Since: 1.1
1286 #
1287 # Notes: This command is experimental and may change syntax in future releases.
1288 ##
1289 { 'command': 'qom-get',
1290   'data': { 'path': 'str', 'property': 'str' },
1291   'returns': 'visitor',
1292   'gen': 'no' }
1293
1294 ##
1295 # @qom-set:
1296 #
1297 # This command will set a property from a device model path.
1298 #
1299 # @path: see @qom-get for a description of this parameter
1300 #
1301 # @property: the property name to set
1302 #
1303 # @value: a value who's type is appropriate for the property type.  See @qom-get
1304 #         for a description of type mapping.
1305 #
1306 # Since: 1.1
1307 #
1308 # Notes: This command is experimental and may change syntax in future releases.
1309 ##
1310 { 'command': 'qom-set',
1311   'data': { 'path': 'str', 'property': 'str', 'value': 'visitor' },
1312   'gen': 'no' }
1313
1314 ##
1315 # @set_password:
1316 #
1317 # Sets the password of a remote display session.
1318 #
1319 # @protocol: `vnc' to modify the VNC server password
1320 #            `spice' to modify the Spice server password
1321 #
1322 # @password: the new password
1323 #
1324 # @connected: #optional how to handle existing clients when changing the
1325 #                       password.  If nothing is specified, defaults to `keep' 
1326 #                       `fail' to fail the command if clients are connected
1327 #                       `disconnect' to disconnect existing clients
1328 #                       `keep' to maintain existing clients
1329 #
1330 # Returns: Nothing on success
1331 #          If Spice is not enabled, DeviceNotFound
1332 #          If @protocol does not support connected, InvalidParameter
1333 #          If @protocol is invalid, InvalidParameter
1334 #          If any other error occurs, SetPasswdFailed
1335 #
1336 # Notes: If VNC is not enabled, SetPasswdFailed is returned.
1337 #
1338 # Since: 0.14.0
1339 ##
1340 { 'command': 'set_password',
1341   'data': {'protocol': 'str', 'password': 'str', '*connected': 'str'} }
1342
1343 ##
1344 # @expire_password:
1345 #
1346 # Expire the password of a remote display server.
1347 #
1348 # @protocol: the name of the remote display protocol `vnc' or `spice'
1349 #
1350 # @time: when to expire the password.
1351 #        `now' to expire the password immediately
1352 #        `never' to cancel password expiration
1353 #        `+INT' where INT is the number of seconds from now (integer)
1354 #        `INT' where INT is the absolute time in seconds
1355 #
1356 # Returns: Nothing on success
1357 #          If @protocol is `spice' and Spice is not active, DeviceNotFound
1358 #          If an error occurs setting password expiration, SetPasswdFailed
1359 #          If @protocol is not `spice' or 'vnc', InvalidParameter
1360 #
1361 # Since: 0.14.0
1362 #
1363 # Notes: Time is relative to the server and currently there is no way to
1364 #        coordinate server time with client time.  It is not recommended to
1365 #        use the absolute time version of the @time parameter unless you're
1366 #        sure you are on the same machine as the QEMU instance.
1367 ##
1368 { 'command': 'expire_password', 'data': {'protocol': 'str', 'time': 'str'} }
1369
1370 ##
1371 # @eject:
1372 #
1373 # Ejects a device from a removable drive.
1374 #
1375 # @device:  The name of the device
1376 #
1377 # @force:   @optional If true, eject regardless of whether the drive is locked.
1378 #           If not specified, the default value is false.
1379 #
1380 # Returns:  Nothing on success
1381 #           If @device is not a valid block device, DeviceNotFound
1382 #           If @device is not removable and @force is false, DeviceNotRemovable
1383 #           If @force is false and @device is locked, DeviceLocked
1384 #
1385 # Notes:    Ejecting a device will no media results in success
1386 #
1387 # Since: 0.14.0
1388 ##
1389 { 'command': 'eject', 'data': {'device': 'str', '*force': 'bool'} }
1390
1391 ##
1392 # @change-vnc-password:
1393 #
1394 # Change the VNC server password.
1395 #
1396 # @target:  the new password to use with VNC authentication
1397 #
1398 # Since: 1.1
1399 #
1400 # Notes:  An empty password in this command will set the password to the empty
1401 #         string.  Existing clients are unaffected by executing this command.
1402 ##
1403 { 'command': 'change-vnc-password', 'data': {'password': 'str'} }
1404
1405 ##
1406 # @change:
1407 #
1408 # This command is multiple commands multiplexed together.
1409 #
1410 # @device: This is normally the name of a block device but it may also be 'vnc'.
1411 #          when it's 'vnc', then sub command depends on @target
1412 #
1413 # @target: If @device is a block device, then this is the new filename.
1414 #          If @device is 'vnc', then if the value 'password' selects the vnc
1415 #          change password command.   Otherwise, this specifies a new server URI
1416 #          address to listen to for VNC connections.
1417 #
1418 # @arg:    If @device is a block device, then this is an optional format to open
1419 #          the device with.
1420 #          If @device is 'vnc' and @target is 'password', this is the new VNC
1421 #          password to set.  If this argument is an empty string, then no future
1422 #          logins will be allowed.
1423 #
1424 # Returns: Nothing on success.
1425 #          If @device is not a valid block device, DeviceNotFound
1426 #          If @format is not a valid block format, InvalidBlockFormat
1427 #          If the new block device is encrypted, DeviceEncrypted.  Note that
1428 #          if this error is returned, the device has been opened successfully
1429 #          and an additional call to @block_passwd is required to set the
1430 #          device's password.  The behavior of reads and writes to the block
1431 #          device between when these calls are executed is undefined.
1432 #
1433 # Notes:  It is strongly recommended that this interface is not used especially
1434 #         for changing block devices.
1435 #
1436 # Since: 0.14.0
1437 ##
1438 { 'command': 'change',
1439   'data': {'device': 'str', 'target': 'str', '*arg': 'str'} }
1440
1441 ##
1442 # @block_set_io_throttle:
1443 #
1444 # Change I/O throttle limits for a block drive.
1445 #
1446 # @device: The name of the device
1447 #
1448 # @bps: total throughput limit in bytes per second
1449 #
1450 # @bps_rd: read throughput limit in bytes per second
1451 #
1452 # @bps_wr: write throughput limit in bytes per second
1453 #
1454 # @iops: total I/O operations per second
1455 #
1456 # @ops_rd: read I/O operations per second
1457 #
1458 # @iops_wr: write I/O operations per second
1459 #
1460 # Returns: Nothing on success
1461 #          If @device is not a valid block device, DeviceNotFound
1462 #          If the argument combination is invalid, InvalidParameterCombination
1463 #
1464 # Since: 1.1
1465 ## 
1466 { 'command': 'block_set_io_throttle',
1467   'data': { 'device': 'str', 'bps': 'int', 'bps_rd': 'int', 'bps_wr': 'int',
1468             'iops': 'int', 'iops_rd': 'int', 'iops_wr': 'int' } }
1469
1470 # @block_stream:
1471 #
1472 # Copy data from a backing file into a block device.
1473 #
1474 # The block streaming operation is performed in the background until the entire
1475 # backing file has been copied.  This command returns immediately once streaming
1476 # has started.  The status of ongoing block streaming operations can be checked
1477 # with query-block-jobs.  The operation can be stopped before it has completed
1478 # using the block_job_cancel command.
1479 #
1480 # If a base file is specified then sectors are not copied from that base file and
1481 # its backing chain.  When streaming completes the image file will have the base
1482 # file as its backing file.  This can be used to stream a subset of the backing
1483 # file chain instead of flattening the entire image.
1484 #
1485 # On successful completion the image file is updated to drop the backing file
1486 # and the BLOCK_JOB_COMPLETED event is emitted.
1487 #
1488 # @device: the device name
1489 #
1490 # @base:   #optional the common backing file name
1491 #
1492 # Returns: Nothing on success
1493 #          If streaming is already active on this device, DeviceInUse
1494 #          If @device does not exist, DeviceNotFound
1495 #          If image streaming is not supported by this device, NotSupported
1496 #          If @base does not exist, BaseNotFound
1497 #
1498 # Since: 1.1
1499 ##
1500 { 'command': 'block_stream', 'data': { 'device': 'str', '*base': 'str' } }
1501
1502 ##
1503 # @block_job_set_speed:
1504 #
1505 # Set maximum speed for a background block operation.
1506 #
1507 # This command can only be issued when there is an active block job.
1508 #
1509 # Throttling can be disabled by setting the speed to 0.
1510 #
1511 # @device: the device name
1512 #
1513 # @value:  the maximum speed, in bytes per second
1514 #
1515 # Returns: Nothing on success
1516 #          If the job type does not support throttling, NotSupported
1517 #          If streaming is not active on this device, DeviceNotActive
1518 #
1519 # Since: 1.1
1520 ##
1521 { 'command': 'block_job_set_speed',
1522   'data': { 'device': 'str', 'value': 'int' } }
1523
1524 ##
1525 # @block_job_cancel:
1526 #
1527 # Stop an active block streaming operation.
1528 #
1529 # This command returns immediately after marking the active block streaming
1530 # operation for cancellation.  It is an error to call this command if no
1531 # operation is in progress.
1532 #
1533 # The operation will cancel as soon as possible and then emit the
1534 # BLOCK_JOB_CANCELLED event.  Before that happens the job is still visible when
1535 # enumerated using query-block-jobs.
1536 #
1537 # The image file retains its backing file unless the streaming operation happens
1538 # to complete just as it is being cancelled.
1539 #
1540 # A new block streaming operation can be started at a later time to finish
1541 # copying all data from the backing file.
1542 #
1543 # @device: the device name
1544 #
1545 # Returns: Nothing on success
1546 #          If streaming is not active on this device, DeviceNotActive
1547 #          If cancellation already in progress, DeviceInUse
1548 #
1549 # Since: 1.1
1550 ##
1551 { 'command': 'block_job_cancel', 'data': { 'device': 'str' } }