[Spice-commits] docs/manual

Christophe Fergau teuf at kemper.freedesktop.org
Thu Mar 24 12:57:43 UTC 2016

 docs/manual/manual.txt |   56 +++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 56 insertions(+)

New commits:
commit 782c7508e28fdeee786cdcebffd22f772d7f09ec
Author: Christophe Fergeau <cfergeau at redhat.com>
Date:   Thu Mar 17 12:24:33 2016 +0100

    doc: Add virgl documentation
    Document how to use virgl with QEMU/libvirt
    virt-manager documentation still needs to be added.

diff --git a/docs/manual/manual.txt b/docs/manual/manual.txt
index 2c0035a..a1c057c 100644
--- a/docs/manual/manual.txt
+++ b/docs/manual/manual.txt
@@ -901,6 +901,62 @@ folder will show up in GNOME Files network places (or Nautilus). It
 can then be mounted and browsed in traditional applications thanks to
+GL acceleration (virgl)
+OpenGL acceleration is currently local only (it has to go through a Unix socket)
+and it needs guest support. It's currently limited to recent linux
+distributions (for example up to date Fedora 23 + updated mesa packages from
+.Using libvirt
+You need to add a virtio-gpu video device to your virtual machine instead of QXL.
+  <model type='virtio' heads='1'>
+    <acceleration accel3d='yes'/>
+  </model>
+Then you need to enable OpenGL on your SPICE graphics node:
+<graphics type='spice' autoport='no'>
+  <gl enable='yes'/>
+You don't need any port/address as they won't be usable with
+.Using QEMU
+You need to add a virtio-gpu device on QEMU command line,
+as well as enable GL with SPICE. port/tls-port/addr arguments
+won't be used in this setup. You need to configure a Unix socket to
+connect to the VM display.
+-device virtio-vga,virgl=on -spice gl=on,unix,addr=/run/user/1000/spice.sock
+Connecting to the guest
+Connecting to the guest when virgl is in use is slightly different
+than usual
+.If libvirt is being used
+client$ virt-viewer -a $vmname
+.If a Unix socket has been set on QEMU command line
+client$ remote-viewer spice+unix:///run/user/1000/spice.sock
 QEMU Spice reference

More information about the Spice-commits mailing list