sync_client - client side of the synchronization (replication) engine
] [ -l
] [ -z
] [ -C
] [ -S servername
[ -f input-file
] [ -F shutdown_file
] [ -w
[ -t timeout
] [ -d delay
] [ -r
] [ -m
] [ -A
is the client side of the replication system. It runs on the
client (master) system and connects to the target (replica) system and
generates an appropriate sequence of transactions to synchronize the replica
system with the master system.
- Verbose mode. Use twice (-v -v) to log all protocol traffic
- Verbose logging mode.
- Only attempt to connect to the backend server once rather
than waiting up to 1000 seconds before giving up.
- Require compression. The replication protocol will always
try to enable deflate compression if both ends support it. Set this flag
when you want to abort if compression is not available.
- -C config-file
- Read configuration options from config-file.
- -S servername
- Tells sync_client which server to communicate with.
Overrides the sync_host configuration option.
- -f input-file
- In mailbox or user replication mode: provides list of users
or mailboxes to replicate. In rolling replication mode, specifies an
alternate log file (sync_client will exit after processing the log
- -F shutdown-file
- Rolling replication checks for this file at the end of each
replication cycle and shuts down if it is present. Used to request a nice
clean shutdown at the first convenient point. The file is removed on
shutdown. Overrides sync_shutdown_file option in
- -w interval
- Wait this long before starting. This option is typically
used so that we can attach a debugger to one end of the replication system
or the other.
- -t timeout
- Timeout for single replication run in rolling replication.
sync_client will negotiate a restart after this many seconds.
Default: 600 seconds
- -d delay
- Minimum delay between replication runs in rolling
replication mode. Larger values provide better efficiency as transactions
can be merged. Smaller values mean that the replica system is more up to
date and that you don't end up with large blocks of replication
transactions as a single group. Default: 3 seconds.
- Rolling (repeat) replication mode. Pick up a list of
actions recorded by the lmtpd(8), imapd(8), popd(8)
and nntpd(8) daemons from the file specified in
sync_log_file. Repeat until sync_shutdown_file appears.
- Use the named channel for rolling replication mode. If
multiple channels are specified in sync_log_channels then use one
of them. This option is probably best combined with -S to connect
to a different server with each channel.
- User mode. Remaining arguments are list of users who should
- All users mode. Sync every user on the server to the
replica (doesn't do non-user mailboxes at all... this could be considered
a bug and maybe it should do those mailboxes independently)
- Mailbox mode. Remaining arguments are list of mailboxes
which should be replicated.
- Sieve mode. Remaining arguments are list of users whose
Sieve files should be replicated. Principally used for debugging purposes:
not exposed to sync_client(8).
David Carter (firstname.lastname@example.org), Ken Murchison (email@example.com)