SYNOPSIS

synergyc [ --crypto-pass password ] [ -d level | --debug level ] [ --display display ] [ --daemon | { --no-daemon | -f } ] [ -l log-file | --log log-file ] [ -n name | --name name ] [ --no-tray ] [ --no-xinitthreads ] [ --restart | { --no-restart | -1 } ] [ --yscroll delta ] address

synergyc { --help | -h }

synergyc --version

DESCRIPTION

Starts the synergyc mouse/keyboard sharing client.

This manual page was written for the Debian distribution because the original program does not have a manual page.

OPTIONS

--crypto-pass password

use password as the password for authenticating to the synergy server.

-d level --debug level

use debugging level level.

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.

--display display

connect to the X server at display

--daemon

run the client as a daemon.

-f --no-daemon

run in client the foreground.

-l log-file --log log-file

write log messages to log-file

-n screen-name --name screen-name

use screen-name instead of the hostname.

This option lets the client use a name other than its hostname for its screen. This name is used when checking the configuration.

--no-tray

disable the system tray icon.

--no-xinitthreads

disable Xlib threading support.

This option may fix some crashing issues with Synergy.

--restart

restart the client automatically if it fails.

-1 --no-restart

do not try to restart the client if it fails for some reason.

--yscroll delta

set the vertical scrolling delta to delta. If this option is not given, the default vertical scrolling delta is 120.

-h --help

display help and exit.

--version

display version information and exit.

address

address of server.

address has one of the following forms:

hostname

hostname:port

hostname is a hostname or address of a network interface on the server system. port is a port number from 1 to 65535. port defaults to 24800.

RUNNING THE CLIENT

Run the client on all computers that aren't the server using the following command line:

synergyc -f server-hostname

Replace server-hostname 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 screen-name' to the command line, where screen-name is a name in the configuration file.

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.

If the client fails and exits it should print an error describing the problem. Here are typical problems and possible solutions:

failed to open screen:

check permission to open the X display

check that the DISPLAY environment variable is set

already connected:

check that the synergy client isn't already running

refused client:

add client to the server's configuration file

connection failed:

check server-hostname

the server cannot open the desired port, stop the program using that port (24800) and restart the server

Once all the clients are running, try moving the mouse to each screen. Be sure to check all the configured links.

STARTING AUTOMATICALLY

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:

pkill synergyc

synergyc [ options ] server-hostname

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 `/usr/bin/synergyc server-hostname' as the startup command.

options 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.

BUGS

The --crypto-pass option uses new cryptography code that is not well-tested, and has been known to contain security flaws. See the synergys(1) man page, under NETWORK SECURITY and BUGS, for a discussion of the security provided and potential alternatives.

RELATED TO synergyc…

AUTHOR

This manual page was written by Daniel Lutz <[email protected]> for the Debian system. Edited by Titus Barik <[email protected]> and Jeff Licquia <[email protected]>.