aboutsummaryrefslogtreecommitdiffstats
path: root/fetchmail.man
diff options
context:
space:
mode:
authorMatthias Andree <matthias.andree@gmx.de>2012-09-23 14:44:25 +0200
committerMatthias Andree <matthias.andree@gmx.de>2012-09-23 14:44:25 +0200
commit464bab19acf0aaeb8c5512c2092042162266de2d (patch)
tree85bfa776c30037ef87e5fc3623bd85646797414c /fetchmail.man
parentb06abacf4b2e334131e5743c0e4ea27ad2829f02 (diff)
downloadfetchmail-464bab19acf0aaeb8c5512c2092042162266de2d.tar.gz
fetchmail-464bab19acf0aaeb8c5512c2092042162266de2d.tar.bz2
fetchmail-464bab19acf0aaeb8c5512c2092042162266de2d.zip
Clean up logfile vs. syslog handling.
In case logfile overrides syslog, send a message to the latter stating where logging goes. Also revise manual page.
Diffstat (limited to 'fetchmail.man')
-rw-r--r--fetchmail.man15
1 files changed, 10 insertions, 5 deletions
diff --git a/fetchmail.man b/fetchmail.man
index 56026d0b..0a95f033 100644
--- a/fetchmail.man
+++ b/fetchmail.man
@@ -1366,6 +1366,8 @@ The
option turns off use of
.BR syslog (3),
assuming it's turned on in the \fI~/.fetchmailrc\fP file.
+This option is overridden, in certain situations, by \fB\-\-logfile\fP (which
+see).
.PP
The
.B \-N
@@ -1377,8 +1379,7 @@ fetchmail runs as the child of a supervisor process such as
.BR init (8)
or Gerrit Pape's
.BR runit (8).
-Note that this also causes the logfile option to be ignored (though
-perhaps it shouldn't).
+Note that this also causes the logfile option to be ignored.
.PP
Note that while running in daemon mode polling a POP2 or IMAP2bis server,
transient errors (such as DNS failures or sendmail delivery refusals)
@@ -1702,13 +1703,16 @@ Keep permanently undeliverable mail as though a temporary error had
occurred (default).
T}
set logfile \-L \& T{
-Name of a file to append error and status messages to.
+Name of a file to append error and status messages to. Only effective
+in daemon mode and if fetchmail detaches. If effective, overrides \fBset
+syslog\fP.
T}
set idfile \-i \& T{
Name of the file to store UID lists in.
T}
set syslog \& \& T{
-Do error logging through syslog(3).
+Do error logging through syslog(3). May be overriden by \fBset
+logfile\fP.
T}
set no syslog \& \& T{
Turn off error logging through syslog(3). (default)
@@ -2226,7 +2230,8 @@ authentication. These defaults may be overridden by later options.
There are some global option statements: 'set logfile'
followed by a string sets the same global specified by \-\-logfile. A
command-line \-\-logfile option will override this. Note that \-\-logfile is
-only effective if fetchmail detaches itself from the terminal and the
+only effective if fetchmail detaches itself from the terminal, is in
+daemon mode, and if the
logfile already exists before fetchmail is run, and it overrides
\-\-syslog in this case. Also,
\&'set daemon' sets the poll interval as \-\-daemon does. This can be