CSYNC2(1)						      General Commands Manual							 CSYNC2(1)

NAME

       csync2 - cluster synchronization tool, 2nd generation

SYNOPSIS

       csync2 [-v..] [-C config-name] [-D database-dir] [-N hostname] [-p port]...

DESCRIPTION

       This manual page documents briefly the csync2 command.
       A verbose manual can be found on the csync2 homepage:

	      http://oss.linbit.com/csync2/paper.pdf

       csync2 is a program for cluster synchronization.

OPTIONS

       With file parameters:

       -h [-r] file..
	      Add (recursive) hints for check to db

       -c [-r] file..
	      Check files and maybe add to dirty db

       -u [-d] [-r] file..
	      Updates files if listed in dirty db

       -f file..
	      Force this file in sync (resolve conflict)

       -m file..
	      Mark files in database as dirty

       Simple mode:

       -x [-d] [[-r] file..]
	      Run checks for all given files and update remote hosts.

       Without file parameters:

       -c     Check all hints in db and eventually mark files as dirty

       -u [-d]
	      Update (transfer dirty files to peers and mark as clear)

       -H     List all pending hints from status db

       -L     List all file-entries from status db

       -M     List all dirty files from status db

       -S myname peername
	      List file-entries from status db for this synchronization pair.

       -T     Test if everything is in sync with all peers.

       -T filename
	      Test if this file is in sync with all peers.

       -T myname peername
	      Test if this synchronization pair is in sync.

       -T myname peer file
	      Test only this file in this sync pair.

       -TT    As -T, but print the unified diffs.

       Notice:	The modes -H, -L, -M and -S return 2 if the requested db is empty. The mode -T returns 2 if both hosts are in sync.

       -i     Run in inetd server mode.

       -ii    Run in stand-alone server mode.

       -iii   Run in stand-alone server mode (one connect only).

       -R     Remove files from database which do not match config entries.

       Modifiers:

       -r     Recursive operation over subdirectories

       -d     Dry-run on all remote update operations

       -B     Do  not  block everything into big SQL transactions. This slows down csync2 but allows multiple csync2 processes to access the data-
	      base at the same time. Use e.g. when slow lines are used or huge files are transferred.

       -A     Open database in asynchronous mode. This will cause data corruption if the operating system crashes or the computer loses power.

       -I     Init-run. Use with care and read the documentation first!  You usually do not need this option unless you  are  initializing  groups
	      with really large file lists.

       -X     Also add removals to dirty db when doing a -TI run.

       -U     Don't mark all other peers as dirty when doing a -TI run.

       -G Group1,Group2,Group3,...
	      Only use this groups from config-file.

       -P peer1,peer1,...
	      Only update this peers (still mark all as dirty).

       -F     Add new entries to dirty database with force flag set.

       -t     Print timestamps to debug output (e.g. for profiling).

       -s filename
	      Print timestamps also to this file.

       -W fd  Write  a list of directories in which relevant file can be found to the specified file descriptor (when doing a -c run).	The direc-
	      tory names in this output are zero-terminated.

       Creating key file:
	      csync2 -k filename

       Warning: Csync2 will refuse to do anything when a /etc/csync2.lock file is found.

SEE ALSO

       sqlite(1).

AUTHOR

       csync2 was written by Clifford Wolf <clifford@clifford.at>.

       This manual page was written by Michael Prokop <mika@grml.org>, for the Debian project (but may be used by others). It is now further main-
       tained by Clifford Wolf.

								September 23, 2005							 CSYNC2(1)