aboutsummaryrefslogtreecommitdiffstats
path: root/pullimap.1
diff options
context:
space:
mode:
Diffstat (limited to 'pullimap.1')
-rw-r--r--pullimap.110
1 files changed, 7 insertions, 3 deletions
diff --git a/pullimap.1 b/pullimap.1
index 52a6152..57a4adf 100644
--- a/pullimap.1
+++ b/pullimap.1
@@ -12,8 +12,7 @@ PullIMAP \- Pull mails from an IMAP mailbox and deliver them to a SMTP session
.PP
.B PullIMAP\fR retrieves messages from an IMAP mailbox and deliver them
to a SMTP or LMTP transmission channel.
-It can also remove delivered messages after a configurable retention
-period.
+It can also remove old messages after a configurable retention period.
.PP
A statefile is used to keep track of the mailbox's UIDVALIDITY and
@@ -33,6 +32,7 @@ environment variable is unset.
Don't exit after a successful poll; instead, keep the connection open
and issue IDLE commands (requires an IMAP server supporting RFC 2177) to
watch for updates in the mailbox.
+This also sets SO_KEEPALIVE on the socket.
Each IDLE is terminated after at most \fIseconds\fR (29 minutes by
default) to avoid being logged out for inactivity.
@@ -113,6 +113,10 @@ Message recipient.
Retention period (in days), after which messages are removed from the
IMAP server. (The value is at best 24h accurate due to IMAP SEARCH
criterion ignoring time and timezone.)
+If \fIpurge\-after\fR is set to \(lq0\(rq then messages are deleted
+immediately after delivery. Otherwise \fBPullIMAP\fR issues an IMAP
+SEARCH command to list old messages; if \fB\-\-idle\fR is set then the
+SEARCH command is issued again every 6 hours.
.TP
.I type
@@ -180,7 +184,7 @@ advertising it.
(Default: \(lqYES\(rq.)
.TP
-.I null-stderr
+.I null\-stderr
Whether to redirect \fIcommand\fR's standard error to \(lq/dev/null\(rq
for type \fItype\fR=tunnel.
(Default: \(lqNO\(rq.)