mailsync(1) [debian man page]
MAILSYNC(1) General Commands Manual MAILSYNC(1) NAME
mailsync - Synchronize IMAP mailboxes SYNOPSIS
mailsync [options] channel or mailsync [options] store or mailsync [options] channel store DESCRIPTION
This manual page documents briefly the mailsync command. mailsync is a way of keeping a collection of mailboxes synchronized. The mailboxes may be on the local filesystem or on an IMAP server. There are three invocations of mailsync: The first will synchronize two sets of mailboxes - in mailsync referred to as "stores". The second form will list the contents of a store. It's usage is recommended before synchronizing two stores to check whether mailsync is seeing what you are expecting it to see. The third form will show you what has changed in a store since the last sync. OPTIONS
A summary of options is included below. -f file Use alternate config file. -n Don't delete messages when synchronizing. -D Delete any empty mailboxes after synchronizing.. -m Show from, subject, etc. of messages that are killed or moved when synchronzing. -M Also show message-ids (turns on -m). -s Says what would be done without doing it (turns on -n). Attention: this will change the "Seen" flag of emails and will create new, empty mailboxes in order to be able to compare them. -v Show IMAP chatter. -vb Show warning about braindammaged message ids -vw Show warnings -vp Show RFC 822 mail parsing errors -h Show help. -d Show debug info. -di Debug/log IMAP protocol telemetry. -dc Debug config. -t mid Use mailsync with specified message-id algorithm. Currently you have the choice between md5 and msgid (default). msgid uses the Mes- sage-ID in the mail header to identify a message. md5 calculates a MD5 hash from the "From", "To", "Subject", "Date" and "Message- ID" headers and uses that as message identifier. If you use mailclients and servers that allow empty Message-IDs (f.ex. in mail drafts) then you should use the md5 algorithm. SEE ALSO
There is more documentation in /usr/share/doc/mailsync , and in /usr/share/doc/libc-clientxxxxxx/internal.txt AUTHOR
Originally written by Jaldhar H. Vyas <jaldhar@debian.org> for the Debian GNU/Linux system. Updates by T. Pospisek <tpo_deb@sourcepole.ch>. February 15, 2003 MAILSYNC(1)
Check Out this Related Man Page
mswatch(1) General Commands Manual mswatch(1) NAME
mswatch - watch mailstores for changes and initiate mailbox syncs SYNOPSIS
mswatch [options ...] DESCRIPTION
mswatch is a command line program that makes keeping two mailboxes synchronized faster and more efficient than periodically synchronizing the two mailboxes. mswatch watches mailboxes to know when to initiate mailbox syncs. Using mswatch, your mail synchronization program can be called on demand instead of through polling, resulting in prompter mail delivery and lower bandwidth usage and server load. OPTIONS
-c file, --config=file Read configuration from file. By default, the configuration is read from ~/.mswatchrc. -d, --dry Watch mailstores for changes but do not initiate syncs. -q, --quiet Do not print success status messages. -V, --version Display version information. -?, --help Display a summary of command line options. SIGNALS
SIGUSR1 Print names of mailboxes with pending syncs. SIGINT and SIGTERM Gracefully exit. CONFIGURATION
The configuration file is mandatory; mswatch will not run without it. Text starting with a hash mark (#) through the end of the current line are comments and are ignored. Spaces and tabs delimit. base_delay time Default: 10 seconds Minimum time after first queued mailbox change to synchronization. inter_delay time Default: 60 seconds Minimum time between two synchronizations or failed attempts (this is the default inter_delay setting for mailboxes). inter_delay time mailboxes ... Default: inter_delay Minimum time between two synchronizations or failed attempts for the list mailboxes. max_delay time Default: 600 seconds Maximum waiting time between failed attempts. poll_period time Default: 86400 seconds (1 day) Period at which to poll all mailboxes. This option is for use with sync programs that can error without returning a failed sta- tus---it ensures that the mailboxes are at least this fresh. To disable polling, set the period to 0. ignore mailboxes ... Optional Do not initiate explicit synchronizations for these mailboxes. mswatch will ignore changes made to these mailboxes while it is run- ning, but will still synchronize them at start when all mailboxes are synchronized. sync program arguments ... Required Program and arguments to run to synchronize mail stores. Mailbox names are appended to arguments ... when program is run. mailbox_prefix prefix separator Optional Prefix these strings to mailbox names passed to sync; useful when using mbsync for sync, as the mbsync channel. If present, prefix is always prefixed to mailbox names. When synchronizing a particular mailbox, separator is inserted between prefix and the mailbox name (separator is not inserted when synchronizing all mailboxes). Examples: Given prefix = "mydomain" and separator = ":" and that the mailbox "INBOX" is to be synchronized, "mydomain:INBOX" is passed to sync. Given prefix = "mydomain" and separator = ":" and that all mailboxes are to be synchronized, "mydomain" is passed to sync. store name { watch program arguments ... } Required (two stores) A mailstore to watch. Call it name when reporting status information to the user. watch sets the program and arguments to run the mailstore watcher. watch_maildirs(1) is a Maildir mailstore watcher. FILES
~/.mswatchrc Default configuration file SEE ALSO
inputkill(1), watch_maildirs(1), socketwatch(1), mbsync(1), mswatch website: http://mswatch.sf.net/ AUTHOR
Written by Chris Frost <chris@frostnet.net>. mswatch(1)