other versions
- wheezy 1.3.8-2
- wheezy-backports 1.4.16-1~bpo70+1
- jessie 1.4.16-1+deb8u1
- testing 1.4.16-2
- unstable 1.4.16-2
- experimental 1.8.7-stable+dfsg.1-2
SYNERGYS(1) | General Commands Manual | SYNERGYS(1) |
NAME¶
synergys — synergy serverSYNOPSIS¶
synergys [-a address | --address address ] [-c pathname | --config pathname ] [-d level | --debug level ] [--display display ] [--daemon | { --no-daemon | -f } ] [-n screen-name | --name screen-name ] [--restart | { --no-restart | -1 } ] address synergys { -h | --help } synergys --versionDESCRIPTION¶
Starts the synergys mouse/keyboard sharing server.OPTIONS¶
- -a address --address address
- listen for clients on the given address.
- The argument for --address is of the form: [
hostname][: port]. 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.
- -c pathname --config pathname
- use the named configuration file instead.
- If no configuration file pathname is provided then the
first of the following to load sets the configuration:
- •
- ~/.synergy.conf
- •
- /etc/synergy.conf
- If no configuration file can be loaded then the
configuration uses its defaults with just the server screen.
- -d level --debug level
- filter out log messages with priority below 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 server as a daemon.
- -f --no-daemon
- run the server in the foreground.
- -n screen-name --name screen-name
- use screen-name instead of the hostname to identify this screen in the configuration.
- This option lets the client use a name other than its
hostname for its screen.
- --restart
- restart the server automatically if it fails.
- -1 --no-restart
- do not try to restart the server if it fails for some
reason.
- -h --help
- display help and exit.
- --version
- display version information and exit.
CONFIGURING THE SERVER¶
The synergy server requires configuration. The configuration file is a plain text file broken into sections. Each section has the form:section: <name> <args> endComments 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.
screens¶
<args> 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.section: screens moe: larry: halfDuplexCapsLock = true halfDuplexNumLock = true curly: meta = alt endThis 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.
- •
- halfDuplexCapsLock = {true|false}
- 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.
- •
- halfDuplexNumLock = {true|false}
- This is identical to halfDuplexCapsLock except it applies
to the num lock key.
- •
- xtestIsXineramaUnaware = {true|false}
- 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.
- •
- Modifier keys:
- shift = {shift|ctrl|alt|meta|super|none}
- ctrl = {shift|ctrl|alt|meta|super|none}
- alt = {shift|ctrl|alt|meta|super|none}
- meta = {shift|ctrl|alt|meta|super|none}
- super = {shift|ctrl|alt|meta|super|none}
- 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.
- 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').
links¶
<args> 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 `<left|right|up|down> = <name>'. A link indicates which screen is adjacent in the given direction.section: links moe: right = larry up = curly larry: left = moe up = curly curly: down = larry endThis 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.
aliases¶
section: aliases larry: larry.stooges.com curly: shemp endScreen `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.)
options¶
<args> is a list of lines of the form `name = value'. These set the global options.section: options heartbeat = 5000 switchDelay = 500 endYou can use the following options:
- •
- heartbeat = N
- 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.
- If synergy fails to detect clients disconnecting while the
server is sleeping or vice versa, try using this option.
- •
- switchDelay = N
- 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.
- •
- switchDoubleTap = N
- 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.
- •
- screenSaverSync = {true|false}
- 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.