2000-12-20 21:41:21 +00:00
|
|
|
_
|
|
|
|
(_)___ _ _ _ __ ___
|
|
|
|
| / __| | | | '_ \ / __|
|
|
|
|
| \__ \ |_| | | | | (__
|
|
|
|
|_|___/\__, |_| |_|\___|
|
|
|
|
|___/
|
2004-03-27 16:07:20 +00:00
|
|
|
isync/mbsync - free (GPL) mailbox synchronization program
|
2002-12-28 03:05:43 +00:00
|
|
|
http://isync.sf.net/
|
2000-12-20 21:41:21 +00:00
|
|
|
|
2004-03-27 16:07:20 +00:00
|
|
|
See AUTHORS for contact information.
|
2000-12-20 21:41:21 +00:00
|
|
|
|
2004-03-27 16:07:20 +00:00
|
|
|
``mbsync'' is a command line application which synchronizes mailboxes;
|
|
|
|
currently Maildir and IMAP4 mailboxes are supported. New messages, message
|
|
|
|
deletions and flag changes can be propagated both ways.
|
|
|
|
``mbsync'' is suitable for use in IMAP-disconnected mode.
|
2000-12-20 21:41:21 +00:00
|
|
|
|
2015-09-07 10:23:12 +00:00
|
|
|
Synchronization is based on unique message identifiers (UIDs), so
|
|
|
|
no identification conflicts can occur (unlike with some other mail
|
2004-03-27 16:07:20 +00:00
|
|
|
synchronizers).
|
|
|
|
Synchronization state is kept in one local text file per mailbox pair;
|
2015-09-07 10:23:12 +00:00
|
|
|
these files are protected against concurrent ``mbsync'' processes.
|
|
|
|
Mailboxes can be safely modified while ``mbsync'' operates.
|
|
|
|
Multiple replicas of each mailbox can be maintained.
|
2000-12-20 21:41:21 +00:00
|
|
|
|
2004-03-27 16:07:20 +00:00
|
|
|
isync is the project name, while mbsync is the current executable name; this
|
|
|
|
change was necessary because of massive changes in the user interface. An
|
|
|
|
isync executable still exists; it is a compatibility wrapper around mbsync.
|
|
|
|
|
|
|
|
* Features
|
|
|
|
|
|
|
|
* Fine-grained selection of synchronization operations to perform
|
|
|
|
* Synchronizes single mailboxes or entire mailbox collections
|
|
|
|
* Partial mirrors possible: keep only the latest messages locally
|
|
|
|
* Trash functionality: backup messages before removing them
|
|
|
|
* IMAP features:
|
2015-05-24 16:20:06 +00:00
|
|
|
* Supports TLS/SSL via imaps: (port 993) and STARTTLS
|
|
|
|
* Supports SASL for authentication
|
2012-08-26 13:17:38 +00:00
|
|
|
* Pipelining for maximum speed
|
2000-12-21 06:51:14 +00:00
|
|
|
|
|
|
|
* Compatibility
|
|
|
|
|
2004-03-27 16:07:20 +00:00
|
|
|
isync should work fairly well with any IMAP4 compliant server;
|
2013-02-21 07:02:04 +00:00
|
|
|
servers that support the UIDPLUS and LITERAL+ extensions are most
|
|
|
|
efficient.
|
2000-12-21 06:51:14 +00:00
|
|
|
|
2004-03-27 16:07:20 +00:00
|
|
|
Courier 1.4.3 is known to be buggy, version 1.7.3 works fine.
|
2000-12-21 06:51:14 +00:00
|
|
|
|
2004-09-15 09:33:02 +00:00
|
|
|
c-client (UW-IMAP, Pine) is mostly fine, but versions less than 2004a.352
|
|
|
|
tend to change UIDVALIDITY pretty often when used with unix/mbox mailboxes,
|
|
|
|
making isync refuse synchronization.
|
2013-12-08 21:29:15 +00:00
|
|
|
M$ Exchange (up to 2010 at least) occasionally exposes the same problem.
|
2004-03-27 16:07:20 +00:00
|
|
|
The "cure" is to simply copy the new UIDVALIDITY from the affected
|
|
|
|
mailbox to mbsync's state file. This is a Bad Hack (TM), but it works -
|
|
|
|
use at your own risk (if the UIDVALIDITY change was genuine, this will
|
|
|
|
delete all messages in the affected mailbox - not that this ever
|
|
|
|
happened to me).
|
2000-12-21 10:24:53 +00:00
|
|
|
|
2004-03-27 16:07:20 +00:00
|
|
|
* Platforms
|
2000-12-21 10:24:53 +00:00
|
|
|
|
2004-03-27 16:07:20 +00:00
|
|
|
At some point, ``isync'' has successfully run on:
|
2008-03-16 09:09:38 +00:00
|
|
|
Linux, Solaris 2.7, OpenBSD 2.8, FreeBSD 4.3.
|
|
|
|
|
2000-12-21 06:51:14 +00:00
|
|
|
* Requirements
|
|
|
|
|
2015-05-01 09:55:27 +00:00
|
|
|
Berkeley DB 4.1+ (optional)
|
2004-03-27 16:07:20 +00:00
|
|
|
OpenSSL for TLS/SSL support (optional)
|
2015-05-24 16:20:18 +00:00
|
|
|
Cyrus SASL (optional)
|
|
|
|
zlib (optional)
|
2000-12-20 21:41:21 +00:00
|
|
|
|
2004-03-27 16:07:20 +00:00
|
|
|
* Installation
|
2000-12-20 21:41:21 +00:00
|
|
|
|
2013-02-21 07:01:39 +00:00
|
|
|
./autogen.sh (only when building from git)
|
2004-03-27 16:07:20 +00:00
|
|
|
./configure
|
2013-02-21 07:01:39 +00:00
|
|
|
make
|
|
|
|
sudo make install
|
2000-12-20 21:41:21 +00:00
|
|
|
|
2004-03-27 16:07:20 +00:00
|
|
|
* Help
|
2000-12-20 21:41:21 +00:00
|
|
|
|
2004-03-27 16:07:20 +00:00
|
|
|
Please see the man page for complete documentation.
|