aboutsummaryrefslogtreecommitdiffstats
path: root/fetchmail.man
diff options
context:
space:
mode:
Diffstat (limited to 'fetchmail.man')
-rw-r--r--fetchmail.man28
1 files changed, 16 insertions, 12 deletions
diff --git a/fetchmail.man b/fetchmail.man
index 7322e945..ce90f441 100644
--- a/fetchmail.man
+++ b/fetchmail.man
@@ -164,7 +164,8 @@ you have specified a default of \fBkeep\fR in your
.B \-F | \-\-flush
POP3/IMAP only. Delete old (previously retrieved) messages from the mailserver
before retrieving new messages. This option does not work with ETRN or
-ODMR.
+ODMR. In combination with the --limit option, --flush can be used to
+delete oversized messages waiting on the server.
Warning: if your local MTA hangs and fetchmail is aborted, the next
time you run fetchmail, it will delete mail that was never delivered to you.
What you probably want is the default setting: if you don't specify `-k', then
@@ -437,17 +438,18 @@ MAILBOXES below apply.
.SS Resource Limit Control Options
.TP
.B \-l <maxbytes> | \-\-limit <maxbytes>
-(Keyword: limit)
-Takes a maximum octet size argument. Messages larger than this size
-will not be fetched and will be left on the server (in foreground
-sessions, the progress messages will note that they are "oversized").
-If the fetch protocol permits (in particular, under IMAP or POP3
-without the fetchall option) the message will not be marked seen An
-explicit --limit of 0 overrides any limits set in your run control
-file. This option is intended for those needing to strictly control
-fetch time due to expensive and variable phone rates. In daemon mode,
-oversize notifications are mailed to the calling user (see the
---warnings option). This option does not work with ETRN or ODMR.
+(Keyword: limit) Takes a maximum octet size argument. Messages larger
+than this size will not be fetched and will be left on the server (in
+foreground sessions, the progress messages will note that they are
+"oversized"). If the fetch protocol permits (in particular, under
+IMAP or POP3 without the fetchall option) the message will not be
+marked seen An explicit --limit of 0 overrides any limits set in your
+run control file. This option is intended for those needing to
+strictly control fetch time due to expensive and variable phone rates.
+Combined with --flush, it can be used to delete oversized messages
+waiting on a server. In daemon mode, oversize notifications are
+mailed to the calling user (see the --warnings option). This option
+does not work with ETRN or ODMR.
.TP
.B \-w <interval> | \-\-warnings <interval>
(Keyword: warnings)
@@ -2078,6 +2080,8 @@ BSMTP batch file could not be opened.
Poll terminated by a fetch limit (see the --fetchlimit option).
.IP 14
Server busy indication.
+.IP 15
+Server timed out during an IMAP IDLE.
.IP 23
Internal error. You should see a message on standard error with
details.