summaryrefslogtreecommitdiffstats
path: root/docs/manual/SpiceUserManual-Guest.xml
blob: 6648f8310f6d809b218ed1095db6446a2657147f (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
<?xml version="1.0" encoding="UTF-8"?>
<?oxygen RNGSchema="http://www.oasis-open.org/docbook/xml/5.0/rng/docbookxi.rng" type="xml"?>

<chapter xmlns="http://docbook.org/ns/docbook" 
    xmlns:xi="http://www.w3.org/2001/XInclude"
    xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0">
    <title>Spice Guest Additions</title>

    <section xml:id="generic-guest">
        <title>Introduction</title>
        <para>
            While you will be able to remotely access your virtual machine
            through Spice without making any change to the virtual machine
            configuration, you can get better integration if you tweak it
            specially for Spice.
        </para>
        <para>
            If your virtual machine has a QXL video device and you install
            the corrresponding guest driver, your guest will support higher
            resolutions, multiple monitors, resizing to arbitrary resolutions,
            ...
        </para>
        <para>
            Installing the Spice vdagent in your guest will let you copy and
            paste between your guest and client OSes, to drag and drop files
            between the 2 OSes, ... In order for the agent to work, your
            virtual machine must have a virtio serial device (and the
            corresponding guest drivers) as well as a Spice spicevmc channel.
        </para>
    </section>

    <section xml:id="windows-guest">
        <title>Windows Guest</title>
        <para>
            The recommended way of getting all the needed drivers installed is
            to use the all-in-one Spice guest tools installer which can be
            found <link xlink:href="http://spice-space.org/download/windows/spice-guest-tools/">
            on spice-space.org</link>.
        </para>
        <para>
            To get USB redirection working on Windows, you need to ...
        </para>
        <para>
            If you want to manually install them, the QXL driver can be downloaded from
            <link xlink:href="http://spice-space.org/download/windows/qxl/">this location
            </link>, agent builds can be found
            <link xlink:href="http://spice-space.org/download/windows/vdagent/">here
            </link>. You also need the vioserial driver which is distributed with the
            other <link xlink:href="https://alt.fedoraproject.org/pub/alt/virtio-win/latest/images/bin/">
            virtio-win drivers</link>.
        </para>
    </section>

</chapter>