xspice: README, TODO, config, xspice launcher script

xspice is placed under scripts, adding a new Makefile.am, only
installed if --enable-xspice.
spiceqxl.xorg.conf.example is placed under examples to be installed
to share/doc if --enable-xspice.

2 files changed, 125 insertions, 0 deletions

diff --git a/examples/Makefile.am b/examples/Makefile.am
new file mode 100644
index 0000000..75e61ea
--- /dev/null
+++ b/examples/Makefile.am
@@ -0,0 +1,24 @@
+#  Copyright 2011 Red Hat, Inc.
+#
+#  Permission is hereby granted, free of charge, to any person obtaining a
+#  copy of this software and associated documentation files (the "Software"),
+#  to deal in the Software without restriction, including without limitation
+#  on the rights to use, copy, modify, merge, publish, distribute, sub
+#  license, and/or sell copies of the Software, and to permit persons to whom
+#  the Software is furnished to do so, subject to the following conditions:
+#
+#  The above copyright notice and this permission notice (including the next
+#  paragraph) shall be included in all copies or substantial portions of the
+#  Software.
+#
+#  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+#  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+#  FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT.  IN NO EVENT SHALL
+#  THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+#  IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+#  CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+if BUILD_XSPICE
+doc_DATA = spiceqxl.xorg.conf.example
+endif
+EXTRA_DIST = spiceqxl.xorg.conf.example
diff --git a/examples/spiceqxl.xorg.conf.example b/examples/spiceqxl.xorg.conf.example
new file mode 100644
index 0000000..5e37f9c
--- /dev/null
+++ b/examples/spiceqxl.xorg.conf.example
@@ -0,0 +1,101 @@
+Section "Device"
+    Identifier "XSPICE"
+    Driver "spiceqxl"
+
+    # Enable regular port. Either this or SpiceTlsPort, or one of XSPICE_PORT or
+    # XSPICE_TLS_PORT environment variables must be specified
+    # Defaults to 5900.
+    #Option "SpicePort" "5900"
+
+    # Enable a TLS (encrypted) port. Either this or SpicePort must be specified,
+    # either here or via environment varialbes or via xspice --port or --tls-port
+    #Option "SpiceTlsPort" "5901"
+    
+    # Listen to a specific inteface. Default is to listen to all (0.0.0.0)
+    #Option "SpiceAddr" ""
+
+    # Enable usage of SASL supported by spice-gtk client. Not required,
+    # defaults to false.
+    #Option "SpiceSasl" "True"
+
+    # Do not request any password from client
+    #Option "SpiceDisableTicketing" "0"
+
+    # Set directory where cacert, server key and server cert are searched
+    # using the same predefined names qemu uses:
+    #   cacert.pem, server-key.pem, server-cert.pem
+    #Option "SpiceX509Dir" ""
+
+    # Set password client will be required to produce.
+    #Option "SpicePassword" ""
+
+    # Set spice server key file.
+    #Option "SpiceX509KeyFile" ""
+
+    # Set streaming video method. Options are filter, off, all
+    # defaults to filter.
+    #Option "SpiceStreamingVideo" ""
+
+    # Set zlib glz wan compression. Options are auto, never, always.
+    # defaults to auto.
+    #Option "SpiceZlibGlzWanCompression" ""
+
+    # Set jpeg wan compression. Options are auto, never, always
+    # defaults to auto.
+    #Option "SpiceJpegWanCompression" ""
+
+    # Set image compression. Options are off,auto_glz,auto_lz,quic,glz,lz.
+    # defaults to auto_glz.
+    #Option "SpiceImageCompression" ""
+
+    # Set to true to only listen on ipv4 interfaces.
+    # defaults to false.
+    #Option "SpiceIPV4Only" ""
+
+    # Set to true to only listen on ipv6 interfaces.
+    # defaults to false.
+    #Option "SpiceIPV6Only" ""
+
+    # Set cert file location.
+    #Option "SpiceX509CertFile" ""
+
+    # Set key file password.
+    #Option "SpiceX509KeyPassword" ""
+
+    # Set tls ciphers used.
+    #Option "SpiceTlsCiphers" ""
+
+    # Set cacert file.
+    #Option "SpiceCacertFile" ""
+
+    # Set dh file used.
+    #Option "SpiceDhFile" ""
+EndSection
+
+Section "InputDevice"
+    Identifier "XSPICE POINTER"
+    Driver     "xspice pointer"
+EndSection
+
+Section "InputDevice"
+    Identifier "XSPICE KEYBOARD"
+    Driver     "xspice keyboard"
+EndSection
+
+Section "Monitor"
+    Identifier    "Configured Monitor"
+EndSection
+
+Section "Screen"
+    Identifier     "XSPICE Screen"
+    Monitor        "Configured Monitor"
+    Device        "XSPICE"
+    DefaultDepth    24
+EndSection
+
+Section "ServerLayout"
+    Identifier "XSPICE Example"
+    Screen "XSPICE Screen"
+    InputDevice "XSPICE KEYBOARD"
+    InputDevice "XSPICE POINTER"
+EndSection