[Spice-devel] [spice-server] doc: Add virgl documentation

[Cole Robinson]

On 03/24/2016 01:26 PM, Cole Robinson wrote:
> On 03/24/2016 01:08 PM, Christophe Fergeau wrote:
>> On Thu, Mar 24, 2016 at 12:59:04PM -0400, Cole Robinson wrote:
>>>> +Configuration
>>>> +-------------
>>>> +
>>>> +.Using libvirt
>>>> +
>>>> +You need to add a virtio-gpu video device to your virtual machine instead of QXL.
>>>> +[source,xml]
>>>> +<video>
>>>> +  <model type='virtio' heads='1'>
>>>> +    <acceleration accel3d='yes'/>
>>>> +  </model>
>>>> +</video>
>>>> +
>>>> +Then you need to enable OpenGL on your SPICE graphics node:
>>>> +[source,xml]
>>>> +<graphics type='spice' autoport='no'>
>>>> +  <gl enable='yes'/>
>>>> +</graphics>
>>>> +
>>>> +You don't need any port/address as they won't be usable with
>>>> +GL.
>>>> +
>>>
>>> But this in fact won't work because we are dependent on spice+unix socket
>>> bits, right? Which isn't implemented for libvirt yet and likely won't
>>> committed for 1.3.3 either.
>>>
>>> Even more, I feel like libvirt should reject a config like the above one
>>> because it's kinda meaningless... with default qemu.conf settings that's
>>> effectively listen=127.0.0.1 autoport=no which should raise an error since we
>>> have no port to specify.
>>
>> This works together with virt-viewer -a even without spice+unix socket
>> in libvirt (I tested this with libvirt.git)
>>
> 
> Oh interesting. I just tried it. That basically means spice isn't listening
> anywhere, and can only be accessed via virDomainOpenGraphics/add_client. I
> didn't realize that was an option! Things make more sense now :)

One bit here... it's still a little ambiguous from the libvirt XML
perspective. If we encounter autoport=no and no manual ports, maybe this
should turn into:

<spice ...>
  <listen type='none'/>
</spice>

to make it explicit. I'll file some bug(s) after playing with it some more

- Cole