summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorChristophe Fergeau <cfergeau@gmail.com>2011-04-01 12:40:20 +0200
committerHans de Goede <hdegoede@redhat.com>2011-04-04 13:42:06 +0200
commita85f799463c0141f025c7dba2ea0085d3ae8e582 (patch)
treecb5674f20bba63bb47b539196626fa073911a61e
parentab98e1667e7cd8b673563ff22fdbaf41524d51d9 (diff)
README: Add qemu commandline options for vdagent
It's not obvious how qemu should be started so that vdagentd can find its com.redhat.spice.0 virtio device. It's explained at http://spice-space.org/page/Whiteboard/AgentProtocol but is easier to find if it's explained in README too.
-rw-r--r--README22
1 files changed, 22 insertions, 0 deletions
diff --git a/README b/README
index ad40b3a..40957f3 100644
--- a/README
+++ b/README
@@ -22,6 +22,28 @@ Features:
Not handled: multiple displays.
+
+All vdagent communications on the guest side run over a single pipe which
+gets presented to the guest os as a virtio serial port.
+
+Under windows this virtio serial port has the following name:
+\\\\.\\Global\\com.redhat.spice.0
+
+Under Linux this virtio serial port has the following name:
+/dev/virtio-ports/com.redhat.spice.0
+
+To enable the virtio serial port you need to pass the following params on
+the qemu cmdline:
+
+For qemu < 0.14.0:
+-device spicevmc
+
+For qemu >= 0.14.0:
+-device virtio-serial-pci,id=virtio-serial0,max_ports=16,bus=pci.0,addr=0x5 \
+-chardev spicevmc,name=vdagent,id=vdagent \
+-device \
+virtserialport,nr=1,bus=virtio-serial0.0,chardev=vdagent,name=com.redhat.spice.0
+
Enjoy,
Gerd & Hans