--- synergy-plus-1.3.4.orig/debian/synergy-plus.doc-base +++ synergy-plus-1.3.4/debian/synergy-plus.doc-base @@ -0,0 +1,9 @@ +Document: synergy +Title: Debian synergy Manual +Author: Chris Schoeneman +Abstract: How to set up and use synergy to control multiple displays. +Section: Screen + +Format: HTML +Index: /usr/share/doc/synergy-plus/obsolete/index.html +Files: /usr/share/doc/synergy-plus/obsolete/*.html --- synergy-plus-1.3.4.orig/debian/watch +++ synergy-plus-1.3.4/debian/watch @@ -0,0 +1,6 @@ +version=3 + +opts=\ +downloadurlmangle=s|.*[?]name=(.*?)&.*|http://synergy-plus.googlecode.com/files/$1|,\ +filenamemangle=s|[^/]+[?]name=(.*?)&.*|$1| \ +http://code.google.com/p/synergy-plus/downloads/detail[?]name=synergy-plus-([0-9.]+).tar.gz&.* --- synergy-plus-1.3.4.orig/debian/changelog +++ synergy-plus-1.3.4/debian/changelog @@ -0,0 +1,6 @@ +synergy-plus (1.3.4-0~jaunty2) jaunty; urgency=low + + * Initial release. + + -- Clément Lorteau Thu, 17 Jun 2010 22:38:54 +0200 + --- synergy-plus-1.3.4.orig/debian/rules +++ synergy-plus-1.3.4/debian/rules @@ -0,0 +1,5 @@ +#!/usr/bin/make -f +# -*- makefile -*- + +%: + dh $@ --- synergy-plus-1.3.4.orig/debian/manpages +++ synergy-plus-1.3.4/debian/manpages @@ -0,0 +1,2 @@ +debian/synergyc.1 +debian/synergys.1 --- synergy-plus-1.3.4.orig/debian/copyright +++ synergy-plus-1.3.4/debian/copyright @@ -0,0 +1,29 @@ +This work was packaged for Debian by: + + Clément Lorteau on Wed, 16 Jun 2010 23:47:09 +0200 + +It was downloaded from: + + http://code.google.com/p/synergy-plus/downloads/list + +Upstream Author(s): + + Sorin Sbarnea + Nick Bolton + Chris Schoeneman + Syed Amer Gilani + +Copyright: + + Copyright (C) 2002-2007 Chris Schoeneman + +License: + + GPL version 2 + +The Debian packaging is: + + Copyright (C) 2010 Clément Lorteau + +and is licensed under the GPL version 2, +see "/usr/share/common-licenses/GPL-2". --- synergy-plus-1.3.4.orig/debian/synergyc.1 +++ synergy-plus-1.3.4/debian/synergyc.1 @@ -0,0 +1,155 @@ +.TH "SYNERGYC" "1" +.SH "NAME" +synergyc \(em Synergy+ client +.SH "SYNOPSIS" +.PP +\fBsynergyc\fR [\-d \fIlevel\fR | \-\-debug \fIlevel\fR ] [\-\-display \fIdisplay\fR ] [\-\-daemon | { \-\-no-daemon | \-f } ] [\-n \fIname\fR | \-\-name \fIname\fR ] [\-\-restart | { \-\-no-restart | \-1 } ] \fIaddress\fR +.PP +\fBsynergyc\fR { \-\-help | \-h } +.PP +\fBsynergyc\fR \-\-version +.SH "DESCRIPTION" +.PP +Starts the \fBsynergyc\fP mouse/keyboard sharing client. +.SH "OPTIONS" +.IP "\fB-d \fIlevel\fR\fP \fB\-\-debug \fIlevel\fR\fP " 10 +use debugging level \fIlevel\fR. +.IP "" 10 +Debug levels are from highest to lowest: FATAL, +ERROR, WARNING, NOTE, INFO, DEBUG, DEBUG1, and DEBUG2. +Only messages at or above the given level are logged. +Messages are logged to a terminal window when running in +the foreground, and to syslog when running as a daemon. +.IP "\fB\-\-display \fIdisplay\fR\fP " 10 +connect to the X server at \fIdisplay\fR +.IP "\fB\-\-daemon\fP " 10 +run the client as a daemon. +.IP "\fB-f\fP \fB\-\-no-daemon\fP " 10 +run in client the foreground. +.IP "\fB-n \fIscreen-name\fR\fP \fB\-\-name \fIscreen-name\fR\fP " 10 +use \fIscreen-name\fR instead of +the hostname. +.IP "" 10 +This option lets the client use a name other than its +hostname for its screen. This name is used when checking +the configuration. +.IP "\fB\-\-restart\fP " 10 +restart the client automatically if it fails. +.IP "\fB-1\fP \fB\-\-no-restart\fP " 10 +do not try to restart the client if it fails for some +reason. +.IP "\fB-h\fP \fB\-\-help\fP " 10 +display help and exit. +.IP "\fB\-\-version\fP " 10 +display version information and exit. +.IP "\fB\fIaddress\fR\fP " 10 +address of server. +.IP "" 10 +\fIaddress\fR has one of the +following forms: + +.RS +.IP " \(bu" 6 +\fIhostname\fR +.IP " \(bu" 6 +\fIhostname\fR:\fIport\fR +.RE + +.IP "" 10 +\fIhostname\fR is a hostname or +address of a network interface on the server +system. \fIport\fR is a port number +from 1 to 65535. \fIport\fR defaults +to 24800. +.SH "RUNNING THE CLIENT" +.PP +Run the client on all computers that aren't the server using +the following command line: + + +.PP +\fBsynergyc \fR-f \fIserver-hostname\fR + +Replace \fIserver-hostname\fR with the +hostname or address of the server system. The `\-f' option causes +synergy to run in the foreground. This option is recommended until +you've verified that the configuration works. +If you didn't include the system's +hostname in the configuration file (either as a screen name or +an alias) then you'll have to add `\-\-name +\fIscreen-name\fR' to the command line, +where \fIscreen-name\fR is a name in the +configuration file. + +.PP +The client should quickly report `connected to server'. If it +does not but doesn't print an error and exit immediately then +it's trying to connect to the server but cannot. It will time +out in 30 seconds and exit (use ctrl+c to exit earlier). You +should check that the server is running and is reachable over +the network and try again. + +.PP +If the client fails and exits it should print an error describing +the problem. Here are typical problems and possible solutions: + +.IP " \(bu" 6 +failed to open screen: +.IP "" 10 +check permission to open the X display +.IP "" 10 +check that the DISPLAY environment variable is set +.IP " \(bu" 6 +already connected: +.IP "" 10 +check that the synergy client isn't already running +.IP " \(bu" 6 +refused client: +.IP "" 10 +add client to the server's configuration file +.IP " \(bu" 6 +connection failed: +.IP "" 10 +check \fIserver-hostname\fR +.IP "" 10 +the server cannot open the desired port, stop the +program using that port (24800) and restart the +server +.PP +Once all the clients are running, try moving the mouse to each +screen. Be sure to check all the configured links. + +.SH "STARTING AUTOMATICALLY" +.PP +Synergy+ requires an X server. That means a server must be +running and synergy must be authorized to connect to that server. +I recommend to start the synergy client from a start script +of your desktop environment or window manager. The commands +should look something like this: +.PP +\fBpkill synergyc\fR +.PP +\fBsynergyc\fR [\fIoptions\fR] \fIserver-hostname\fR +.PP +If you are using GNOME, you can add the synergy client to the +list of the non-session-managed startup programs. For doing this, +start the control center, choose `Session Properties & Startup' +and then `Startup Programs'. Add a new entry with `\fB/usr/bin/synergyc +\fIserver-hostname\fR\fR' as the startup command. + +.PP +\fIoptions\fR must not include `\-f' or `\-\-no-daemon'. +It's important to make sure no old copies of synergy are running so they +can't interfere with the new one. + +.SH "SEE ALSO" +.PP +synergys(1) +.SH "HOMEPAGE" +.PP +Visit \fIhttp://http://code.google.com/p/synergy-plus/\fR for more details. +.SH "AUTHOR" +.PP +This manual page was written by Daniel Lutz for +the \fBDebian\fP system, \fBsynergy\fP package. Edited by Titus Barik and Clément Lorteau . +.\" created by instant / docbook-to-man, Fri 08 May 2009, 22:07 --- synergy-plus-1.3.4.orig/debian/synergys.1 +++ synergy-plus-1.3.4/debian/synergys.1 @@ -0,0 +1,417 @@ +.TH "SYNERGYS" "1" +.SH "NAME" +synergys \(em Synergy+ server +.SH "SYNOPSIS" +.PP +\fBsynergys\fR [\-a \fIaddress\fR | \-\-address \fIaddress\fR ] [\-c \fIpathname\fR | \-\-config \fIpathname\fR ] [\-d \fIlevel\fR | \-\-debug \fIlevel\fR ] [\-\-display \fIdisplay\fR ] [\-\-daemon | { \-\-no-daemon | \-f } ] [\-n \fIscreen-name\fR | \-\-name \fIscreen-name\fR ] [\-\-restart | { \-\-no-restart | \-1 } ] \fIaddress\fR +.PP +\fBsynergys\fR { \-h | \-\-help } +.PP +\fBsynergys\fR \-\-version +.SH "DESCRIPTION" +.PP +Starts the \fBsynergys\fP mouse/keyboard +sharing server. + +.PP +\fBSynergy+\fP lets you use one keyboard and +mouse across multiple computers. To do so it requires that all +the computers are connected to each other via TCP/IP +networking. Most systems come with this installed. + +.SH "OPTIONS" +.IP " \fB-a \fIaddress\fR\fP \fB\-\-address \fIaddress\fR\fP " 10 +listen for clients on the given address. +.IP "" 10 +The argument for \-\-address is of the form: +[\fIhostname\fR][:\fIport\fR]. +The hostname must be the address or hostname of an +interface on the system. The default is to listen on all +interfaces. The port overrides the default port, 24800. + +.IP "\fB-c \fIpathname\fR\fP \fB\-\-config \fIpathname\fR\fP " 10 +use the named configuration file instead. +.IP "" 10 +If no configuration file pathname is provided then the first of the +following to load sets the configuration: + +.RS +.IP " \(bu" 6 +\fB~/.synergy.conf\fP +.IP " \(bu" 6 +\fB/etc/synergy.conf\fP +.RE + +.IP "" 10 +If no configuration file can be loaded then the +configuration uses its defaults with just the server +screen. + +.IP " \fB-d \fIlevel\fR\fP \fB\-\-debug \fIlevel\fR\fP " 10 +filter out log messages with priority below +\fIlevel\fR. +.IP "" 10 +Debug levels are from highest to lowest: FATAL, ERROR, +WARNING, NOTE, INFO, DEBUG, DEBUG1, and DEBUG2. Only +messages at or above the given level are logged. Messages +are logged to a terminal window when running in the +foreground, and to syslog when running as a daemon. + +.IP "\fB\-\-display \fIdisplay\fR\fP " 10 +connect to the X server at \fIdisplay\fR +.IP "\fB\-\-daemon\fP " 10 +run the server as a daemon. +.IP "\fB-f\fP \fB\-\-no-daemon\fP " 10 +run the server in the foreground. +.IP "\fB-n \fIscreen-name\fR\fP \fB\-\-name \fIscreen-name\fR\fP " 10 +use \fIscreen-name\fR instead of +the hostname to identify this screen in the +configuration. +.IP "" 10 +This option lets the client use +a name other than its hostname for its screen. + +.IP "\fB\-\-restart\fP " 10 +restart the server automatically if it fails. +.IP "\fB-1\fP \fB\-\-no-restart\fP " 10 +do not try to restart the server if it fails for some +reason. + +.IP "\fB-h\fP \fB\-\-help\fP " 10 +display help and exit. +.IP "\fB\-\-version\fP " 10 +display version information and exit. +.SH "CONFIGURING THE SERVER" +.PP +The synergy server requires configuration. The configuration +file is a plain text file broken into sections. Each section +has the form: + +.PP +.nf +section: +\ \ +end + +.fi +.PP +Comments are introduced by `#' and continue to the end of the +line. The file can have the following sections. The `screens' +section must appear before the `links' and `aliases' sections. + +.SS "screens" +.PP + is a list of screen names, one name per line, +each followed by a colon. Names are arbitrary strings but +they must be unique. The hostname of each computer is +recommended. There must be a screen name for the server and +each client. Each screen can specify a number of options. +Options have the form `name = value' and a listed one per line +after the screen name. + +.PP +Example: +.PP +.nf +section: screens +\ \ moe: +\ \ larry: +\ \ \ \ halfDuplexCapsLock = true +\ \ \ \ halfDuplexNumLock = true +\ \ curly: +\ \ \ \ meta = alt +end + +.fi +.PP +This declares three screens named: moe, larry, and curly. +Screen `larry' has half-duplex caps lock and num lock keys +(see below) and screen `curly' converts the meta modifier key +to the alt key. + +.PP +Screen can have the following options: +.IP " \(bu" 6 +halfDuplexCapsLock = {true|false} +.IP "" 10 +This computer has a caps lock key that doesn't report a +press and a release event when the user presses it but +instead reports a press event when it's turned on and a +release event when it's turned off. If caps lock acts +strangely on all screens then you may need this option on +the server screen. If it acts strangely on one screen +then that screen may need the option. + +.IP " \(bu" 6 +halfDuplexNumLock = {true|false} +.IP "" 10 +This is identical to halfDuplexCapsLock except it applies +to the num lock key. + +.IP " \(bu" 6 +xtestIsXineramaUnaware = {true|false} +.IP "" 10 +This option works around a bug in the XTest extension when +used in combination with Xinerama. It affects X11 clients +only. Not all versions of the XTest extension are aware +of the Xinerama extension. As a result, they do not move +the mouse correctly when using multiple Xinerama screens. +This option is currently true by default. If you know +your XTest extension is Xinerama aware then set this +option to false. + +.IP " \(bu" 6 +Modifier keys: +.RS +.IP "" 10 +shift = {shift|ctrl|alt|meta|super|none} +.IP "" 10 +ctrl = {shift|ctrl|alt|meta|super|none} +.IP "" 10 +alt = {shift|ctrl|alt|meta|super|none} +.IP "" 10 +meta = {shift|ctrl|alt|meta|super|none} +.IP "" 10 +super = {shift|ctrl|alt|meta|super|none} +.RE +.IP "" 10 +Map a modifier key pressed on the server's keyboard to a +different modifier on this client. This option only has +an effect on a client screen; it's accepted and ignored on +the server screen. + +.IP "" 10 +You can map, say, the shift key to shift (the default), +ctrl, alt, meta, super or nothing. Normally, you wouldn't +remap shift or ctrl. You might, however, have an X11 +server with meta bound to the Alt keys. To use this +server effectively with a windows client, which doesn't +use meta but uses alt extensively, you'll want the windows +client to map meta to alt (using `meta = alt'). + +.SS "links" +.PP + is a list of screen names just like in the +`screens' section except each screen is followed by a list +of links, one per line. Each link has the form +` = '. A link +indicates which screen is adjacent in the given direction. + +.PP +Example: +.PP +.nf +section: links +moe: +\ \ right = larry +\ \ up\ \ \ \ = curly +larry: +\ \ left = moe +\ \ up\ \ \ \ = curly +curly: +\ \ down\ \ = larry +end + +.fi +.PP +This indicates that screen `larry' is to the right of screen +`moe' (so moving the cursor off the right edge of moe would +make it appear at the left edge of larry), `curly' is above +`moe', `moe' is to the left of `larry', `curly' is above +`larry', and `larry' is below `curly'. Note that links do not +have to be symmetrical; moving up from moe then down from +curly lands the cursor on larry. + +.SS "aliases" +.PP + + is a list of screen names just like in the +`screens' section except each screen is followed by a list of +aliases, one per line *not* followed by a colon. An alias is +a screen name and must be unique. During screen name lookup +each alias is equivalent to the screen name it aliases. So a +client can connect using its canonical screen name or any of +its aliases. + +.PP +Example: +.PP +.nf +section: aliases +larry: +\ \ larry.stooges.com +curly: +\ \ shemp +end + +.fi +.PP +Screen `larry' is also known as `larry.stooges.com' and can +connect as either name. Screen `curly' is also known as +`shemp'. (Hey, it's just an example.) + +.SS "options" +.PP + is a list of lines of the form `name = +value'. These set the global options. + +.PP +Example: +.PP +.nf +section: options +\ heartbeat = 5000 +\ switchDelay = 500 +end + +.fi +.PP +You can use the following options: +.IP " \(bu" 6 +heartbeat = N +.IP "" 10 +The server will expect each client to send a message no +less than every N milliseconds. If no message arrives +from a client within 3N seconds the server forces that +client to disconnect. + +.IP "" 10 +If synergy fails to detect clients disconnecting while the +server is sleeping or vice versa, try using this option. + +.IP " \(bu" 6 +switchDelay = N +.IP "" 10 +Synergy+ won't switch screens when the mouse reaches the +edge of a screen unless it stays on the edge for N +milliseconds. This helps prevent unintentional switching +when working near the edge of a screen. + +.IP " \(bu" 6 +switchDoubleTap = N +.IP "" 10 +Synergy+ won't switch screens when the mouse reaches the +edge of a screen unless it's moved away from the edge and +then back to the edge within N milliseconds. With the +option you have to quickly tap the edge twice to switch. +This helps prevent unintentional switching when working +near the edge of a screen. + +.IP " \(bu" 6 +screenSaverSync = {true|false} +.IP "" 10 +If set to false then synergy won't synchronize screen +savers. Client screen savers will start according to +their individual configurations. The server screen saver +won't start if there is input, even if that input is +directed toward a client screen. + +.PP +The synergy server will try certain pathnames to load the +configuration file if the user doesn't specify a path using +the `\-\-config' command line option. `synergys \-\-help' reports +those pathnames. + +.SH "RUNNING THE SERVER" +.PP +Run the server on the computer that has the keyboard and mouse +to be shared. You must have prepared a configuration file +before starting the server. The server should be started before +the clients but that's not required. + +.PP +Run the synergy server on the server system using the following +command line: + +.PP +\fBsynergys\fR \-f [\-\-config \fIconfig-pathname\fR] +.PP +Replace \fIconfig-pathname\fR with the path +to the configuration file. See OPTIONS for the default locations +of the configuration file. The `\-f' option causes synergys to +run in the foreground. This is recommended until you've +verified that the configuration works. If you didn't include +the system's hostname in the configuration file (either as a +screen name or an alias) then you'll have to add `\-\-name +\fIscreen-name\fR' to the command line, +where \fIscreen-name\fR is a name in the +configuration file. You can use `synergys \-\-help' for a list of +command line options. + +.PP +See `Starting Automatically on Unix' below for running synergy +automatically when the X server starts. + +.SH "CONFIGURE SYNERGY+ TO START AUTOMATICALLY" +.PP +Synergy+ requires an X server. That means a server must be +running and synergy must be authorized to connect to that +server. It's best to have the display manager start +synergy+. You'll need the necessary (probably root) permission to +modify the display manager configuration files. If you don't +have that permission you can start synergy after logging in via +the .xsession file. + +.PP +To start the server use something like: + +.PP +\fBkillall \fRsynergys +.PP +\fBsynergys\fR [] \-\-config +.PP + must not include `\-f' or `\-\-no-daemon'. If the +configuration pathname is one of the default locations then you +don't need the `\-\-config' option. + +.PP +Note that some display managers (xdm and kdm, but not gdm) grab +the keyboard and do not release it until the user logs in, for +security reasons. This prevents a synergy server from sharing +the mouse and keyboard until the user logs in. + +.SH "NETWORK SECURITY" +.PP +Synergy+ has no built-in support for encryption or +authentication. The server accepts connections from any +computer. The server and clients send all data unencrypted +which means the clipboard and mouse and keyboard events +(e.g. typed passwords) are easily examined by anyone listening +on the network. Therefore, do not run synergy on untrusted +networks except as follows. + +.PP +You can use SSH (secure shell) to provide strong authentication +and encryption to synergy without modifying either SSH or synergy. +On Linux and Unix a free implementation of SSH called OpenSSH is +available at http://www.openssh.com/. On Windows you can use the +Cygwin version of OpenSSH. + +.PP +\fBssh \fR-f \-N \-L +24800:\fIserver-hostname\fR:24800 \fIserver-hostname\fR +.PP +where \fIserver-hostname\fR is the name or +address of the SSH and synergy server host. 24800 is the default +synergy port; replace it with whichever port you use if you don't use +the default. Once ssh authenticates with the server, start the +synergy client as usual except use `localhost' or `127.0.0.1' for the +server address. Synergy+ will then pass all communication through SSH +which encrypts it, passes it over the network, decrypts it, and hands +it back to synergy. Authentication is provided by SSH's +authentication. + +.SH "FILES" +.PP +~/.synergy.conf, /etc/synergy.conf +.SH "SEE ALSO" +.PP +synergyc(1), ssh(1) +.SH "HOMEPAGE" +.PP +Visit \fIhttp://http://code.google.com/p/synergy-plus/\fR for more details. +.SH "AUTHOR" +.PP +This manual page was written by Daniel Lutz for +the \fBDebian\fP system, \fBsynergy\fP package. Edited by Titus Barik and Clément Lorteau . +.\" created by instant / docbook-to-man, Fri 08 May 2009, 22:07 --- synergy-plus-1.3.4.orig/debian/control +++ synergy-plus-1.3.4/debian/control @@ -0,0 +1,22 @@ +Source: synergy-plus +Section: net +Priority: extra +Maintainer: Clément Lorteau +Build-Depends: debhelper (>= 7.0), autotools-dev, libxtst-dev +Standards-Version: 3.8.4 +Homepage: http://code.google.com/p/synergy-plus/ + +Package: synergy-plus +Architecture: any +Depends: ${shlibs:Depends}, ${misc:Depends} +Conflicts: synergy +Description: Share mouse, keyboard and clipboard over the network + Synergy+ (synergy-plus) lets you easily share a single mouse and keyboard + between multiple computers with different operating systems, without special + hardware. All you need is a LAN connection. It's intended for users with + multiple computers, where each system uses its own display. It's a little like + having a 2nd or a 3rd desktop... + . + Synergy+ is a fork of Synergy. It retains compatibility with existing + configuration files and is a drop-in replacement to synergy, but one which is + being maintained. --- synergy-plus-1.3.4.orig/debian/docs +++ synergy-plus-1.3.4/debian/docs @@ -0,0 +1,6 @@ +NEWS +README +AUTHORS +doc/PORTING +doc/obsolete + --- synergy-plus-1.3.4.orig/debian/compat +++ synergy-plus-1.3.4/debian/compat @@ -0,0 +1 @@ +7 --- synergy-plus-1.3.4.orig/debian/source/format +++ synergy-plus-1.3.4/debian/source/format @@ -0,0 +1 @@ +1.0