mirror of https://git.code.sf.net/p/isync/isync
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
202 lines
5.2 KiB
202 lines
5.2 KiB
.ig |
|
\" isync - IMAP4 to maildir mailbox synchronizer |
|
\" Copyright (C) 2000 Michael R. Elkins <me@mutt.org> |
|
\" |
|
\" This program is free software; you can redistribute it and/or modify |
|
\" it under the terms of the GNU General Public License as published by |
|
\" the Free Software Foundation; either version 2 of the License, or |
|
\" (at your option) any later version. |
|
\" |
|
\" This program is distributed in the hope that it will be useful, |
|
\" but WITHOUT ANY WARRANTY; without even the implied warranty of |
|
\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
|
\" GNU General Public License for more details. |
|
\" |
|
\" You should have received a copy of the GNU General Public License |
|
\" along with this program; if not, write to the Free Software |
|
\" Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA |
|
.. |
|
.TH isync 1 "2000 Dec 21" |
|
.. |
|
.SH NAME |
|
isync - synchronize IMAP4 and maildir mailboxes |
|
.. |
|
.SH SYNOPSIS |
|
.B isync |
|
[ |
|
.I options... |
|
] |
|
.I file |
|
.. |
|
.SH DESCRIPTION |
|
.B isync |
|
is a command line application which synchronizes a local maildir-style |
|
mailbox with a remote IMAP4 mailbox, suitable for use in IMAP-disconnected |
|
mode. Multiple copies of the remote IMAP4 mailbox can be maintained, and |
|
all flags are synchronized. |
|
.. |
|
.SH OPTIONS |
|
.TP |
|
\fB-c\fR, \fB--config\fR \fIfile\fR |
|
Read configuration from |
|
.I file |
|
By default, configuration is read from ~/.isyncrc if it exists. |
|
.TP |
|
.B -d, --delete |
|
Causes |
|
.B isync |
|
to delete messages from the local maildir mailbox which do not exist on the |
|
IMAP server. By default, |
|
.I dead |
|
messages are |
|
.B not |
|
deleted. |
|
.TP |
|
.B -e, --expunge |
|
Causes |
|
.B isync |
|
to permanently remove all messages marked for deletion in both the local |
|
maildir mailbox and the remote IMAP mailbox. By default, messages are |
|
.B not |
|
expunged. |
|
.TP |
|
.B -f, --fast |
|
Causes |
|
.B isync |
|
to skip the step of synchronzing message flags between the local maildir |
|
mailbox and the IMAP mailbox. Only new messages existing on the server will |
|
be fetched into the local mailbox. |
|
.B NOTE: |
|
This command works by checking the \\Recent flag on messages in the IMAP |
|
mailbox. If you access the IMAP mailbox from multiple locations, the |
|
\\Recent flag will be lost between sessions, so you must do a full |
|
synchronization to fetch the messages which do not exist in the local |
|
mailbox. |
|
.TP |
|
.B -h, --help |
|
Displays a summary of command line options |
|
.TP |
|
\fB-p\fR, \fB--port\fR \fIport\fR |
|
Specifies the port on the IMAP server to connect to (default: 143) |
|
.TP |
|
\fB-r\fR, \fB--remote\fR \fIbox\fR |
|
Specifies the name of the remote IMAP mailbox to synchronize with |
|
(Default: INBOX) |
|
.TP |
|
\fB-s\fR, \fB--host\fR \fIhost\fR |
|
.P |
|
Specifies the hostname of the IMAP server |
|
.TP |
|
\fB-u\fR, \fB--user\fR \fIuser\fR |
|
Specifies the login name to access the IMAP server (default: $USER) |
|
.TP |
|
.B -v, --version |
|
Displays |
|
.B isync |
|
version information |
|
.TP |
|
.B -V, --verbose |
|
Enables |
|
.I verbose |
|
mode, which displays the IMAP4 network traffic. |
|
.. |
|
.SH CONFIGURATION |
|
.B isync |
|
reads |
|
.I ~/.isyncrc |
|
to load default configuration data. Each line of the configuration file |
|
consists of a command. The following commands are understood: |
|
.TP |
|
\fBMailbox\fR \fIpath\fR |
|
Defines a local maildir mailbox. All configuration commands following this |
|
line, up until the next |
|
.I Mailbox |
|
command, apply to this mailbox only. |
|
.. |
|
.TP |
|
\fBHost\fR \fIname\fR |
|
Defines the DNS name or IP address of the IMAP server. If the hostname is |
|
prefixed with |
|
.I imaps: |
|
the connection is assumed to be a SSL connection to port 993 (though you can |
|
change this by placing a |
|
.B Port |
|
command |
|
.B after |
|
the |
|
.B Host |
|
command. Note that some servers support SSL on the default port 143. |
|
.B isync |
|
will always attempt to use SSL if available. |
|
.. |
|
.TP |
|
\fBPort\fR \fIport\fR |
|
Defines the TCP port number on the IMAP server to use (Default: 143) |
|
.. |
|
.TP |
|
\fBBox\fR \fImailbox\fR |
|
Defines the name of the remote IMAP mailbox associated with the local |
|
maildir mailbox (Default: INBOX) |
|
.. |
|
.TP |
|
\fBUser\fR \fIusername\fR |
|
Defines the login name on the IMAP server (Default: current user) |
|
.. |
|
.TP |
|
\fBPass\fR \fIpassword\fR |
|
Defines the password for |
|
.I username |
|
on the IMAP server. Note that this option is |
|
.B NOT |
|
required. If no password is specified in the configuration file, |
|
.B isync |
|
will prompt you for it. |
|
.. |
|
.TP |
|
\fBAlias\fR \fIstring\fR |
|
Defines an alias for the mailbox which can be used as a shortcut on the |
|
command line. |
|
.. |
|
.TP |
|
\fBRequireSSL\fR \fIyes|no\fR |
|
.B isync will abort the connection if a TLS/SSL session to the IMAP |
|
server can not be established. (Default: |
|
.I yes |
|
) |
|
.. |
|
.TP |
|
\fBCertificateFile\fR \fIpath\fR |
|
File containing X.509 CA certificates used to verify server identities. |
|
.. |
|
.P |
|
Configuration commands that appear prior to the first |
|
.B Mailbox |
|
command are considered to be |
|
.I global |
|
options which are used as defaults when those specific options are not |
|
specifically set for a defined Mailbox. For example, if you use the same |
|
login name for several IMAP servers, you can put a |
|
.B User |
|
command before the first |
|
.B Mailbox |
|
command, and then leave out the |
|
.B User |
|
command in the sections for each mailbox. |
|
.B isync |
|
will then use the global value by default. |
|
.. |
|
.SH FILES |
|
.TP |
|
.B ~/.isyncrc |
|
Default configuration file |
|
.. |
|
.SH SEE ALSO |
|
mutt(1), maildir(5) |
|
.P |
|
Up to date information on |
|
.B isync |
|
can be found at |
|
http://www.sigpipe.org/isync/. |
|
.. |
|
.SH AUTHOR |
|
Written by Michael R. Elkins <me@mutt.org>.
|
|
|