xref: /netbsd-src/external/ibm-public/postfix/dist/html/postlogd.8.html (revision 6db267571823ee3b0a1d61478df085a087f2e990)
1<!doctype html public "-//W3C//DTD HTML 4.01 Transitional//EN"
2        "http://www.w3.org/TR/html4/loose.dtd">
3<html> <head>
4<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
5<title> Postfix manual - postlogd(8) </title>
6</head> <body> <pre>
7POSTLOGD(8)                                                        POSTLOGD(8)
8
9<b>NAME</b>
10       postlogd - Postfix internal log server
11
12<b>SYNOPSIS</b>
13       <b>postlogd</b> [generic Postfix daemon options]
14
15<b>DESCRIPTION</b>
16       This program logs events on behalf of Postfix programs when the maillog
17       configuration parameter specifies a non-empty value.
18
19<b>BUGS</b>
20       Non-daemon Postfix programs don't know that  they  should  log  to  the
21       internal  logging  service  before  they  have  processed  command-line
22       options and <a href="postconf.5.html">main.cf</a> parameters. These programs still log earlier events
23       to the syslog service.
24
25       If  Postfix  is down, the non-daemon programs <a href="postfix.1.html"><b>postfix</b>(1)</a>, <a href="postsuper.1.html"><b>postsuper</b>(1)</a>,
26       <a href="postmulti.1.html"><b>postmulti</b>(1)</a>, and <a href="postlog.1.html"><b>postlog</b>(1)</a>, will log directly to <b>$<a href="postconf.5.html#maillog_file">maillog_file</a></b>. These
27       programs expect to run with root privileges, for example during Postfix
28       start-up, reload, or shutdown.
29
30       Other non-daemon Postfix programs will never write directly  to  <b>$<a href="postconf.5.html#maillog_file">mail</a>-</b>
31       <b><a href="postconf.5.html#maillog_file">log_file</a></b> (also, logging to stdout would interfere with the operation of
32       some of these programs). These programs can log to <a href="postlogd.8.html"><b>postlogd</b>(8)</a> if  they
33       are run by the super-user, or if their executable file has set-gid per-
34       mission. Do not set this permission on programs other than <a href="postdrop.1.html"><b>postdrop</b>(1)</a>,
35       <a href="postqueue.1.html"><b>postqueue</b>(1)</a> and (Postfix &gt;= 3.7) <a href="postlog.1.html"><b>postlog</b>(1)</a>.
36
37<b>CONFIGURATION PARAMETERS</b>
38       Changes  to  <a href="postconf.5.html"><b>main.cf</b></a>  are  picked up automatically, as <a href="postlogd.8.html"><b>postlogd</b>(8)</a> pro-
39       cesses run for only a limited amount of time. Use the command  "<b>postfix</b>
40       <b>reload</b>" to speed up a change.
41
42       The  text  below provides only a parameter summary. See <a href="postconf.5.html"><b>postconf</b>(5)</a> for
43       more details including examples.
44
45       <b><a href="postconf.5.html#config_directory">config_directory</a> (see 'postconf -d' output)</b>
46              The default location of the Postfix <a href="postconf.5.html">main.cf</a> and  <a href="master.5.html">master.cf</a>  con-
47              figuration files.
48
49       <b><a href="postconf.5.html#maillog_file">maillog_file</a> (empty)</b>
50              The  name  of an optional logfile that is written by the Postfix
51              <a href="postlogd.8.html"><b>postlogd</b>(8)</a> service.
52
53       <b><a href="postconf.5.html#process_id">process_id</a> (read-only)</b>
54              The process ID of a Postfix command or daemon process.
55
56       <b><a href="postconf.5.html#process_name">process_name</a> (read-only)</b>
57              The process name of a Postfix command or daemon process.
58
59       <b><a href="postconf.5.html#syslog_name">syslog_name</a> (see 'postconf -d' output)</b>
60              A prefix that  is  prepended  to  the  process  name  in  syslog
61              records, so that, for example, "smtpd" becomes "prefix/smtpd".
62
63       <b><a href="postconf.5.html#service_name">service_name</a> (read-only)</b>
64              The <a href="master.5.html">master.cf</a> service name of a Postfix daemon process.
65
66       <b><a href="postconf.5.html#postlogd_watchdog_timeout">postlogd_watchdog_timeout</a> (10s)</b>
67              How  much  time  a  <a href="postlogd.8.html"><b>postlogd</b>(8)</a>  process  may  take to process a
68              request before it is terminated by a built-in watchdog timer.
69
70<b>SEE ALSO</b>
71       <a href="postconf.5.html">postconf(5)</a>, configuration parameters
72       syslogd(8), system logging
73
74<b>README_FILES</b>
75       Use "<b>postconf <a href="postconf.5.html#readme_directory">readme_directory</a></b>" or "<b>postconf <a href="postconf.5.html#html_directory">html_directory</a></b>" to  locate
76       this information.
77       <a href="MAILLOG_README.html">MAILLOG_README</a>, Postfix logging to file or stdout
78
79<b>LICENSE</b>
80       The Secure Mailer license must be distributed with this software.
81
82<b>HISTORY</b>
83       This service was introduced with Postfix version 3.4.
84
85<b>AUTHOR(S)</b>
86       Wietse Venema
87       Google, Inc.
88       111 8th Avenue
89       New York, NY 10011, USA
90
91                                                                   POSTLOGD(8)
92</pre> </body> </html>
93