From f8387c281f2a73343fcca9e599d29bd93ece4524 Mon Sep 17 00:00:00 2001 From: Guilhem Moulin Date: Tue, 8 Mar 2016 17:43:14 +0100 Subject: pullimap: improve doc. --- pullimap.1 | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) (limited to 'pullimap.1') diff --git a/pullimap.1 b/pullimap.1 index 52a6152..746e2ff 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,8 @@ 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. .TP .I type @@ -180,7 +182,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.) -- cgit v1.2.3 From e19354c1b2b8015f58b7119763bb8cec401fb3fa Mon Sep 17 00:00:00 2001 From: Guilhem Moulin Date: Tue, 8 Mar 2016 18:02:10 +0100 Subject: pullimap: Don't rely on the last purged timestamp when purge-after=0. --- pullimap.1 | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) (limited to 'pullimap.1') diff --git a/pullimap.1 b/pullimap.1 index 746e2ff..57a4adf 100644 --- a/pullimap.1 +++ b/pullimap.1 @@ -114,7 +114,9 @@ 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. +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 -- cgit v1.2.3