[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Qemu-devel] [RFC][PATCH v2 00/10] virtagent: host/guest RPC communicati
From: |
Michael Roth |
Subject: |
[Qemu-devel] [RFC][PATCH v2 00/10] virtagent: host/guest RPC communication agent |
Date: |
Wed, 3 Nov 2010 06:35:29 -0500 |
This set of patches is meant to be applied on top of the Virtproxy v1 patchset,
which was submitted a couple weeks ago and can also be obtained at:
git://repo.or.cz/qemu/mdroth.git virtproxy_v1
OVERVIEW:
There are a wide range of use cases motivating the need for a guest agent of
some sort to extend the functionality/usability/control offered by QEMU. Some
examples include graceful guest shutdown/reboot and notifications thereof,
copy/paste syncing between host/guest, guest statistics gathering, file access,
etc.
Ideally these would all be served by a single, easilly extensible agent that
can be deployed in a wide range of guests. Virtagent is an XMLRPC server
integrated into the Virtproxy guest daemon and aimed at providing this type of
functionality.
CHANGES IN V2:
- All RPC communication is now done using asynchronous/non-blocking read/write
handlers
- Previously fork()'d RPC server loop is now integrated into qemu-vp/virtproxy
i/o loop
- Cleanups/suggestions from previous RFC
DESIGN:
There are actually 2 RPC servers:
1) a server in the guest integrated into the Virtproxy guest daemon which
handles RPC requests from QEMU
2) a server in the host (integrated into the Virtproxy host daemon, which we
plan to integrate directly into qemu) to handle RPC requests sent by the guest
agent (mainly for handling asynchronous events reported by the agent).
At the Virtagent level, communication is done via standard RPCs (HTTP between
host and guest). Virtproxy transparently handles transport over a network or
isa/virtio serial channel, allowing the agent to be deployed on older guests
which may not support virtio-serial.
Currently there are only 2 RPCs implemented for the guest server (getfile and
getdmesg), and 0 for the host. Additional RPCs can be added fairly easily, but
are dependent on feedback from here and elsewhere. ping/status, shutdown, and
reboot are likely candidates (although the latter 2 will likely require
asynchronous notifications to the host RPC server to implement reliably).
EXAMPLE USAGE:
The commandline options are a little convoluted right now; this will addressed
in later revisions.
- Configure guest agent to talk to host via virtio-serial
# start guest with virtio-serial. for example (RHEL6s13):
qemu \
-device virtio-serial \
-chardev socket,path=/tmp/test0-virtioconsole.sock,server,nowait,id=test0 \
-device virtconsole,chardev=test0,name=test0 \
-chardev socket,path=/tmp/test1-virtio-serial.sock,server,nowait,id=test1 \
-device virtserialport,chardev=test1,name=test1 \
-chardev socket,path=/tmp/test2-virtio-serial.sock,server,nowait,id=test2 \
-device virtserialport,chardev=test2,name=test2 \
-monitor stdio
...
# in the host:
./qemu-vp -c unix-connect:/tmp/test2-virtio-serial.sock:- \
-o virtagent:/tmp/virtagent-guest-client.sock:-
# in the guest:
./qemu-vp -c virtserial-open:/dev/virtio-ports/test2:- -g
...
# monitor commands
(qemu) agent_viewdmesg
[139311.710326] wlan0: deauthenticating from 00:30:bd:f7:12:d5 by local
choice (reason=3)
[139323.469857] wlan0: deauthenticating from 00:21:29:cd:41:ee by local
choice (reason=3)
...
[257683.375646] wlan0: authenticated
[257683.375684] wlan0: associate with AP 00:30:bd:f7:12:d5 (try 1)
[257683.377932] wlan0: RX AssocResp from 00:30:bd:f7:12:d5 (capab=0x411
status=0 aid=4)
[257683.377940] wlan0: associated
(qemu) agent_viewfile /proc/meminfo
MemTotal: 3985488 kB
MemFree: 400524 kB
Buffers: 220556 kB
Cached: 2073160 kB
SwapCached: 0 kB
...
Hugepagesize: 2048 kB
DirectMap4k: 8896 kB
DirectMap2M: 4110336 kB
KNOWN ISSUES/PLANS:
- the client socket that qemu connects to send RPCs is a hardcoded filepath.
This is unacceptable as the socket is channel/process specific and things will
break when multiple guests are started.
- capability negotiation will be needed to handle version/architecture
differences.
- proper channel negotiation is needed to avoid hung monitors and such when a
guest reboots or the guest agent is stopped for whatever reason. additionally,
a timeout may need to be imposed on the amount of time the http read handler
can block the monitor.
- additional host-to-guest RPCs as well as asynchronous notifications via
guest-to-host RPCs for events such as shutdown/reboot/agent up/agent down
Makefile | 2 +-
Makefile.target | 2 +-
configure | 25 +++
hmp-commands.hx | 32 ++++
monitor.c | 1 +
qemu-vp.c | 115 +++++++++++++-
qerror.c | 4 +
qerror.h | 3 +
qmp-commands.hx | 68 ++++++++
virtagent-common.c | 431 +++++++++++++++++++++++++++++++++++++++++++++++++++
virtagent-common.h | 73 +++++++++
virtagent-daemon.c | 253 ++++++++++++++++++++++++++++++
virtagent-daemon.h | 21 +++
virtagent.c | 286 ++++++++++++++++++++++++++++++++++
virtagent.h | 32 ++++
virtproxy-builtin.c | 30 ++++
16 files changed, 1367 insertions(+), 11 deletions(-)
- [Qemu-devel] [RFC][PATCH v2 00/10] virtagent: host/guest RPC communication agent,
Michael Roth <=
- [Qemu-devel] [RFC][PATCH v2 04/10] virtagent: base RPC client definitions, Michael Roth, 2010/11/03
- [Qemu-devel] [RFC][PATCH v2 01/10] virtagent: add common rpc transport defs, Michael Roth, 2010/11/03
- [Qemu-devel] [RFC][PATCH v2 05/10] virtagent: add getfile RPC, Michael Roth, 2010/11/03
- [Qemu-devel] [RFC][PATCH v2 09/10] virtagent: Makefile/configure changes to build virtagent bits, Michael Roth, 2010/11/03
- [Qemu-devel] [RFC][PATCH v2 07/10] virtagent: add getdmesg RPC, Michael Roth, 2010/11/03
- [Qemu-devel] [RFC][PATCH v2 06/10] virtagent: add agent_viewfile command, Michael Roth, 2010/11/03
- [Qemu-devel] [RFC][PATCH v2 02/10] virtagent: base definitions for host/guest RPC daemon, Michael Roth, 2010/11/03
- [Qemu-devel] [RFC][PATCH v2 08/10] virtagent: add agent_viewdmesg command, Michael Roth, 2010/11/03
- [Qemu-devel] [RFC][PATCH v2 10/10] virtproxy: add compat defs for linking against vl.c, Michael Roth, 2010/11/03
- [Qemu-devel] [RFC][PATCH v2 03/10] virtagent: qemu-vp, integrate virtagent server, Michael Roth, 2010/11/03