diff options
| author | Lubos Kocman <lkocman@luboskocman.com> | 2011-03-07 09:58:59 +0100 |
|---|---|---|
| committer | Lubos Kocman <lkocman@luboskocman.com> | 2011-03-07 09:58:59 +0100 |
| commit | cd2f54215fa2de63fe02b9b62afc143a97491b09 (patch) | |
| tree | 1dc150a1569ef6bbbcd7ecda7972bba6d0f4c445 | |
| parent | 33a6ed665fc49f2a1559e5dd55caaf2f4044044b (diff) | |
after weeekend
| -rw-r--r-- | books/docbook/SpiceUserManual-Basics.xml | 2 | ||||
| -rw-r--r-- | books/docbook/SpiceUserManual.xml | 2 | ||||
| -rw-r--r-- | books/docbook/chunks/ch01.html | 31 | ||||
| -rw-r--r-- | books/docbook/chunks/ch01s02.html | 25 | ||||
| -rw-r--r-- | books/docbook/chunks/ch02.html | 21 | ||||
| -rw-r--r-- | books/docbook/chunks/ch02s02.html | 65 | ||||
| -rw-r--r-- | books/docbook/chunks/ch03.html | 3 | ||||
| -rw-r--r-- | books/docbook/chunks/ch03s02.html | 25 | ||||
| -rw-r--r-- | books/docbook/chunks/ch04.html | 3 | ||||
| -rw-r--r-- | books/docbook/chunks/index.html | 6 | ||||
| -rw-r--r-- | books/html/ch01.html | 6 | ||||
| -rw-r--r-- | books/html/ch01s02.html | 2 | ||||
| -rw-r--r-- | books/html/ch02.html | 2 | ||||
| -rw-r--r-- | books/html/ch02s02.html | 2 | ||||
| -rw-r--r-- | books/html/ch03.html | 2 | ||||
| -rw-r--r-- | books/html/ch03s02.html | 11 | ||||
| -rw-r--r-- | books/html/ch04.html | 2 | ||||
| -rw-r--r-- | books/html/index.html | 4 | ||||
| -rw-r--r-- | books/pdf/SpiceUserManual.pdf | bin | 60139 -> 60139 bytes |
19 files changed, 21 insertions, 193 deletions
diff --git a/books/docbook/SpiceUserManual-Basics.xml b/books/docbook/SpiceUserManual-Basics.xml index d27e0d9..599b725 100644 --- a/books/docbook/SpiceUserManual-Basics.xml +++ b/books/docbook/SpiceUserManual-Basics.xml @@ -3,7 +3,7 @@ <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" id="basics"> + xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:id="basics"> <title>Spice basics</title> <section xml:id="definitions"> <title>Basic Definitions</title> diff --git a/books/docbook/SpiceUserManual.xml b/books/docbook/SpiceUserManual.xml index 6fd7698..1e32ade 100644 --- a/books/docbook/SpiceUserManual.xml +++ b/books/docbook/SpiceUserManual.xml @@ -41,7 +41,7 @@ <mediaobject> <imageobject> - <imagedata fileref="resources/pepper.png"> + <imagedata fileref="resources/pepper.png" format="png"> <info> <othercredit> <personname>Lubos Kocman</personname> diff --git a/books/docbook/chunks/ch01.html b/books/docbook/chunks/ch01.html deleted file mode 100644 index 700aa4b..0000000 --- a/books/docbook/chunks/ch01.html +++ /dev/null @@ -1,31 +0,0 @@ -<html><head> - <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> - <title>Chapter 1. Introduction</title><meta name="generator" content="DocBook XSL-NS Stylesheets V1.76.1"><link rel="home" href="index.html" title="Spice User Manual"><link rel="up" href="index.html" title="Spice User Manual"><link rel="prev" href="index.html" title="Spice User Manual"><link rel="next" href="ch01s02.html" title="Features"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter 1. Introduction</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="index.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="ch01s02.html">Next</a></td></tr></table><hr></div><div lang="" class="chapter" title="Chapter 1. Introduction"><div class="titlepage"><div><div><h2 class="title"><a name="d0e50"></a>Chapter 1. Introduction</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="ch01.html#d0e69">Spice and Spice-related Compoments</a></span></dt><dd><dl><dt><span class="section"><a href="ch01.html#spice_server">Spice Server</a></span></dt><dt><span class="section"><a href="ch01.html#spice_client">Spice Client</a></span></dt><dt><span class="section"><a href="ch01.html#d0e82">QXL Device and Drivers</a></span></dt><dt><span class="section"><a href="ch01.html#d0e87">VDI Port Device</a></span></dt><dt><span class="section"><a href="ch01.html#vdagent">Spice Agent</a></span></dt></dl></dd><dt><span class="section"><a href="ch01s02.html">Features</a></span></dt><dd><dl><dt><span class="section"><a href="ch01s02.html#multiple_channels">Multiple Channels</a></span></dt><dt><span class="section"><a href="ch01s02.html#image_compression">Image Compression</a></span></dt><dt><span class="section"><a href="ch01s02.html#video_compression">Video Compression</a></span></dt><dt><span class="section"><a href="ch01s02.html#mouse_modes">Mouse modes</a></span></dt><dt><span class="section"><a href="ch01s02.html#other_features">Other Features</a></span></dt></dl></dd></dl></div><p> - Spice is an open remote computing solution, providing client access to remote displays and devices (e.g. keyboard, mouse, audio). - Spice provides a desktop like user experience, while trying to offload most of the intensive CPU and GPU tasks to the client. - - The basic building blocks of Spice are: - </p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p><a class="link" href="ch01.html#spice_server" title="Spice Server">Spice Server</a></p></li><li class="listitem"><p><a class="link" href="ch01.html#spice_client" title="Spice Client">Spice CLient</a></p></li><li class="listitem"><p>Spice Protocol</p></li></ol></div><p> - The following sections provide basic iformation on Spice components and features, obtaining, building installing and using Spice. - </p><div class="section" title="Spice and Spice-related Compoments"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d0e69"></a>Spice and Spice-related Compoments</h2></div></div></div><div class="section" title="Spice Server"><div class="titlepage"><div><div><h3 class="title"><a name="spice_server"></a>Spice Server</h3></div></div></div><p> - Spice server is implemented in libspice, a VDI pluggable library. - Virtual Device Interface (VDI) defines a set of interfaces that provide a standard way to publish virtual devices (e.g. display device, keyboard, mouse) - and enables different Spice components to interact with those devices. - On one side, the server communicates with the remote client using the Spice protocol and on the other side, it interacts with the VDI host application (e.g QEMU). - </p></div><div class="section" title="Spice Client"><div class="titlepage"><div><div><h3 class="title"><a name="spice_client"></a>Spice Client</h3></div></div></div><p> - Spice cross-platform (Linux and Windows) client is the interface for the end user e.g. spicec or spicy. - </p></div><div class="section" title="QXL Device and Drivers"><div class="titlepage"><div><div><h3 class="title"><a name="d0e82"></a>QXL Device and Drivers</h3></div></div></div><p> - Spice server supports QXL VDI interface. When libspice is used with QEMU, a specific QEMU QXL PCI device can be used for improving - remote display performance and enhancing the graphic capabilities of the guest graphic system. - QXL device requires guest QXL drivers for full functionality. - However, standard VGA is supported when no driver exists. - </p></div><div class="section" title="VDI Port Device"><div class="titlepage"><div><div><h3 class="title"><a name="d0e87"></a>VDI Port Device</h3></div></div></div><p> - Spice protocol supports a communication channel between the client and the agent on the server side. - When using QEMU, Spice agent resides on the guest. VDI port is a QEMU PCI device used for communication with the agent. - </p></div><div class="section" title="Spice Agent"><div class="titlepage"><div><div><h3 class="title"><a name="vdagent"></a>Spice Agent</h3></div></div></div><p> - The Spice agent is an optional component for enhancing user experience and performing guest-oriented management tasks. - For example, the agent injects mouse position and state to the guest when using client mouse mode. It also enables you to - move cursor freely between guest and client. Other features of agent are shared clipboard and - aligning guest resolution with client while entering fullscreen mode. - - </p></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="index.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="ch01s02.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Spice User Manual </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Features</td></tr></table></div></body></html>
\ No newline at end of file diff --git a/books/docbook/chunks/ch01s02.html b/books/docbook/chunks/ch01s02.html deleted file mode 100644 index d6cc381..0000000 --- a/books/docbook/chunks/ch01s02.html +++ /dev/null @@ -1,25 +0,0 @@ -<html><head> - <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> - <title>Features</title><meta name="generator" content="DocBook XSL-NS Stylesheets V1.76.1"><link rel="home" href="index.html" title="Spice User Manual"><link rel="up" href="ch01.html" title="Chapter 1. Introduction"><link rel="prev" href="ch01.html" title="Chapter 1. Introduction"><link rel="next" href="ch02.html" title="Chapter 2. Installation"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Features</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch01.html">Prev</a> </td><th width="60%" align="center">Chapter 1. Introduction</th><td width="20%" align="right"> <a accesskey="n" href="ch02.html">Next</a></td></tr></table><hr></div><div class="section" title="Features"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="features"></a>Features</h2></div></div></div><p> - The server and client communicate via channels. Each channel is dedicated to a specific type of data. The available channels are following. - </p><div class="section" title="Multiple Channels"><div class="titlepage"><div><div><h3 class="title"><a name="multiple_channels"></a>Multiple Channels</h3></div></div></div><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p><span class="bold"><strong>Main</strong></span> - control and configuration</p></li><li class="listitem"><p><span class="bold"><strong>Display</strong></span> - graphics commands images and video streams</p></li><li class="listitem"><p><span class="bold"><strong>Inputs</strong></span> - keyboard and mouse inputs</p></li><li class="listitem"><p><span class="bold"><strong>Cursor</strong></span> - pointer device position and cursor shape</p></li><li class="listitem"><p><span class="bold"><strong>Playback</strong></span> - audio received from the server to be played by the client</p></li><li class="listitem"><p><span class="bold"><strong>Record</strong></span> - audio capture on the client side</p></li></ol></div></div><div class="section" title="Image Compression"><div class="titlepage"><div><div><h3 class="title"><a name="image_compression"></a>Image Compression</h3></div></div></div><p> - Spice offers several image compression algorithms, which can be chosen on server initiation and dynamically at run-time. Quic is a Spice proprietary image compression technology based on the SFALIC algorithm. The Lempel-Ziv (LZ) algorithm is another option. Both Quic and LZ are local algorithms encoding each image separately. Global LZ (GLZ) is another proprietary Spice technology that uses LZ with history based global dictionary. GLZ takes advantage of repeating patterns among images to shrink the traffic and save bandwidth, which is critical in a WAN environment. Spice also offers an automatic mode for compression selection per image, where the choice between LZ/GLZ and Quic is heuristically based on image properties. Conceptually, synthetic images are better compressed with LZ/GLZ and real images are better with Quic. - </p></div><div class="section" title="Video Compression"><div class="titlepage"><div><div><h3 class="title"><a name="video_compression"></a>Video Compression</h3></div></div></div><p> - Spice uses loss-less compression for images sent to the client. However, video streams are handled differently. Spice server heuristically identifies video areas and sends them as a video stream coded using M-JPEG. This handling saves a lot of traffic, improving Spice performance, especially in a WAN environment. However, in some circumstances the heuristic behavior might cause low quality image (e.g. identifying updated text area as a video stream). Video streaming can be chosen on server initiation and dynamically at run-time. - </p></div><div class="section" title="Mouse modes"><div class="titlepage"><div><div><h3 class="title"><a name="mouse_modes"></a>Mouse modes</h3></div></div></div><p> - Spice supports two mouse modes: server and client. The mode can be changed dynamically and is negotiated between the client and the server. - </p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p> - <span class="bold"><strong>Server mouse</strong></span> - When a user clicks inside the Spice client window, the client mouse is captured and set invisible. In this mode, the server controls the mouse position on display. However, it might be problematic on WAN or a loaded server, where mouse cursor might have some latency or non-responsiveness. - </p></li><li class="listitem"><p> - <span class="bold"><strong>Client mouse</strong></span> - Not captured and is used as the effective pointing device. For enabling client mouse, VDI host application must register an absolute pointing device (e.g. USB tablet in QEMU). This mode is appropriate for WAN or loaded server, since cursor has smooth motion and responsiveness. However, the cursor might loose synchronization (position and shape) for a while. - </p></li></ol></div></div><div class="section" title="Other Features"><div class="titlepage"><div><div><h3 class="title"><a name="other_features"></a>Other Features</h3></div></div></div><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p> - <span class="bold"><strong>Multiple Monitors</strong></span> - any number of monitors is supported - </p></li><li class="listitem"><p> - <span class="bold"><strong>Bidirectional Audio</strong></span> - Spice supports audio playback and recording. Playback is compressed using the CELT algorithm - </p></li><li class="listitem"><p> - <span class="bold"><strong>Lip-sync</strong></span> - between video and audio. Available only when video streaming is enabled. - </p></li><li class="listitem"><p> - <span class="bold"><strong>Migration</strong></span> - switching channel connectivity for supporting server migration - </p></li><li class="listitem"><p> - <span class="bold"><strong>Pixmap and Pallete caching</strong></span> - </p></li></ol></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch01.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ch01.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="ch02.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 1. Introduction </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 2. Installation</td></tr></table></div></body></html>
\ No newline at end of file diff --git a/books/docbook/chunks/ch02.html b/books/docbook/chunks/ch02.html deleted file mode 100644 index 3988cca..0000000 --- a/books/docbook/chunks/ch02.html +++ /dev/null @@ -1,21 +0,0 @@ -<html><head> - <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> - <title>Chapter 2. Installation</title><meta name="generator" content="DocBook XSL-NS Stylesheets V1.76.1"><link rel="home" href="index.html" title="Spice User Manual"><link rel="up" href="index.html" title="Spice User Manual"><link rel="prev" href="ch01s02.html" title="Features"><link rel="next" href="ch02s02.html" title="Building Spice in Generic Linux"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter 2. Installation</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch01s02.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="ch02s02.html">Next</a></td></tr></table><hr></div><div lang="" class="chapter" title="Chapter 2. Installation"><div class="titlepage"><div><div><h2 class="title"><a name="d0e199"></a>Chapter 2. Installation</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="ch02.html#rhel_fedora">Installing Spice in RHEL or Fedora </a></span></dt><dd><dl><dt><span class="section"><a href="ch02.html#d0e207">RHEL >=6 and Fedora >=13</a></span></dt><dt><span class="section"><a href="ch02.html#d0e220">RHEL 5</a></span></dt><dt><span class="section"><a href="ch02.html#d0e230">RHEVM Users</a></span></dt></dl></dd><dt><span class="section"><a href="ch02s02.html">Building Spice in Generic Linux</a></span></dt><dd><dl><dt><span class="section"><a href="ch02s02.html#req_client">Client requirements</a></span></dt><dt><span class="section"><a href="ch02s02.html#req_host">Host requirements</a></span></dt><dt><span class="section"><a href="ch02s02.html#d0e312">Guest requirements</a></span></dt><dt><span class="section"><a href="ch02s02.html#d0e397">Setting up PATH</a></span></dt></dl></dd></dl></div><div class="section" title="Installing Spice in RHEL or Fedora"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="rhel_fedora"></a>Installing Spice in RHEL or Fedora </h2></div></div></div><p> - Be aware that there is no build of spice-server for i386 so you can run only client part on i386. The reason for it is that there is no buld of qemu-kvm for RHEL of Fedora i386 either. - </p><div class="section" title="RHEL >=6 and Fedora >=13"><div class="titlepage"><div><div><h3 class="title"><a name="d0e207"></a>RHEL >=6 and Fedora >=13</h3></div></div></div><p> - </p><pre class="screen">yum install qemu-kvm spice-client</pre><p> - </p><pre class="screen">yum install spice-gtk # Only on Fedora >=14</pre><p> - </p><p> - Package spice-protocol will be downloaded automatically as a dependency for package kvm. - </p></div><div class="section" title="RHEL 5"><div class="titlepage"><div><div><h3 class="title"><a name="d0e220"></a>RHEL 5</h3></div></div></div><p> - </p><pre class="screen">yum install kvm qspice-client</pre><p> - </p><p> - Similarly as in RHEL6 package kvm has qspice-libs as a dependency. - </p></div><div class="section" title="RHEVM Users"><div class="titlepage"><div><div><h3 class="title"><a name="d0e230"></a>RHEVM Users</h3></div></div></div><p> - <span class="bold"><strong> - RHEVM users could be also interested in spice-xpi package as - it's allow you to execute spice-client directly from the RHEVM - UserPortal. - </strong></span> - </p><pre class="screen">yum install spice-xpi</pre><p> - </p></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch01s02.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="ch02s02.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Features </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Building Spice in Generic Linux</td></tr></table></div></body></html>
\ No newline at end of file diff --git a/books/docbook/chunks/ch02s02.html b/books/docbook/chunks/ch02s02.html deleted file mode 100644 index 001880a..0000000 --- a/books/docbook/chunks/ch02s02.html +++ /dev/null @@ -1,65 +0,0 @@ -<html><head> - <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> - <title>Building Spice in Generic Linux</title><meta name="generator" content="DocBook XSL-NS Stylesheets V1.76.1"><link rel="home" href="index.html" title="Spice User Manual"><link rel="up" href="ch02.html" title="Chapter 2. Installation"><link rel="prev" href="ch02.html" title="Chapter 2. Installation"><link rel="next" href="ch03.html" title="Chapter 3. Spice basics"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Building Spice in Generic Linux</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch02.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Installation</th><td width="20%" align="right"> <a accesskey="n" href="ch03.html">Next</a></td></tr></table><hr></div><div class="section" title="Building Spice in Generic Linux"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="linux_generic"></a>Building Spice in Generic Linux</h2></div></div></div><p> - This section is for distributions that don't have *spice* packages in their repositories. - It will show you step by step how to build required spice components. - </p><div class="section" title="Client requirements"><div class="titlepage"><div><div><h3 class="title"><a name="req_client"></a>Client requirements</h3></div></div></div><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p><span class="bold"><strong>autotools</strong></span></p></li><li class="listitem"><p><span class="bold"><strong>pixman >= 1.7.1</strong></span></p></li><li class="listitem"><p><span class="bold"><strong>celt = 0.5.1.3</strong></span> The exact version is required due no backwards compatibility of celt.</p></li><li class="listitem"><p><span class="bold"><strong>alsa</strong></span></p></li><li class="listitem"><p><span class="bold"><strong>log4cpp</strong></span></p></li><li class="listitem"><p><span class="bold"><strong>openssl</strong></span></p></li><li class="listitem"><p><span class="bold"><strong>libXrandr</strong></span></p></li><li class="listitem"><p><span class="bold"><strong>cegui</strong></span></p></li><li class="listitem"><p><span class="bold"><strong>libgcrypt-devel</strong></span></p></li><li class="listitem"><p><span class="bold"><strong>pyparsing</strong></span></p></li><li class="listitem"><p><span class="bold"><strong>dev86</strong></span></p></li><li class="listitem"><p><span class="bold"><strong>iasl</strong></span></p></li><li class="listitem"><p><span class="bold"><strong>nss</strong></span></p></li></ol></div></div><div class="section" title="Host requirements"><div class="titlepage"><div><div><h3 class="title"><a name="req_host"></a>Host requirements</h3></div></div></div><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p><span class="bold"><strong>KVM supported by kernel</strong></span> (It should work also without KVM, but - it's not being tested as most Linux distrubitions already support - KVM.)</p></li></ol></div></div><div class="section" title="Guest requirements"><div class="titlepage"><div><div><h3 class="title"><a name="d0e312"></a>Guest requirements</h3></div></div></div><div class="section" title="Linux Guest"><div class="titlepage"><div><div><h4 class="title"><a name="d0e315"></a>Linux Guest</h4></div></div></div><p> - spice-vdagent requires virtio-serial support should to be enabled. This will be described in <a class="link" href="SpiceUserManual-Basics.xml#basics" target="_top">chapter Spice basics</a>. - Guest should have installed qxl driver (xorg-x11-drv-qxl on Fedora and RHEL). - </p></div><div class="section" title="Windows Guest"><div class="titlepage"><div><div><h4 class="title"><a name="d0e323"></a>Windows Guest</h4></div></div></div><p> - Drivers for QXL and drivers for virtio-serial assume Win XP SP3 and Win 7. - </p></div><div class="section" title="Setting up build environment"><div class="titlepage"><div><div><h4 class="title"><a name="setting_be"></a>Setting up build environment</h4></div></div></div><p> - <span class="bold"><strong>This is list of prerequisities on RHEL or Fedora. Install - package equivalents for your distrubition in case that you're not using RHEL - or Fedora.</strong></span> - </p><p> - <span class="bold"><strong>All prerequisities for Windows are available in one big package which is available - at <a class="link" href="http://spice-space.org/download.html" target="_top">http://spice-space.org/download.html</a>.</strong></span> - </p><pre class="screen">yum install git pixman-devel celt051-devel cegui-devel libjpeg-devel alsa-lib-devel log4cpp-devel \ - openssl-devel libXrandr-devel libgcrypt-devel SDL-devel nss-devel dev86 iasl pyparsing</pre><p> - <span class="bold"><strong>Package prerequisities for Ubuntu</strong></span> - </p><pre class="screen">apt-get install build-essential autoconf git-core libtool liblog4cpp5-dev libavcodec-dev \ - libssl-dev xlibmesa-glu-dev libasound-dev libpng12-dev libfreetype6-dev libfontconfig1-dev \ - libogg-dev libxrandr-dev kvm libgcrypt-dev libsdl-dev</pre></div><div class="section" title="Building libcacard"><div class="titlepage"><div><div><h4 class="title"><a name="building_libcacard"></a>Building libcacard</h4></div></div></div><p>Fedora >=14 RHEL >=6.1 has libcacard already available. So you can install it directly trough yum.</p><pre class="screen">yum install libcacard</pre><p>Otherwise follow these instructions. <span class="bold"><strong>Environmental - variable $BUILD_ROOT will point to a directory with stored sources and will - be used during whole build process. Variable $INST_ROOT will point to a - directory in which will be spice installed.</strong></span></p><pre class="screen">export BUILD_ROOT=/tmp/spice; mkdir $BUILD_ROOT; cd $BUILD_ROOT; -export INST_ROOT="/opt/spice"; mkdir $INST_ROOT -git clone git://anongit.freedesktop.org/~alon/libcacard -cd libcacard -./configure --prefix=/usr --libdir=/usr/lib64 # Ignore --libdir at Ubuntu -make -make install</pre></div><div class="section" title="Getting client sources"><div class="titlepage"><div><div><h4 class="title"><a name="getting_client"></a>Getting client sources</h4></div></div></div><pre class="screen">cd $BUILD_ROOT -git clone git://cgit.freedesktop.org/spice/spice-protocol -git clone git://cgit.freedesktop.org/spice/spice -wget http://downloads.us.xiph.org/releases/celt/celt-0.5.1.3.tar.gz -tar xvzf celt-0.5.1.3.tar.gz - </pre></div><div class="section" title="Getting client/server sources"><div class="titlepage"><div><div><h4 class="title"><a name="getting_server"></a>Getting client/server sources</h4></div></div></div><p>Skip this section if you don't want to build server side.</p><pre class="screen">cd $BUILD_ROOT -git clone git://cgit.freedesktop.org/spice/qemu -cd qemu; git checkout -b spice.v13 origin/spice.v13; cd .. -git clone git://cgit.freedesktop.org/spice/spice-protocol -git clone git://cgit.freedesktop.org/spice/spice -git clone git://cgit.freedesktop.org/spice/win32/vd_agent -git clone git://cgit.freedesktop.org/spice/win32/qxl -git clone git://cgit.freedesktop.org/spice/slirp -wget http://downloads.us.xiph.org/releases/celt/celt-0.5.1.3.tar.gz -tar xvzf celt-0.5.1.3.tar.gz</pre></div><div class="section" title="Building common sources."><div class="titlepage"><div><div><h4 class="title"><a name="building_common"></a>Building common sources.</h4></div></div></div><p>This part applies to both server and client build process.</p><pre class="screen">cd $BUILD_ROOT/spice-protocol -mkdir m4 -./autogen.sh --prefix=$INST_ROOT -sudo make install -cd $BUILD_ROOT/celt-0.5.1.3 -./configure --prefix=$INST_ROOT -sudo make install -</pre></div><div class="section" title="Building client side tools"><div class="titlepage"><div><div><h4 class="title"><a name="d0e385"></a>Building client side tools</h4></div></div></div><pre class="screen">cd $BUILD_ROOT/spice -./autogen.sh --prefix=$INST_ROOT --enable-smartcard -cd client -sudo make install</pre></div><div class="section" title="Building server side tools"><div class="titlepage"><div><div><h4 class="title"><a name="d0e390"></a>Building server side tools</h4></div></div></div><p>These instruction contains flags for minimal working build of qemu with spice support enabled. - You might want to build qemu with --enable-io-thread options</p><pre class="screen">cd $SRC_ROOT/qemu -./configure --prefix=$INST_ROOT --target-list=x86_64-softmmu --enable-spice -make</pre></div></div><div class="section" title="Setting up PATH"><div class="titlepage"><div><div><h3 class="title"><a name="d0e397"></a>Setting up PATH</h3></div></div></div><p>Last steps before starting with spice are to set proper PATH variable. - For example RHEL is using /usr/libexec as directory for spicec and qemu-kvm binaries. - Following setup should be suitable for qemu and spice build according to instructions in - this chapter.</p><pre class="screen">echo "export PATH=$PATH:$INST_ROOT/bin:$BUILD_ROOT/x86_64-softmmu >> ~/.bashrc -source ~/.bashrc</pre><p>You should now be able to access qemu-system-x86_64 and spicec binaries.</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch02.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ch02.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="ch03.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 2. Installation </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 3. Spice basics</td></tr></table></div></body></html>
\ No newline at end of file diff --git a/books/docbook/chunks/ch03.html b/books/docbook/chunks/ch03.html deleted file mode 100644 index a14fc8c..0000000 --- a/books/docbook/chunks/ch03.html +++ /dev/null @@ -1,3 +0,0 @@ -<html><head> - <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> - <title>Chapter 3. Spice basics</title><meta name="generator" content="DocBook XSL-NS Stylesheets V1.76.1"><link rel="home" href="index.html" title="Spice User Manual"><link rel="up" href="index.html" title="Spice User Manual"><link rel="prev" href="ch02s02.html" title="Building Spice in Generic Linux"><link rel="next" href="ch03s02.html" title="Launching qemu"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter 3. Spice basics</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch02s02.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="ch03s02.html">Next</a></td></tr></table><hr></div><div lang="" class="chapter" title="Chapter 3. Spice basics"><div class="titlepage"><div><div><h2 class="title"><a name="basics"></a>Chapter 3. Spice basics</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="ch03.html#definitions">Basic Definitions</a></span></dt><dd><dl><dt><span class="section"><a href="ch03.html#host">Host</a></span></dt><dt><span class="section"><a href="ch03.html#guest">Guest</a></span></dt><dt><span class="section"><a href="ch03.html#client">Client</a></span></dt></dl></dd><dt><span class="section"><a href="ch03s02.html">Launching qemu</a></span></dt></dl></div><div class="section" title="Basic Definitions"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="definitions"></a>Basic Definitions</h2></div></div></div><div class="section" title="Host"><div class="titlepage"><div><div><h3 class="title"><a name="host"></a>Host</h3></div></div></div><p>Host is a machine running instance of qemu-kvm.</p></div><div class="section" title="Guest"><div class="titlepage"><div><div><h3 class="title"><a name="guest"></a>Guest</h3></div></div></div><p>Guest is a virtual machine hosted on <a class="link" href="ch03.html#host" title="Host">host</a> which will be accessed by using spice client.</p></div><div class="section" title="Client"><div class="titlepage"><div><div><h3 class="title"><a name="client"></a>Client</h3></div></div></div><p>Client is reffering to a system running spice client (e.g. spicec or spicy).</p></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch02s02.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="ch03s02.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Building Spice in Generic Linux </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Launching qemu</td></tr></table></div></body></html>
\ No newline at end of file diff --git a/books/docbook/chunks/ch03s02.html b/books/docbook/chunks/ch03s02.html deleted file mode 100644 index 93c7b45..0000000 --- a/books/docbook/chunks/ch03s02.html +++ /dev/null @@ -1,25 +0,0 @@ -<html><head> - <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> - <title>Launching qemu</title><meta name="generator" content="DocBook XSL-NS Stylesheets V1.76.1"><link rel="home" href="index.html" title="Spice User Manual"><link rel="up" href="ch03.html" title="Chapter 3. Spice basics"><link rel="prev" href="ch03.html" title="Chapter 3. Spice basics"><link rel="next" href="ch04.html" title="Chapter 4. References"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Launching qemu</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch03.html">Prev</a> </td><th width="60%" align="center">Chapter 3. Spice basics</th><td width="20%" align="right"> <a accesskey="n" href="ch04.html">Next</a></td></tr></table><hr></div><div class="section" title="Launching qemu"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="qemu_basics"></a>Launching qemu</h2></div></div></div><p>I'll use qemu-kvm as a name for the executable. If you're using manually built qemu or - qemu without kvm then just replace qemu-kvm with your own binary. I'll use host# client# - guest# shell prompt notation to distinguish wherever should be the command executed. See - section <a class="link" href="definitions" target="_top">Basic Definitions</a> to be sure that you know - difference between the host, client and guest. You can ignore notation If guest, client - and host are on the same machine.</p><p> - <span class="bold"><strong>First important thing to do is to create a guest - image.</strong></span> You can use any raw device like clean logical volume, or iSCSI - lun. You may also use file as image for guest. I'll use file created by qemu-img as a demonstration. - </p><p> - Following command will allocate 10GB file. See qemu-img manpage for further information. - </p><pre class="screen">host# qemu-img create /path/to/xp.img 10G</pre><p> - So we already have image created and shall now start with image popullation. I assume that you have - locally stored ISO of your favourite operating system so you can use it for installation. - </p><pre class="screen">host# sudo qemu-kvm -boot order=dc -vga qxl -spice port=3001,disable-ticketing -soundhw ac97 \ - -cdrom /path/to/your.iso /path/to/your.img</pre><p> - Let's take just briefly look trough used qemu options. Option -boot order=dc specifies that guest system - should try to boot from first cdrom and then fallback to first disk, -vga qxl specifies that qemu should - emulate qxl device adapter. - </p><p> - There will be no running <a class="link" href="SpiceUserManual-Introduction.xml#vdagent" target="_top">agent</a> - on the <a class="link" href="guest" target="_top">guest</a> system so we don't have to emulate virtio device yet. - </p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch03.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ch03.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="ch04.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 3. Spice basics </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 4. References</td></tr></table></div></body></html>
\ No newline at end of file diff --git a/books/docbook/chunks/ch04.html b/books/docbook/chunks/ch04.html deleted file mode 100644 index ad1aaa2..0000000 --- a/books/docbook/chunks/ch04.html +++ /dev/null @@ -1,3 +0,0 @@ -<html><head> - <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> - <title>Chapter 4. References</title><meta name="generator" content="DocBook XSL-NS Stylesheets V1.76.1"><link rel="home" href="index.html" title="Spice User Manual"><link rel="up" href="index.html" title="Spice User Manual"><link rel="prev" href="ch03s02.html" title="Launching qemu"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter 4. References</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch03s02.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> </td></tr></table><hr></div><div lang="" class="chapter" title="Chapter 4. References"><div class="titlepage"><div><div><h2 class="title"><a name="d0e463"></a>Chapter 4. References</h2></div></div></div><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p><a name="spice_protocol_defs"></a>Spice remote computing protocol definition</p></li></ol></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch03s02.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> </td></tr><tr><td width="40%" align="left" valign="top">Launching qemu </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> </td></tr></table></div></body></html>
\ No newline at end of file diff --git a/books/docbook/chunks/index.html b/books/docbook/chunks/index.html deleted file mode 100644 index 0bfcf92..0000000 --- a/books/docbook/chunks/index.html +++ /dev/null @@ -1,6 +0,0 @@ -<html><head> - <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> - <title>Spice User Manual</title><meta name="generator" content="DocBook XSL-NS Stylesheets V1.76.1"><link rel="home" href="index.html" title="Spice User Manual"><link rel="next" href="ch01.html" title="Chapter 1. Introduction"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Spice User Manual</th></tr><tr><td width="20%" align="left"> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="ch01.html">Next</a></td></tr></table><hr></div><div lang="en" class="book" title="Spice User Manual"><div class="titlepage"><div><div><h1 class="title"><a name="d0e2"></a>Spice User Manual</h1></div><div><div class="authorgroup"><div class="author"><h3 class="author">Lubos Kocman</h3><code class="email"><<a class="email" href="mailto:lkocman@redhat.com">lkocman@redhat.com</a>></code></div><div class="author"><h3 class="author">Arnon Giloba</h3><code class="email"><<a class="email" href="mailto:agiloba@redhat.com">agiloba@redhat.com</a>></code></div><div class="author"><h3 class="author">Yaniv Kamay</h3><code class="email"><<a class="email" href="mailto:ykamay@redhat.com">ykamay@redhat.com</a>></code></div></div></div><div><p class="releaseinfo">Draft 54</p></div><div><p class="copyright">Copyright © 2009, 2010, 2011 Red Hat, Inc.</p></div><div><div class="legalnotice" title="Legal Notice"><a name="d0e31"></a><p> - Licensed under a Creative Commons Attribution-Share Alike 3.0 United States License - (see <a class="link" href="http://creativecommons.org/licenses/by-sa/3.0/us/legalcode" target="_top">http://creativecommons.org/licenses/by-sa/3.0/us/legalcode</a>). - </p></div></div></div><hr></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="chapter"><a href="ch01.html">1. Introduction</a></span></dt><dd><dl><dt><span class="section"><a href="ch01.html#d0e69">Spice and Spice-related Compoments</a></span></dt><dd><dl><dt><span class="section"><a href="ch01.html#spice_server">Spice Server</a></span></dt><dt><span class="section"><a href="ch01.html#spice_client">Spice Client</a></span></dt><dt><span class="section"><a href="ch01.html#d0e82">QXL Device and Drivers</a></span></dt><dt><span class="section"><a href="ch01.html#d0e87">VDI Port Device</a></span></dt><dt><span class="section"><a href="ch01.html#vdagent">Spice Agent</a></span></dt></dl></dd><dt><span class="section"><a href="ch01s02.html">Features</a></span></dt><dd><dl><dt><span class="section"><a href="ch01s02.html#multiple_channels">Multiple Channels</a></span></dt><dt><span class="section"><a href="ch01s02.html#image_compression">Image Compression</a></span></dt><dt><span class="section"><a href="ch01s02.html#video_compression">Video Compression</a></span></dt><dt><span class="section"><a href="ch01s02.html#mouse_modes">Mouse modes</a></span></dt><dt><span class="section"><a href="ch01s02.html#other_features">Other Features</a></span></dt></dl></dd></dl></dd><dt><span class="chapter"><a href="ch02.html">2. Installation</a></span></dt><dd><dl><dt><span class="section"><a href="ch02.html#rhel_fedora">Installing Spice in RHEL or Fedora </a></span></dt><dd><dl><dt><span class="section"><a href="ch02.html#d0e207">RHEL >=6 and Fedora >=13</a></span></dt><dt><span class="section"><a href="ch02.html#d0e220">RHEL 5</a></span></dt><dt><span class="section"><a href="ch02.html#d0e230">RHEVM Users</a></span></dt></dl></dd><dt><span class="section"><a href="ch02s02.html">Building Spice in Generic Linux</a></span></dt><dd><dl><dt><span class="section"><a href="ch02s02.html#req_client">Client requirements</a></span></dt><dt><span class="section"><a href="ch02s02.html#req_host">Host requirements</a></span></dt><dt><span class="section"><a href="ch02s02.html#d0e312">Guest requirements</a></span></dt><dt><span class="section"><a href="ch02s02.html#d0e397">Setting up PATH</a></span></dt></dl></dd></dl></dd><dt><span class="chapter"><a href="ch03.html">3. Spice basics</a></span></dt><dd><dl><dt><span class="section"><a href="ch03.html#definitions">Basic Definitions</a></span></dt><dd><dl><dt><span class="section"><a href="ch03.html#host">Host</a></span></dt><dt><span class="section"><a href="ch03.html#guest">Guest</a></span></dt><dt><span class="section"><a href="ch03.html#client">Client</a></span></dt></dl></dd><dt><span class="section"><a href="ch03s02.html">Launching qemu</a></span></dt></dl></dd><dt><span class="chapter"><a href="ch04.html">4. References</a></span></dt></dl></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="ch01.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"> </td><td width="20%" align="center"> </td><td width="40%" align="right" valign="top"> Chapter 1. Introduction</td></tr></table></div></body></html>
\ No newline at end of file diff --git a/books/html/ch01.html b/books/html/ch01.html index 0261117..700aa4b 100644 --- a/books/html/ch01.html +++ b/books/html/ch01.html @@ -1,6 +1,6 @@ <html><head> <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> - <title>Chapter 1. Introduction</title><meta name="generator" content="DocBook XSL-NS Stylesheets V1.76.1"><link rel="home" href="index.html" title="Spice User Guide"><link rel="up" href="index.html" title="Spice User Guide"><link rel="prev" href="index.html" title="Spice User Guide"><link rel="next" href="ch01s02.html" title="Features"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter 1. Introduction</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="index.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="ch01s02.html">Next</a></td></tr></table><hr></div><div class="chapter" title="Chapter 1. Introduction"><div class="titlepage"><div><div><h2 class="title"><a name="d0e50"></a>Chapter 1. Introduction</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="ch01.html#d0e69">Spice and Spice-related Compoments</a></span></dt><dd><dl><dt><span class="section"><a href="ch01.html#spice_server">Spice Server</a></span></dt><dt><span class="section"><a href="ch01.html#spice_client">Spice Client</a></span></dt><dt><span class="section"><a href="ch01.html#d0e82">QXL Device and Drivers</a></span></dt><dt><span class="section"><a href="ch01.html#d0e87">VDI Port Device</a></span></dt><dt><span class="section"><a href="ch01.html#d0e92">Spice Agent</a></span></dt></dl></dd><dt><span class="section"><a href="ch01s02.html">Features</a></span></dt><dd><dl><dt><span class="section"><a href="ch01s02.html#multiple_channels">Multiple Channels</a></span></dt><dt><span class="section"><a href="ch01s02.html#image_compression">Image Compression</a></span></dt><dt><span class="section"><a href="ch01s02.html#video_compression">Video Compression</a></span></dt><dt><span class="section"><a href="ch01s02.html#mouse_modes">Mouse modes</a></span></dt><dt><span class="section"><a href="ch01s02.html#other_features">Other Features</a></span></dt></dl></dd></dl></div><p> + <title>Chapter 1. Introduction</title><meta name="generator" content="DocBook XSL-NS Stylesheets V1.76.1"><link rel="home" href="index.html" title="Spice User Manual"><link rel="up" href="index.html" title="Spice User Manual"><link rel="prev" href="index.html" title="Spice User Manual"><link rel="next" href="ch01s02.html" title="Features"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter 1. Introduction</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="index.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="ch01s02.html">Next</a></td></tr></table><hr></div><div lang="" class="chapter" title="Chapter 1. Introduction"><div class="titlepage"><div><div><h2 class="title"><a name="d0e50"></a>Chapter 1. Introduction</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="ch01.html#d0e69">Spice and Spice-related Compoments</a></span></dt><dd><dl><dt><span class="section"><a href="ch01.html#spice_server">Spice Server</a></span></dt><dt><span class="section"><a href="ch01.html#spice_client">Spice Client</a></span></dt><dt><span class="section"><a href="ch01.html#d0e82">QXL Device and Drivers</a></span></dt><dt><span class="section"><a href="ch01.html#d0e87">VDI Port Device</a></span></dt><dt><span class="section"><a href="ch01.html#vdagent">Spice Agent</a></span></dt></dl></dd><dt><span class="section"><a href="ch01s02.html">Features</a></span></dt><dd><dl><dt><span class="section"><a href="ch01s02.html#multiple_channels">Multiple Channels</a></span></dt><dt><span class="section"><a href="ch01s02.html#image_compression">Image Compression</a></span></dt><dt><span class="section"><a href="ch01s02.html#video_compression">Video Compression</a></span></dt><dt><span class="section"><a href="ch01s02.html#mouse_modes">Mouse modes</a></span></dt><dt><span class="section"><a href="ch01s02.html#other_features">Other Features</a></span></dt></dl></dd></dl></div><p> Spice is an open remote computing solution, providing client access to remote displays and devices (e.g. keyboard, mouse, audio). Spice provides a desktop like user experience, while trying to offload most of the intensive CPU and GPU tasks to the client. @@ -22,10 +22,10 @@ </p></div><div class="section" title="VDI Port Device"><div class="titlepage"><div><div><h3 class="title"><a name="d0e87"></a>VDI Port Device</h3></div></div></div><p> Spice protocol supports a communication channel between the client and the agent on the server side. When using QEMU, Spice agent resides on the guest. VDI port is a QEMU PCI device used for communication with the agent. - </p></div><div class="section" title="Spice Agent"><div class="titlepage"><div><div><h3 class="title"><a name="d0e92"></a>Spice Agent</h3></div></div></div><p> + </p></div><div class="section" title="Spice Agent"><div class="titlepage"><div><div><h3 class="title"><a name="vdagent"></a>Spice Agent</h3></div></div></div><p> The Spice agent is an optional component for enhancing user experience and performing guest-oriented management tasks. For example, the agent injects mouse position and state to the guest when using client mouse mode. It also enables you to move cursor freely between guest and client. Other features of agent are shared clipboard and aligning guest resolution with client while entering fullscreen mode. - </p></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="index.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="ch01s02.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Spice User Guide </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Features</td></tr></table></div></body></html>
\ No newline at end of file + </p></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="index.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="ch01s02.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Spice User Manual </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Features</td></tr></table></div></body></html>
\ No newline at end of file diff --git a/books/html/ch01s02.html b/books/html/ch01s02.html index 5f7ef10..d6cc381 100644 --- a/books/html/ch01s02.html +++ b/books/html/ch01s02.html @@ -1,6 +1,6 @@ <html><head> <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> - <title>Features</title><meta name="generator" content="DocBook XSL-NS Stylesheets V1.76.1"><link rel="home" href="index.html" title="Spice User Guide"><link rel="up" href="ch01.html" title="Chapter 1. Introduction"><link rel="prev" href="ch01.html" title="Chapter 1. Introduction"><link rel="next" href="ch02.html" title="Chapter 2. Installation"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Features</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch01.html">Prev</a> </td><th width="60%" align="center">Chapter 1. Introduction</th><td width="20%" align="right"> <a accesskey="n" href="ch02.html">Next</a></td></tr></table><hr></div><div class="section" title="Features"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="features"></a>Features</h2></div></div></div><p> + <title>Features</title><meta name="generator" content="DocBook XSL-NS Stylesheets V1.76.1"><link rel="home" href="index.html" title="Spice User Manual"><link rel="up" href="ch01.html" title="Chapter 1. Introduction"><link rel="prev" href="ch01.html" title="Chapter 1. Introduction"><link rel="next" href="ch02.html" title="Chapter 2. Installation"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Features</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch01.html">Prev</a> </td><th width="60%" align="center">Chapter 1. Introduction</th><td width="20%" align="right"> <a accesskey="n" href="ch02.html">Next</a></td></tr></table><hr></div><div class="section" title="Features"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="features"></a>Features</h2></div></div></div><p> The server and client communicate via channels. Each channel is dedicated to a specific type of data. The available channels are following. </p><div class="section" title="Multiple Channels"><div class="titlepage"><div><div><h3 class="title"><a name="multiple_channels"></a>Multiple Channels</h3></div></div></div><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p><span class="bold"><strong>Main</strong></span> - control and configuration</p></li><li class="listitem"><p><span class="bold"><strong>Display</strong></span> - graphics commands images and video streams</p></li><li class="listitem"><p><span class="bold"><strong>Inputs</strong></span> - keyboard and mouse inputs</p></li><li class="listitem"><p><span class="bold"><strong>Cursor</strong></span> - pointer device position and cursor shape</p></li><li class="listitem"><p><span class="bold"><strong>Playback</strong></span> - audio received from the server to be played by the client</p></li><li class="listitem"><p><span class="bold"><strong>Record</strong></span> - audio capture on the client side</p></li></ol></div></div><div class="section" title="Image Compression"><div class="titlepage"><div><div><h3 class="title"><a name="image_compression"></a>Image Compression</h3></div></div></div><p> Spice offers several image compression algorithms, which can be chosen on server initiation and dynamically at run-time. Quic is a Spice proprietary image compression technology based on the SFALIC algorithm. The Lempel-Ziv (LZ) algorithm is another option. Both Quic and LZ are local algorithms encoding each image separately. Global LZ (GLZ) is another proprietary Spice technology that uses LZ with history based global dictionary. GLZ takes advantage of repeating patterns among images to shrink the traffic and save bandwidth, which is critical in a WAN environment. Spice also offers an automatic mode for compression selection per image, where the choice between LZ/GLZ and Quic is heuristically based on image properties. Conceptually, synthetic images are better compressed with LZ/GLZ and real images are better with Quic. diff --git a/books/html/ch02.html b/books/html/ch02.html index 56720e2..3988cca 100644 --- a/books/html/ch02.html +++ b/books/html/ch02.html @@ -1,6 +1,6 @@ <html><head> <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> - <title>Chapter 2. Installation</title><meta name="generator" content="DocBook XSL-NS Stylesheets V1.76.1"><link rel="home" href="index.html" title="Spice User Guide"><link rel="up" href="index.html" title="Spice User Guide"><link rel="prev" href="ch01s02.html" title="Features"><link rel="next" href="ch02s02.html" title="Building Spice in Generic Linux"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter 2. Installation</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch01s02.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="ch02s02.html">Next</a></td></tr></table><hr></div><div class="chapter" title="Chapter 2. Installation"><div class="titlepage"><div><div><h2 class="title"><a name="d0e199"></a>Chapter 2. Installation</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="ch02.html#rhel_fedora">Installing Spice in RHEL or Fedora </a></span></dt><dd><dl><dt><span class="section"><a href="ch02.html#d0e207">RHEL >=6 and Fedora >=13</a></span></dt><dt><span class="section"><a href="ch02.html#d0e220">RHEL 5</a></span></dt><dt><span class="section"><a href="ch02.html#d0e230">RHEVM Users</a></span></dt></dl></dd><dt><span class="section"><a href="ch02s02.html">Building Spice in Generic Linux</a></span></dt><dd><dl><dt><span class="section"><a href="ch02s02.html#req_client">Client requirements</a></span></dt><dt><span class="section"><a href="ch02s02.html#req_host">Host requirements</a></span></dt><dt><span class="section"><a href="ch02s02.html#d0e312">Guest requirements</a></span></dt><dt><span class="section"><a href="ch02s02.html#d0e397">Setting up PATH</a></span></dt></dl></dd></dl></div><div class="section" title="Installing Spice in RHEL or Fedora"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="rhel_fedora"></a>Installing Spice in RHEL or Fedora </h2></div></div></div><p> + <title>Chapter 2. Installation</title><meta name="generator" content="DocBook XSL-NS Stylesheets V1.76.1"><link rel="home" href="index.html" title="Spice User Manual"><link rel="up" href="index.html" title="Spice User Manual"><link rel="prev" href="ch01s02.html" title="Features"><link rel="next" href="ch02s02.html" title="Building Spice in Generic Linux"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter 2. Installation</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch01s02.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="ch02s02.html">Next</a></td></tr></table><hr></div><div lang="" class="chapter" title="Chapter 2. Installation"><div class="titlepage"><div><div><h2 class="title"><a name="d0e199"></a>Chapter 2. Installation</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="ch02.html#rhel_fedora">Installing Spice in RHEL or Fedora </a></span></dt><dd><dl><dt><span class="section"><a href="ch02.html#d0e207">RHEL >=6 and Fedora >=13</a></span></dt><dt><span class="section"><a href="ch02.html#d0e220">RHEL 5</a></span></dt><dt><span class="section"><a href="ch02.html#d0e230">RHEVM Users</a></span></dt></dl></dd><dt><span class="section"><a href="ch02s02.html">Building Spice in Generic Linux</a></span></dt><dd><dl><dt><span class="section"><a href="ch02s02.html#req_client">Client requirements</a></span></dt><dt><span class="section"><a href="ch02s02.html#req_host">Host requirements</a></span></dt><dt><span class="section"><a href="ch02s02.html#d0e312">Guest requirements</a></span></dt><dt><span class="section"><a href="ch02s02.html#d0e397">Setting up PATH</a></span></dt></dl></dd></dl></div><div class="section" title="Installing Spice in RHEL or Fedora"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="rhel_fedora"></a>Installing Spice in RHEL or Fedora </h2></div></div></div><p> Be aware that there is no build of spice-server for i386 so you can run only client part on i386. The reason for it is that there is no buld of qemu-kvm for RHEL of Fedora i386 either. </p><div class="section" title="RHEL >=6 and Fedora >=13"><div class="titlepage"><div><div><h3 class="title"><a name="d0e207"></a>RHEL >=6 and Fedora >=13</h3></div></div></div><p> </p><pre class="screen">yum install qemu-kvm spice-client</pre><p> diff --git a/books/html/ch02s02.html b/books/html/ch02s02.html index 4606baf..001880a 100644 --- a/books/html/ch02s02.html +++ b/books/html/ch02s02.html @@ -1,6 +1,6 @@ <html><head> <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> - <title>Building Spice in Generic Linux</title><meta name="generator" content="DocBook XSL-NS Stylesheets V1.76.1"><link rel="home" href="index.html" title="Spice User Guide"><link rel="up" href="ch02.html" title="Chapter 2. Installation"><link rel="prev" href="ch02.html" title="Chapter 2. Installation"><link rel="next" href="ch03.html" title="Chapter 3. Spice basics"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Building Spice in Generic Linux</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch02.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Installation</th><td width="20%" align="right"> <a accesskey="n" href="ch03.html">Next</a></td></tr></table><hr></div><div class="section" title="Building Spice in Generic Linux"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="linux_generic"></a>Building Spice in Generic Linux</h2></div></div></div><p> + <title>Building Spice in Generic Linux</title><meta name="generator" content="DocBook XSL-NS Stylesheets V1.76.1"><link rel="home" href="index.html" title="Spice User Manual"><link rel="up" href="ch02.html" title="Chapter 2. Installation"><link rel="prev" href="ch02.html" title="Chapter 2. Installation"><link rel="next" href="ch03.html" title="Chapter 3. Spice basics"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Building Spice in Generic Linux</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch02.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Installation</th><td width="20%" align="right"> <a accesskey="n" href="ch03.html">Next</a></td></tr></table><hr></div><div class="section" title="Building Spice in Generic Linux"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="linux_generic"></a>Building Spice in Generic Linux</h2></div></div></div><p> This section is for distributions that don't have *spice* packages in their repositories. It will show you step by step how to build required spice components. </p><div class="section" title="Client requirements"><div class="titlepage"><div><div><h3 class="title"><a name="req_client"></a>Client requirements</h3></div></div></div><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p><span class="bold"><strong>autotools</strong></span></p></li><li class="listitem"><p><span class="bold"><strong>pixman >= 1.7.1</strong></span></p></li><li class="listitem"><p><span class="bold"><strong>celt = 0.5.1.3</strong></span> The exact version is required due no backwards compatibility of celt.</p></li><li class="listitem"><p><span class="bold"><strong>alsa</strong></span></p></li><li class="listitem"><p><span class="bold"><strong>log4cpp</strong></span></p></li><li class="listitem"><p><span class="bold"><strong>openssl</strong></span></p></li><li class="listitem"><p><span class="bold"><strong>libXrandr</strong></span></p></li><li class="listitem"><p><span class="bold"><strong>cegui</strong></span></p></li><li class="listitem"><p><span class="bold"><strong>libgcrypt-devel</strong></span></p></li><li class="listitem"><p><span class="bold"><strong>pyparsing</strong></span></p></li><li class="listitem"><p><span class="bold"><strong>dev86</strong></span></p></li><li class="listitem"><p><span class="bold"><strong>iasl</strong></span></p></li><li class="listitem"><p><span class="bold"><strong>nss</strong></span></p></li></ol></div></div><div class="section" title="Host requirements"><div class="titlepage"><div><div><h3 class="title"><a name="req_host"></a>Host requirements</h3></div></div></div><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p><span class="bold"><strong>KVM supported by kernel</strong></span> (It should work also without KVM, but diff --git a/books/html/ch03.html b/books/html/ch03.html index d81a87a..a14fc8c 100644 --- a/books/html/ch03.html +++ b/books/html/ch03.html @@ -1,3 +1,3 @@ <html><head> <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> - <title>Chapter 3. Spice basics</title><meta name="generator" content="DocBook XSL-NS Stylesheets V1.76.1"><link rel="home" href="index.html" title="Spice User Guide"><link rel="up" href="index.html" title="Spice User Guide"><link rel="prev" href="ch02s02.html" title="Building Spice in Generic Linux"><link rel="next" href="ch03s02.html" title="Launching qemu"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter 3. Spice basics</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch02s02.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="ch03s02.html">Next</a></td></tr></table><hr></div><div class="chapter" title="Chapter 3. Spice basics"><div class="titlepage"><div><div><h2 class="title"><a name="basics"></a>Chapter 3. Spice basics</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="ch03.html#definitions">Basic Definitions</a></span></dt><dd><dl><dt><span class="section"><a href="ch03.html#host">Host</a></span></dt><dt><span class="section"><a href="ch03.html#guest">Guest</a></span></dt><dt><span class="section"><a href="ch03.html#client">Client</a></span></dt></dl></dd><dt><span class="section"><a href="ch03s02.html">Launching qemu</a></span></dt></dl></div><div class="section" title="Basic Definitions"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="definitions"></a>Basic Definitions</h2></div></div></div><div class="section" title="Host"><div class="titlepage"><div><div><h3 class="title"><a name="host"></a>Host</h3></div></div></div><p>Host is a machine running instance of qemu-kvm.</p></div><div class="section" title="Guest"><div class="titlepage"><div><div><h3 class="title"><a name="guest"></a>Guest</h3></div></div></div><p>Guest is a virtual machine hosted on <a class="link" href="ch03.html#host" title="Host">host</a> which will be accessed by using spice client.</p></div><div class="section" title="Client"><div class="titlepage"><div><div><h3 class="title"><a name="client"></a>Client</h3></div></div></div><p>Client is reffering to a system running spice client (e.g. spicec or spicy).</p></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch02s02.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="ch03s02.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Building Spice in Generic Linux </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Launching qemu</td></tr></table></div></body></html>
\ No newline at end of file + <title>Chapter 3. Spice basics</title><meta name="generator" content="DocBook XSL-NS Stylesheets V1.76.1"><link rel="home" href="index.html" title="Spice User Manual"><link rel="up" href="index.html" title="Spice User Manual"><link rel="prev" href="ch02s02.html" title="Building Spice in Generic Linux"><link rel="next" href="ch03s02.html" title="Launching qemu"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter 3. Spice basics</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch02s02.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="ch03s02.html">Next</a></td></tr></table><hr></div><div lang="" class="chapter" title="Chapter 3. Spice basics"><div class="titlepage"><div><div><h2 class="title"><a name="basics"></a>Chapter 3. Spice basics</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="ch03.html#definitions">Basic Definitions</a></span></dt><dd><dl><dt><span class="section"><a href="ch03.html#host">Host</a></span></dt><dt><span class="section"><a href="ch03.html#guest">Guest</a></span></dt><dt><span class="section"><a href="ch03.html#client">Client</a></span></dt></dl></dd><dt><span class="section"><a href="ch03s02.html">Launching qemu</a></span></dt></dl></div><div class="section" title="Basic Definitions"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="definitions"></a>Basic Definitions</h2></div></div></div><div class="section" title="Host"><div class="titlepage"><div><div><h3 class="title"><a name="host"></a>Host</h3></div></div></div><p>Host is a machine running instance of qemu-kvm.</p></div><div class="section" title="Guest"><div class="titlepage"><div><div><h3 class="title"><a name="guest"></a>Guest</h3></div></div></div><p>Guest is a virtual machine hosted on <a class="link" href="ch03.html#host" title="Host">host</a> which will be accessed by using spice client.</p></div><div class="section" title="Client"><div class="titlepage"><div><div><h3 class="title"><a name="client"></a>Client</h3></div></div></div><p>Client is reffering to a system running spice client (e.g. spicec or spicy).</p></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch02s02.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="ch03s02.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Building Spice in Generic Linux </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Launching qemu</td></tr></table></div></body></html>
\ No newline at end of file diff --git a/books/html/ch03s02.html b/books/html/ch03s02.html index 0d37771..93c7b45 100644 --- a/books/html/ch03s02.html +++ b/books/html/ch03s02.html @@ -1,6 +1,6 @@ <html><head> <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> - <title>Launching qemu</title><meta name="generator" content="DocBook XSL-NS Stylesheets V1.76.1"><link rel="home" href="index.html" title="Spice User Guide"><link rel="up" href="ch03.html" title="Chapter 3. Spice basics"><link rel="prev" href="ch03.html" title="Chapter 3. Spice basics"><link rel="next" href="ch04.html" title="Chapter 4. References"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Launching qemu</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch03.html">Prev</a> </td><th width="60%" align="center">Chapter 3. Spice basics</th><td width="20%" align="right"> <a accesskey="n" href="ch04.html">Next</a></td></tr></table><hr></div><div class="section" title="Launching qemu"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="qemu_basics"></a>Launching qemu</h2></div></div></div><p>I'll use qemu-kvm as a name for the executable. If you're using manually built qemu or + <title>Launching qemu</title><meta name="generator" content="DocBook XSL-NS Stylesheets V1.76.1"><link rel="home" href="index.html" title="Spice User Manual"><link rel="up" href="ch03.html" title="Chapter 3. Spice basics"><link rel="prev" href="ch03.html" title="Chapter 3. Spice basics"><link rel="next" href="ch04.html" title="Chapter 4. References"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Launching qemu</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch03.html">Prev</a> </td><th width="60%" align="center">Chapter 3. Spice basics</th><td width="20%" align="right"> <a accesskey="n" href="ch04.html">Next</a></td></tr></table><hr></div><div class="section" title="Launching qemu"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="qemu_basics"></a>Launching qemu</h2></div></div></div><p>I'll use qemu-kvm as a name for the executable. If you're using manually built qemu or qemu without kvm then just replace qemu-kvm with your own binary. I'll use host# client# guest# shell prompt notation to distinguish wherever should be the command executed. See section <a class="link" href="definitions" target="_top">Basic Definitions</a> to be sure that you know @@ -15,4 +15,11 @@ So we already have image created and shall now start with image popullation. I assume that you have locally stored ISO of your favourite operating system so you can use it for installation. </p><pre class="screen">host# sudo qemu-kvm -boot order=dc -vga qxl -spice port=3001,disable-ticketing -soundhw ac97 \ --cdrom /path/to/your.iso /path/to/your.img</pre></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch03.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ch03.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="ch04.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 3. Spice basics </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 4. References</td></tr></table></div></body></html>
\ No newline at end of file + -cdrom /path/to/your.iso /path/to/your.img</pre><p> + Let's take just briefly look trough used qemu options. Option -boot order=dc specifies that guest system + should try to boot from first cdrom and then fallback to first disk, -vga qxl specifies that qemu should + emulate qxl device adapter. + </p><p> + There will be no running <a class="link" href="SpiceUserManual-Introduction.xml#vdagent" target="_top">agent</a> + on the <a class="link" href="guest" target="_top">guest</a> system so we don't have to emulate virtio device yet. + </p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch03.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ch03.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="ch04.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 3. Spice basics </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 4. References</td></tr></table></div></body></html>
\ No newline at end of file diff --git a/books/html/ch04.html b/books/html/ch04.html index 457de2f..ad1aaa2 100644 --- a/books/html/ch04.html +++ b/books/html/ch04.html @@ -1,3 +1,3 @@ <html><head> <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> - <title>Chapter 4. References</title><meta name="generator" content="DocBook XSL-NS Stylesheets V1.76.1"><link rel="home" href="index.html" title="Spice User Guide"><link rel="up" href="index.html" title="Spice User Guide"><link rel="prev" href="ch03s02.html" title="Launching qemu"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter 4. References</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch03s02.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> </td></tr></table><hr></div><div class="chapter" title="Chapter 4. References"><div class="titlepage"><div><div><h2 class="title"><a name="d0e453"></a>Chapter 4. References</h2></div></div></div><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p><a name="spice_protocol_defs"></a>Spice remote computing protocol definition</p></li></ol></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch03s02.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> </td></tr><tr><td width="40%" align="left" valign="top">Launching qemu </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> </td></tr></table></div></body></html>
\ No newline at end of file + <title>Chapter 4. References</title><meta name="generator" content="DocBook XSL-NS Stylesheets V1.76.1"><link rel="home" href="index.html" title="Spice User Manual"><link rel="up" href="index.html" title="Spice User Manual"><link rel="prev" href="ch03s02.html" title="Launching qemu"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter 4. References</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch03s02.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> </td></tr></table><hr></div><div lang="" class="chapter" title="Chapter 4. References"><div class="titlepage"><div><div><h2 class="title"><a name="d0e463"></a>Chapter 4. References</h2></div></div></div><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p><a name="spice_protocol_defs"></a>Spice remote computing protocol definition</p></li></ol></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch03s02.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> </td></tr><tr><td width="40%" align="left" valign="top">Launching qemu </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> </td></tr></table></div></body></html>
\ No newline at end of file diff --git a/books/html/index.html b/books/html/index.html index 9022e1b..0bfcf92 100644 --- a/books/html/index.html +++ b/books/html/index.html @@ -1,6 +1,6 @@ <html><head> <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> - <title>Spice User Guide</title><meta name="generator" content="DocBook XSL-NS Stylesheets V1.76.1"><link rel="home" href="index.html" title="Spice User Guide"><link rel="next" href="ch01.html" title="Chapter 1. Introduction"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Spice User Guide</th></tr><tr><td width="20%" align="left"> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="ch01.html">Next</a></td></tr></table><hr></div><div class="book" title="Spice User Guide"><div class="titlepage"><div><div><h1 class="title"><a name="d0e2"></a>Spice User Guide</h1></div><div><div class="authorgroup"><div class="author"><h3 class="author">Lubos Kocman</h3><code class="email"><<a class="email" href="mailto:lkocman@redhat.com">lkocman@redhat.com</a>></code></div><div class="author"><h3 class="author">Arnon Giloba</h3><code class="email"><<a class="email" href="mailto:agiloba@redhat.com">agiloba@redhat.com</a>></code></div><div class="author"><h3 class="author">Yaniv Kamay</h3><code class="email"><<a class="email" href="mailto:ykamay@redhat.com">ykamay@redhat.com</a>></code></div></div></div><div><p class="releaseinfo">Draft 54</p></div><div><p class="copyright">Copyright © 2009, 2010, 2011 Red Hat, Inc.</p></div><div><div class="legalnotice" title="Legal Notice"><a name="d0e31"></a><p> + <title>Spice User Manual</title><meta name="generator" content="DocBook XSL-NS Stylesheets V1.76.1"><link rel="home" href="index.html" title="Spice User Manual"><link rel="next" href="ch01.html" title="Chapter 1. Introduction"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Spice User Manual</th></tr><tr><td width="20%" align="left"> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="ch01.html">Next</a></td></tr></table><hr></div><div lang="en" class="book" title="Spice User Manual"><div class="titlepage"><div><div><h1 class="title"><a name="d0e2"></a>Spice User Manual</h1></div><div><div class="authorgroup"><div class="author"><h3 class="author">Lubos Kocman</h3><code class="email"><<a class="email" href="mailto:lkocman@redhat.com">lkocman@redhat.com</a>></code></div><div class="author"><h3 class="author">Arnon Giloba</h3><code class="email"><<a class="email" href="mailto:agiloba@redhat.com">agiloba@redhat.com</a>></code></div><div class="author"><h3 class="author">Yaniv Kamay</h3><code class="email"><<a class="email" href="mailto:ykamay@redhat.com">ykamay@redhat.com</a>></code></div></div></div><div><p class="releaseinfo">Draft 54</p></div><div><p class="copyright">Copyright © 2009, 2010, 2011 Red Hat, Inc.</p></div><div><div class="legalnotice" title="Legal Notice"><a name="d0e31"></a><p> Licensed under a Creative Commons Attribution-Share Alike 3.0 United States License (see <a class="link" href="http://creativecommons.org/licenses/by-sa/3.0/us/legalcode" target="_top">http://creativecommons.org/licenses/by-sa/3.0/us/legalcode</a>). - </p></div></div></div><hr></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="chapter"><a href="ch01.html">1. Introduction</a></span></dt><dd><dl><dt><span class="section"><a href="ch01.html#d0e69">Spice and Spice-related Compoments</a></span></dt><dd><dl><dt><span class="section"><a href="ch01.html#spice_server">Spice Server</a></span></dt><dt><span class="section"><a href="ch01.html#spice_client">Spice Client</a></span></dt><dt><span class="section"><a href="ch01.html#d0e82">QXL Device and Drivers</a></span></dt><dt><span class="section"><a href="ch01.html#d0e87">VDI Port Device</a></span></dt><dt><span class="section"><a href="ch01.html#d0e92">Spice Agent</a></span></dt></dl></dd><dt><span class="section"><a href="ch01s02.html">Features</a></span></dt><dd><dl><dt><span class="section"><a href="ch01s02.html#multiple_channels">Multiple Channels</a></span></dt><dt><span class="section"><a href="ch01s02.html#image_compression">Image Compression</a></span></dt><dt><span class="section"><a href="ch01s02.html#video_compression">Video Compression</a></span></dt><dt><span class="section"><a href="ch01s02.html#mouse_modes">Mouse modes</a></span></dt><dt><span class="section"><a href="ch01s02.html#other_features">Other Features</a></span></dt></dl></dd></dl></dd><dt><span class="chapter"><a href="ch02.html">2. Installation</a></span></dt><dd><dl><dt><span class="section"><a href="ch02.html#rhel_fedora">Installing Spice in RHEL or Fedora </a></span></dt><dd><dl><dt><span class="section"><a href="ch02.html#d0e207">RHEL >=6 and Fedora >=13</a></span></dt><dt><span class="section"><a href="ch02.html#d0e220">RHEL 5</a></span></dt><dt><span class="section"><a href="ch02.html#d0e230">RHEVM Users</a></span></dt></dl></dd><dt><span class="section"><a href="ch02s02.html">Building Spice in Generic Linux</a></span></dt><dd><dl><dt><span class="section"><a href="ch02s02.html#req_client">Client requirements</a></span></dt><dt><span class="section"><a href="ch02s02.html#req_host">Host requirements</a></span></dt><dt><span class="section"><a href="ch02s02.html#d0e312">Guest requirements</a></span></dt><dt><span class="section"><a href="ch02s02.html#d0e397">Setting up PATH</a></span></dt></dl></dd></dl></dd><dt><span class="chapter"><a href="ch03.html">3. Spice basics</a></span></dt><dd><dl><dt><span class="section"><a href="ch03.html#definitions">Basic Definitions</a></span></dt><dd><dl><dt><span class="section"><a href="ch03.html#host">Host</a></span></dt><dt><span class="section"><a href="ch03.html#guest">Guest</a></span></dt><dt><span class="section"><a href="ch03.html#client">Client</a></span></dt></dl></dd><dt><span class="section"><a href="ch03s02.html">Launching qemu</a></span></dt></dl></dd><dt><span class="chapter"><a href="ch04.html">4. References</a></span></dt></dl></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="ch01.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"> </td><td width="20%" align="center"> </td><td width="40%" align="right" valign="top"> Chapter 1. Introduction</td></tr></table></div></body></html>
\ No newline at end of file + </p></div></div></div><hr></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="chapter"><a href="ch01.html">1. Introduction</a></span></dt><dd><dl><dt><span class="section"><a href="ch01.html#d0e69">Spice and Spice-related Compoments</a></span></dt><dd><dl><dt><span class="section"><a href="ch01.html#spice_server">Spice Server</a></span></dt><dt><span class="section"><a href="ch01.html#spice_client">Spice Client</a></span></dt><dt><span class="section"><a href="ch01.html#d0e82">QXL Device and Drivers</a></span></dt><dt><span class="section"><a href="ch01.html#d0e87">VDI Port Device</a></span></dt><dt><span class="section"><a href="ch01.html#vdagent">Spice Agent</a></span></dt></dl></dd><dt><span class="section"><a href="ch01s02.html">Features</a></span></dt><dd><dl><dt><span class="section"><a href="ch01s02.html#multiple_channels">Multiple Channels</a></span></dt><dt><span class="section"><a href="ch01s02.html#image_compression">Image Compression</a></span></dt><dt><span class="section"><a href="ch01s02.html#video_compression">Video Compression</a></span></dt><dt><span class="section"><a href="ch01s02.html#mouse_modes">Mouse modes</a></span></dt><dt><span class="section"><a href="ch01s02.html#other_features">Other Features</a></span></dt></dl></dd></dl></dd><dt><span class="chapter"><a href="ch02.html">2. Installation</a></span></dt><dd><dl><dt><span class="section"><a href="ch02.html#rhel_fedora">Installing Spice in RHEL or Fedora </a></span></dt><dd><dl><dt><span class="section"><a href="ch02.html#d0e207">RHEL >=6 and Fedora >=13</a></span></dt><dt><span class="section"><a href="ch02.html#d0e220">RHEL 5</a></span></dt><dt><span class="section"><a href="ch02.html#d0e230">RHEVM Users</a></span></dt></dl></dd><dt><span class="section"><a href="ch02s02.html">Building Spice in Generic Linux</a></span></dt><dd><dl><dt><span class="section"><a href="ch02s02.html#req_client">Client requirements</a></span></dt><dt><span class="section"><a href="ch02s02.html#req_host">Host requirements</a></span></dt><dt><span class="section"><a href="ch02s02.html#d0e312">Guest requirements</a></span></dt><dt><span class="section"><a href="ch02s02.html#d0e397">Setting up PATH</a></span></dt></dl></dd></dl></dd><dt><span class="chapter"><a href="ch03.html">3. Spice basics</a></span></dt><dd><dl><dt><span class="section"><a href="ch03.html#definitions">Basic Definitions</a></span></dt><dd><dl><dt><span class="section"><a href="ch03.html#host">Host</a></span></dt><dt><span class="section"><a href="ch03.html#guest">Guest</a></span></dt><dt><span class="section"><a href="ch03.html#client">Client</a></span></dt></dl></dd><dt><span class="section"><a href="ch03s02.html">Launching qemu</a></span></dt></dl></dd><dt><span class="chapter"><a href="ch04.html">4. References</a></span></dt></dl></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="ch01.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"> </td><td width="20%" align="center"> </td><td width="40%" align="right" valign="top"> Chapter 1. Introduction</td></tr></table></div></body></html>
\ No newline at end of file diff --git a/books/pdf/SpiceUserManual.pdf b/books/pdf/SpiceUserManual.pdf Binary files differindex 5474894..4fe23d0 100644 --- a/books/pdf/SpiceUserManual.pdf +++ b/books/pdf/SpiceUserManual.pdf |