This document is a Mac OS X manual page. Manual pages are a command-line technology for providing documentation. You can view these manual pages locally using the man(1) command. These manual pages come from many different sources, and thus, have a variety of writing styles.

This manual page is associated with Mac OS X Server. It is not available on standard Mac OS X (client) installations.

For more information about the manual page format, see the manual page for manpages(5).

SYNC_CLIENT(8)                                                                                SYNC_CLIENT(8)



NAME
       sync_client - client side of the synchronization (replication) engine

SYNOPSIS
       sync_client [ -v ] [ -l ] [ -C config-file ] [ -S servername ]
                   [ -f input-file ] [ -F shutdown_file ] [ -w wait_interval ]
                   [ -t timeout ] [ -d delay ] [ -r ] [ -u ] [ -m ]
                   [ -s ] objects...


DESCRIPTION
       Sync_client  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 syn-chronize synchronize
       chronize the replica system with the master system.

OPTIONS
       -v     Verbose mode.

       -l     Verbose logging mode.

       -o     Only  attempt  to  connect  to  the backend server once rather than waiting up to 1000 seconds
              before giving up.

       -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  pro-cessing processing
              cessing the log file).

       -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 nice clean shutdown at first convenient point. The  file  in
              question is removed on shutdown.  Overrides sync_shutdown_file option in imapd.conf

       -w interval
              Wait  this long before starting. 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.

       -r     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_shutdwon_file appears.

       -u     User mode.  Remaining arguments are list of users who should be replicated.

       -m     Mailbox mode.  Remaining arguments are list of mailboxes which should be replicated.

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

FILES
       /etc/imapd.conf

SEE ALSO
       sync_server(8)

AUTHORS
       David Carter (dpc22@cam.ac.uk), Ken Murchison (ken@oceana.com)



CMU                                             Project Cyrus                                 SYNC_CLIENT(8)