2011-09-02 12:34:47 -05:00
|
|
|
# -*- Mode: Python -*-
|
2020-07-29 20:50:24 +02:00
|
|
|
# vim: filetype=python
|
2015-07-06 22:13:50 +02:00
|
|
|
##
|
|
|
|
|
# = Introduction
|
2011-09-02 12:34:47 -05:00
|
|
|
#
|
2015-07-06 22:13:50 +02:00
|
|
|
# This document describes all commands currently supported by QMP.
|
|
|
|
|
#
|
|
|
|
|
# Most of the time their usage is exactly the same as in the user Monitor, this
|
|
|
|
|
# means that any other document which also describe commands (the manpage,
|
|
|
|
|
# QEMU's manual, etc) can and should be consulted.
|
|
|
|
|
#
|
|
|
|
|
# QMP has two types of commands: regular and query commands. Regular commands
|
|
|
|
|
# usually change the Virtual Machine's state someway, while query commands just
|
|
|
|
|
# return information. The sections below are divided accordingly.
|
|
|
|
|
#
|
|
|
|
|
# It's important to observe that all communication examples are formatted in
|
|
|
|
|
# a reader-friendly way, so that they're easier to understand. However, in real
|
|
|
|
|
# protocol usage, they're emitted as a single line.
|
|
|
|
|
#
|
|
|
|
|
# Also, the following notation is used to denote data flow:
|
|
|
|
|
#
|
|
|
|
|
# Example:
|
|
|
|
|
#
|
2020-09-25 17:23:05 +01:00
|
|
|
# ::
|
|
|
|
|
#
|
|
|
|
|
# -> data issued by the Client
|
|
|
|
|
# <- Server data response
|
2015-07-06 22:13:50 +02:00
|
|
|
#
|
2017-07-28 19:46:01 -03:00
|
|
|
# Please, refer to the QMP specification (docs/interop/qmp-spec.txt) for
|
2015-07-06 22:13:50 +02:00
|
|
|
# detailed information on the Server command and response formats.
|
|
|
|
|
#
|
|
|
|
|
# = Stability Considerations
|
|
|
|
|
#
|
|
|
|
|
# The current QMP command set (described in this file) may be useful for a
|
|
|
|
|
# number of use cases, however it's limited and several commands have bad
|
|
|
|
|
# defined semantics, specially with regard to command completion.
|
|
|
|
|
#
|
|
|
|
|
# These problems are going to be solved incrementally in the next QEMU releases
|
|
|
|
|
# and we're going to establish a deprecation policy for badly defined commands.
|
|
|
|
|
#
|
|
|
|
|
# If you're planning to adopt QMP, please observe the following:
|
|
|
|
|
#
|
|
|
|
|
# 1. The deprecation policy will take effect and be documented soon, please
|
|
|
|
|
# check the documentation of each used command as soon as a new release of
|
|
|
|
|
# QEMU is available
|
|
|
|
|
#
|
|
|
|
|
# 2. DO NOT rely on anything which is not explicit documented
|
|
|
|
|
#
|
|
|
|
|
# 3. Errors, in special, are not documented. Applications should NOT check
|
|
|
|
|
# for specific errors classes or data (it's strongly recommended to only
|
|
|
|
|
# check for the "error" key)
|
|
|
|
|
#
|
|
|
|
|
##
|
2011-09-02 12:34:48 -05:00
|
|
|
|
2020-02-24 15:30:03 +01:00
|
|
|
{ 'include': 'pragma.json' }
|
2017-03-15 13:56:54 +01:00
|
|
|
|
2018-02-26 13:48:58 -06:00
|
|
|
# Documentation generated with qapi-gen.py is in source order, with
|
2017-08-24 21:13:53 +02:00
|
|
|
# included sub-schemas inserted at the first include directive
|
|
|
|
|
# (subsequent include directives have no effect). To get a sane and
|
|
|
|
|
# stable order, it's best to include each sub-schema just once, or
|
2018-02-11 10:36:05 +01:00
|
|
|
# include it first right here.
|
2017-08-24 21:13:53 +02:00
|
|
|
|
2019-08-12 07:23:33 +02:00
|
|
|
{ 'include': 'error.json' }
|
2018-02-11 10:36:05 +01:00
|
|
|
{ 'include': 'common.json' }
|
|
|
|
|
{ 'include': 'sockets.json' }
|
|
|
|
|
{ 'include': 'run-state.json' }
|
|
|
|
|
{ 'include': 'crypto.json' }
|
|
|
|
|
{ 'include': 'block.json' }
|
2020-09-24 17:26:48 +02:00
|
|
|
{ 'include': 'block-export.json' }
|
2018-02-11 10:36:05 +01:00
|
|
|
{ 'include': 'char.json' }
|
2019-06-19 22:10:47 +02:00
|
|
|
{ 'include': 'dump.json' }
|
2018-05-16 16:03:10 +02:00
|
|
|
{ 'include': 'job.json' }
|
2018-02-11 10:36:05 +01:00
|
|
|
{ 'include': 'net.json' }
|
2018-12-21 16:40:24 +02:00
|
|
|
{ 'include': 'rdma.json' }
|
2018-02-11 10:36:05 +01:00
|
|
|
{ 'include': 'rocker.json' }
|
|
|
|
|
{ 'include': 'tpm.json' }
|
|
|
|
|
{ 'include': 'ui.json' }
|
2015-10-21 14:54:59 +01:00
|
|
|
{ 'include': 'authz.json' }
|
2018-02-11 10:36:05 +01:00
|
|
|
{ 'include': 'migration.json' }
|
|
|
|
|
{ 'include': 'transaction.json' }
|
|
|
|
|
{ 'include': 'trace.json' }
|
2021-03-18 16:55:10 +01:00
|
|
|
{ 'include': 'compat.json' }
|
2020-01-29 11:22:37 +01:00
|
|
|
{ 'include': 'control.json' }
|
2018-02-11 10:36:05 +01:00
|
|
|
{ 'include': 'introspect.json' }
|
2019-06-19 22:10:37 +02:00
|
|
|
{ 'include': 'qom.json' }
|
|
|
|
|
{ 'include': 'qdev.json' }
|
2019-06-19 22:10:41 +02:00
|
|
|
{ 'include': 'machine.json' }
|
2019-06-19 22:10:45 +02:00
|
|
|
{ 'include': 'machine-target.json' }
|
2020-10-03 20:13:14 +03:00
|
|
|
{ 'include': 'replay.json' }
|
2020-12-28 16:08:41 +01:00
|
|
|
{ 'include': 'yank.json' }
|
2018-02-11 10:36:05 +01:00
|
|
|
{ 'include': 'misc.json' }
|
2019-06-19 22:10:46 +02:00
|
|
|
{ 'include': 'misc-target.json' }
|
2019-03-08 23:34:12 +01:00
|
|
|
{ 'include': 'audio.json' }
|
2020-09-13 21:53:47 +02:00
|
|
|
{ 'include': 'acpi.json' }
|
2020-09-13 21:53:48 +02:00
|
|
|
{ 'include': 'pci.json' }
|
2022-02-15 09:04:31 -06:00
|
|
|
{ 'include': 'stats.json' }
|
2022-08-11 08:24:39 -04:00
|
|
|
{ 'include': 'virtio.json' }
|