Re: [spice-server 3/4] docs: Add documentation for the streaming device

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



Ping?

Christophe

On Fri, Jun 08, 2018 at 04:25:28PM +0200, Christophe Fergeau wrote:
> Signed-off-by: Christophe Fergeau <cfergeau@xxxxxxxxxx>
> ---
>  docs/manual/manual.txt | 51 ++++++++++++++++++++++++++++++++++++++++++
>  1 file changed, 51 insertions(+)
> 
> diff --git a/docs/manual/manual.txt b/docs/manual/manual.txt
> index 40d080d9f..b54c83cb0 100644
> --- a/docs/manual/manual.txt
> +++ b/docs/manual/manual.txt
> @@ -544,6 +544,57 @@ which are described when running remote-viewer with `--help-spice`.
>  To get USB redirection working on Windows clients, you need to install
>  http://www.spice-space.org/download/windows/usbdk/[UsbDk]
>  
> +[[streamingagent]]
> +Streaming Agent
> +===============
> +
> +The SPICE streaming agent allows to send an encoded video stream corresponding
> +to the guest desktop environment to the client.
> +
> +The streaming agent is a daemon/service running in the guest OS so it must be
> +installed if it was not installed by default during the guest OS
> +installation. It relies on a dedicated spiceport char device to achieve
> +communication between the guest and the host. This device must be added to
> +the virtual machine for the streaming agent to work in the guest.
> +
> +Configuration
> +-------------
> +
> +.Using virt-manager
> +
> +The needed device can be added from the virtual machine
> +details. Click on "Add hardware" and then add a "Channel" device with
> +type "Spice port (spiceport)". The port should be named
> +`org.spice-space.stream.0`, and the channel should also be
> +`org.spice-space.stream.0`.
> +
> +.Using libvirt
> +
> +Two distinct devices must be added:
> +
> +* http://libvirt.org/formatdomain.html#elementsControllers[a virtio serial
> +  device] if there is not one yet in the domain definition
> +* http://libvirt.org/formatdomain.html#elementsCharSpiceport[a spiceport channel]
> +
> +[source,xml]
> +<devices>
> +    <controller type='virtio-serial' index='0'/>
> +    <channel type='spiceport'>
> +        <source channel='org.spice-space.stream.0'/>
> +        <target type='virtio' name='org.spice-space.stream.0'/>
> +    </channel>
> +</devices>
> +
> +.Using QEMU
> +
> +Adding the following parameters to your QEMU command line will enable
> +the needed devices for agent support in the guest OS:
> +
> +[source,sh]
> +-device virtserialport,bus=virtio-serial0.0,nr=1,chardev=charchannel1,id=channel1,name=org.spice-space.stream.0 \
> +-chardev spiceport,name=org.spice-space.stream.0,id=charchannel1
> +
> +
>  CAC smartcard redirection
>  =========================
>  
> -- 
> 2.17.1
> 
> _______________________________________________
> Spice-devel mailing list
> Spice-devel@xxxxxxxxxxxxxxxxxxxxx
> https://lists.freedesktop.org/mailman/listinfo/spice-devel

Attachment: signature.asc
Description: PGP signature

_______________________________________________
Spice-devel mailing list
Spice-devel@xxxxxxxxxxxxxxxxxxxxx
https://lists.freedesktop.org/mailman/listinfo/spice-devel

[Index of Archives]     [Linux Virtualization]     [Linux Virtualization]     [Linux ARM Kernel]     [Linux ARM]     [Linux Omap]     [Fedora ARM]     [IETF Annouce]     [Security]     [Bugtraq]     [Linux OMAP]     [Linux MIPS]     [ECOS]     [Asterisk Internet PBX]     [Linux API]     [Monitors]