SYNERGYC(1)						      General Commands Manual						       SYNERGYC(1)

NAME

       synergyc -- synergy client

SYNOPSIS

       synergyc  [-d level  | --debug level ]  [--display display ]  [--daemon	| { --no-daemon | -f } ]  [-n name  | --name name ]  [--restart  |
       { --no-restart | -1 } ] 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.  Slightly old documenta-
       tion exists in /usr/share/doc/synergy/obsolete/index.html; it is the most up-to-date information available, despite the pathname.

OPTIONS

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

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

       --restart restart the client automatically if it fails.

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

       -h	    --help
		 display help and exit.

       --version display version information and exit.

       address	 address of server.

		 address has one of the following forms:

		    o  hostname

		    o  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:

	  o  failed to open screen:

		 check permission to open the X display

		 check that the DISPLAY environment variable is set

	  o  already connected:

		 check that the synergy client isn't already running

	  o  refused client:

		 add client to the server's configuration file

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

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

																       SYNERGYC(1)