Provided by: synergy_1.8.8-stable+dfsg.1-1build1_amd64 
NAME
synergyc - synergy client
SYNOPSIS
synergyc [ --enable-crypto ] [ --enable-drag-drop ] [ -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 ] [ --profile-dir path ] [ --plugin-dir path ] address
synergyc { --help | -h }
synergyc --version
DESCRIPTION
Starts the synergyc mouse/keyboard sharing client. By default synergyc runs in the
background and restarts on failure.
Synergy 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.
This manual page was written for the Debian distribution because the original program does
not have a manual page.
OPTIONS
--enable-crypto
enables encryption. synergyc verifies the server fingerprint matches one available
in ~/SSL/Fingerprints/TrustedServers.txt
--enable-drag-drop
ignored option. Drag and drop is not supported on linux.
-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.
--profile-dir path
specify an alternate profile directory path. Default is ~/.synergy/
--plugin-dir path
specify an alternate plugin directory path. Default is ~/.synergy/plugins/
-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 -1 server-hostname
Replace server-hostname with the hostname or address of the server system. The `-f' option
causes synergy to run in the foreground. The `-1' option causes synergy to exit on
failure. These options are 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
• failed to verify server certificate fingerprint:
A matching fingerprint for the server was not found in the client's
~/.synergy/SSL/Fingerprints/TrustedServers.txt
Once all the clients are running, try moving the mouse to each screen. Be sure to check
all the configured links.
ENABLING CRYPTO
To connect to a synergy server with crypto enabled the client must have the server's
fingerprint in its trusted servers list: ~/.synergy/SSL/Fingerprints/TrustedServers.txt.
Run the client with the `--enable-crypto' option.
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.
FILES
~/.synergy/SSL/Fingerprints/TrustedServers.txt
SEE ALSO
synergys(1)
AUTHOR
This manual page was written by Daniel Lutz <danlutz@debian.org> for the Debian system.
Edited by Titus Barik <barik@ieee.org>, Jeff Licquia <licquia@debian.org>, and Joshua
Honeycutt <joshua.honeycutt@gmail.com>.
January 24, 2017 SYNERGYC(1)