aboutsummaryrefslogtreecommitdiffstats
path: root/fetchmail.man
diff options
context:
space:
mode:
authorMatthias Andree <matthias.andree@gmx.de>2009-06-20 09:57:41 +0000
committerMatthias Andree <matthias.andree@gmx.de>2009-06-20 09:57:41 +0000
commit259e2ff74c50d240b99e46c3ec6326ca8f98a0a2 (patch)
tree8ae94afaf42c0ea901c369319db52d1806306e2a /fetchmail.man
parent93d916efc4ea2ddcfa0d686a5ca0ec1ebcfda903 (diff)
downloadfetchmail-259e2ff74c50d240b99e46c3ec6326ca8f98a0a2.tar.gz
fetchmail-259e2ff74c50d240b99e46c3ec6326ca8f98a0a2.tar.bz2
fetchmail-259e2ff74c50d240b99e46c3ec6326ca8f98a0a2.zip
Add documentation on how to make EXIT CODE 1 not an error.
Fixes Debian Bug#530749, filed by Reuben Thomas. svn path=/branches/BRANCH_6-3/; revision=5361
Diffstat (limited to 'fetchmail.man')
-rw-r--r--fetchmail.man16
1 files changed, 12 insertions, 4 deletions
diff --git a/fetchmail.man b/fetchmail.man
index 0e40521d..b96d2fd6 100644
--- a/fetchmail.man
+++ b/fetchmail.man
@@ -2561,7 +2561,17 @@ One or more messages were successfully retrieved (or, if the \-c option
was selected, were found waiting but not retrieved).
.IP 1
There was no mail awaiting retrieval. (There may have been old mail still
-on the server but not selected for retrieval.)
+on the server but not selected for retrieval.) If you do not want "no
+mail" to be an error condition (for instance, for cron jobs), use a
+POSIX-compliant shell and add
+
+.nf
+|| [ $? -eq 1 ]
+.fi
+
+to the end of the fetchmail command line, note that this leaves 0
+untouched, maps 1 to 0, and maps all other codes to 1. See also item #C8
+in the FAQ.
.IP 2
An error was encountered when attempting to open a socket to retrieve
mail. If you don't know what a socket is, don't worry about it --
@@ -2582,9 +2592,7 @@ There was a syntax error in the arguments to
The run control file had bad permissions.
.IP 7
There was an error condition reported by the server. Can also
-fire if
-\fBfetchmail\fP
-timed out while waiting for the server.
+fire if \fBfetchmail\fP timed out while waiting for the server.
.IP 8
Client-side exclusion error. This means
\fBfetchmail\fP