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)