Skip to content

RFC QEMU Monitor Protocol

Luiz Capitulino qemu-devel 1 version New

Get series with b4
b4 am 20090623012755.7cade792@doriath

Versions newest first

  1. v1 RFC Latest0 of 11 patches 0 repliesNew

Patches in v1 No applies recorded yet

None of the 11 patches the cover letter announces are in this archive.

Reviews trailers per patch

No Reviewed-by, Acked-by or Tested-by trailers for v1 yet.

Read the v1 thread

Cover letter [Qemu-devel] [RFC 00/11] QEMU Monitor Protocol

Hi there,

It is already known that QEMU does not provide a way for applications to control it at the "machine level", that is, the current Monitor interface was designed with human interaction in mind.

This problem has already been discussed at least twice, the last thead on the topic can be found here:

http://lists.gnu.org/archive/html/qemu-devel/2009-01/msg00655.html

Basically, some people have suggested to export Monitor's functionality through a C library, while others have suggested a simple text protocol.

This patch series implements a prototype of the text protocol approach, which I called QEMU Monitor Protocol, or QMP.

I have chosen the text protocol because:

1. It is easier to implement
2. If needed, a C library can be built on top of it

QMP has the following features:

o Easy to be parsed by programs
o Extensible
o Asynchronous messages support

With this series I hope to get as much feedback as possible on the protocol specification and the implementation, and also have a merge plan.

To enable QMP one has to start QEMU with:

$ qemu [...] -monitor control,<device>

For example:

$ qemu [...] -monitor control,tcp:localhost:4444,server

Then the application can open a TCP connection to localhost:4444 and speak to QEMU using QMP.

A full protocol specification can be found (and discussed) in the first patch of this series.

Some additional comments:

o Don't take the implementation too serious, it is just a hac^W prototype

o Available commands: quit, cont, stop, system_reset, system_powerdown, balloon, info balloon, info blockstats

o Available events: reboot, shutdown, powerdown

Luiz Capitulino (11):
QMP: Introduce specification file
QMP: Introduce MONITOR_USE_CONTROL flag
QMP: Introduce protocol print functions
QMP: Make monitor_handle_command() QMP aware
QMP: Introduce control mode chardev handling
QMP: Introduce asynchronous events infrastructure
QMP: Enable simple commands
QMP: Port balloon command
QMP: Port 'info blockstats' command
QMP: Introduce basic events
QMP: Command-line flag to enable control mode

 block.c                   |   18 ++--
 monitor-protocol-spec.txt |  180 ++++++++++++++++++++++++++++++++++++++
 monitor.c                 |  211 +++++++++++++++++++++++++++++++++++++++++++-
 monitor.h                 |   14 +++
 qemu-tool.c               |   16 ++++
 vl.c                      |    8 ++-
 6 files changed, 431 insertions(+), 16 deletions(-)
 create mode 100644 monitor-protocol-spec.txt