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