1CSYNC2(1) General Commands Manual CSYNC2(1)
2
6 csync2 - cluster synchronization tool, 2nd generation
7
9 csync2 [-v..] [-C config-name] [-D database-dir] [-N hostname] [-p
10 port]...
11
13 This manual page documents briefly the csync2 command.
14 A verbose manual can be found on the csync2 homepage:
15 http://oss.linbit.com/csync2/paper.pdf
17 csync2 is a program for cluster synchronization.
19
21 With file parameters:
22 -h [-r] file..
24 Add (recursive) hints for check to db
25 -c [-r] file..
27 Check files and maybe add to dirty db
28 -u [-d] [-r] file..
30 Updates files if listed in dirty db
31 -f file..
33 Force this file in sync (resolve conflict)
34 -m file..
36 Mark files in database as dirty
37 Simple mode:
39 -x [-d] [[-r] file..]
41 Run checks for all given files and update remote hosts.
42 Without file parameters:
44 -c Check all hints in db and eventually mark files as dirty
46 -u [-d]
48 Update (transfer dirty files to peers and mark as clear)
49 -H List all pending hints from status db
51 -L List all file-entries from status db
53 -M List all dirty files from status db
55 -S myname peername
57 List file-entries from status db for this synchronization pair.
58 -T Test if everything is in sync with all peers.
60 -T filename
62 Test if this file is in sync with all peers.
63 -T myname peername
65 Test if this synchronization pair is in sync.
66 -T myname peer file
68 Test only this file in this sync pair.
69 -TT As -T, but print the unified diffs.
71 Notice: The modes -H, -L, -M and -S return 2 if the requested db is
73 empty. The mode -T returns 2 if both hosts are in sync.
74 -i Run in inetd server mode.
76 -ii Run in stand-alone server mode.
78 -iii Run in stand-alone server mode (one connect only).
80 -R Remove files from database which do not match config entries.
82 Modifiers:
84 -r Recursive operation over subdirectories
86 -d Dry-run on all remote update operations
88 -B Do not block everything into big SQL transactions. This slows
90 down csync2 but allows multiple csync2 processes to access the
91 database at the same time. Use e.g. when slow lines are used or
92 huge files are transferred.
93 -A Open database in asynchronous mode. This will cause data corrup‐
95 tion if the operating system crashes or the computer loses
96 power.
97 -I Init-run. Use with care and read the documentation first! You
99 usually do not need this option unless you are initializing
100 groups with really large file lists.
101 -X Also add removals to dirty db when doing a -TI run.
103 -U Don't mark all other peers as dirty when doing a -TI run.
105 -G Group1,Group2,Group3,...
107 Only use this groups from config-file.
108 -P peer1,peer1,...
110 Only update this peers (still mark all as dirty).
111 -F Add new entries to dirty database with force flag set.
113 -t Print timestamps to debug output (e.g. for profiling).
115 -s filename
117 Print timestamps also to this file.
118 -W fd Write a list of directories in which relevant file can be found
120 to the specified file descriptor (when doing a -c run). The
121 directory names in this output are zero-terminated.
122 Creating key file:
124 csync2 -k filename
125 Warning: Csync2 will refuse to do anything when a /etc/csync2.lock file
127 is found.
128
130 sqlite(1).
131
133 csync2 was written by Clifford Wolf <clifford@clifford.at>.
134 This manual page was written by Michael Prokop <mika@grml.org>, for the
136 Debian project (but may be used by others). It is now further main‐
137 tained by Clifford Wolf.
138 September 23, 2005 CSYNC2(1)