1<!doctype html public "-//W3C//DTD HTML 4.01 Transitional//EN" 2 "https://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><a name="name">NAME</a></b> 11 postlogd - Postfix internal log server 12 13<b><a name="synopsis">SYNOPSIS</a></b> 14 <b>postlogd</b> [generic Postfix daemon options] 15 16<b><a name="description">DESCRIPTION</a></b> 17 This program logs events on behalf of Postfix programs when the <a href="postconf.5.html#maillog_file">mail</a>- 18 <a href="postconf.5.html#maillog_file">log_file</a> configuration parameter specifies a non-empty value. 19 20<b><a name="bugs">BUGS</a></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 >= 3.7) <a href="postlog.1.html"><b>postlog</b>(1)</a>. 37 38<b><a name="configuration_parameters">CONFIGURATION PARAMETERS</a></b> 39 Changes to <a href="postconf.5.html"><b>main.cf</b></a> are not picked up automatically, because <a href="postlogd.8.html"><b>postlogd</b>(8)</a> 40 terminates only after reaching the <b><a href="postconf.5.html#max_idle">max_idle</a></b> time limit. Use the com- 41 mand "<b>postfix 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 Available in Postfix 3.9 and later: 72 73 <b><a href="postconf.5.html#maillog_file_permissions">maillog_file_permissions</a> (0600)</b> 74 The file access permissions that will be set when the file 75 $<a href="postconf.5.html#maillog_file">maillog_file</a> is created for the first time, or when the file is 76 created after an existing file is rotated. 77 78<b><a name="see_also">SEE ALSO</a></b> 79 <a href="postconf.5.html">postconf(5)</a>, configuration parameters 80 syslogd(8), system logging 81 82<b><a name="readme_files">README_FILES</a></b> 83 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 84 this information. 85 <a href="MAILLOG_README.html">MAILLOG_README</a>, Postfix logging to file or stdout 86 87<b><a name="license">LICENSE</a></b> 88 The Secure Mailer license must be distributed with this software. 89 90<b><a name="history">HISTORY</a></b> 91 This service was introduced with Postfix version 3.4. 92 93<b>AUTHOR(S)</b> 94 Wietse Venema 95 Google, Inc. 96 111 8th Avenue 97 New York, NY 10011, USA 98 99 Wietse Venema 100 porcupine.org 101 102 POSTLOGD(8) 103</pre> </body> </html> 104