OVERVIEW:
Virtproxy proxies and multiplexes socket streams over a data channel between a
host and a guest (currently network connections, emulated serial, or
virtio-serial channels are supported). This allows for services such as guest
data collection agents, host/guest file transfer, and event generation/handling
to be implemented/deployed as basic socket-based daemons, independently of the
actual data channel.
This code is intended to provide a channel-independent abstraction layer for
communicating with a QEMU-specific guest agent (in particular, the virtagent
RPC guest agent which will follow this in a seperate patchset), but may have
general utility beyond this (for instance: ssh/sftp/other guest agents/etc over
isa/virtio serial), and so is submitted here as a seperate patchset.
CHANGES IN V2:
- host daemon deprecated, virtproxy now integrated into qemu via a virtproxy
chardev. The command-line options have not yet been converted over so for now
the virtproxy layer is no longer testable directly. This will be addressed
soon. Virtagent will hook into this chardev via a boolean chardev option. That
patchset will follow this one shortly.
- deadlocking issue resolved
BUILD/USAGE INFO:
# build guest daemon
make qemu-vp
./qemu-vp -h
EXAMPLE USAGE:
note: oforward/iforward chardev options have not yet been converted over from
original standalone host daemon implementation so this won't work till then.
The examples however have been updated for reference.
- Proxy http and ssh connections from a host to a guest over a virtio-serial
connection:
# start guest with virtio-serial. for example (RHEL6s13):
qemu \
-device virtio-serial \
-chardev virtproxy,id=test0, \
oforward=http:127.0.0.1:9080,oforward=ssh:127.0.0.1:22 \
-device virtconsole,chardev=test0,name=test0 \