1169689Skan<!doctype html public "-//W3C//DTD HTML 4.01 Transitional//EN" 2169689Skan "http://www.w3.org/TR/html4/loose.dtd"> 3169689Skan<html> <head> 4169689Skan<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> 5169689Skan<link rel='stylesheet' type='text/css' href='postfix-doc.css'> 6169689Skan<title> Postfix manual - postlog(1) </title> 7169689Skan</head> <body> <pre> 8169689SkanPOSTLOG(1) POSTLOG(1) 9169689Skan 10169689Skan<b>NAME</b> 11169689Skan postlog - Postfix-compatible logging utility 12169689Skan 13169689Skan<b>SYNOPSIS</b> 14169689Skan <b>postlog</b> [<b>-iv</b>] [<b>-c</b> <i>config</i><b>_</b><i>dir</i>] [<b>-p</b> <i>priority</i>] [<b>-t</b> <i>tag</i>] [<i>text...</i>] 15169689Skan 16169689Skan<b>DESCRIPTION</b> 17169689Skan The <a href="postlog.1.html"><b>postlog</b>(1)</a> command implements a Postfix-compatible logging inter- 18169689Skan face for use in, for example, shell scripts. 19169689Skan 20169689Skan By default, <a href="postlog.1.html"><b>postlog</b>(1)</a> logs the <i>text</i> given on the command line as one 21169689Skan record. If no <i>text</i> is specified on the command line, <a href="postlog.1.html"><b>postlog</b>(1)</a> reads 22169689Skan from standard input and logs each input line as one record. 23169689Skan 24169689Skan By default, logging is sent to <b>syslogd</b>(8) or <a href="postlogd.8.html"><b>postlogd</b>(8)</a>; when the 25169689Skan standard error stream is connected to a terminal, logging is sent there 26169689Skan as well. 27169689Skan 28169689Skan The following options are implemented: 29169689Skan 30169689Skan <b>-c</b> <i>config</i><b>_</b><i>dir</i> 31169689Skan Read the <a href="postconf.5.html"><b>main.cf</b></a> configuration file in the named directory 32169689Skan instead of the default configuration directory. 33169689Skan 34169689Skan <b>-i</b> (obsolete) 35169689Skan Include the process ID in the logging tag. This flag is ignored 36169689Skan as of Postfix 3.4, where the PID is always included. 37169689Skan 38169689Skan <b>-p</b> <i>priority</i> (default: <b>info</b>) 39169689Skan Specifies the logging severity: <b>info</b>, <b>warn</b>, <b>error</b>, <b>fatal</b>, or 40169689Skan <b>panic</b>. With Postfix 3.1 and later, the program will pause for 1 41169689Skan second after reporting a <b>fatal</b> or <b>panic</b> condition, just like 42169689Skan other Postfix programs. 43169689Skan 44169689Skan <b>-t</b> <i>tag</i> Specifies the logging tag, that is, the identifying name that 45169689Skan appears at the beginning of each logging record. A default tag 46169689Skan is used when none is specified. 47169689Skan 48169689Skan <b>-v</b> Enable verbose logging for debugging purposes. Multiple <b>-v</b> 49169689Skan options make the software increasingly verbose. 50169689Skan 51169689Skan<b>SECURITY</b> 52169689Skan The <a href="postlog.1.html"><b>postlog</b>(1)</a> command is designed to run with set-groupid privileges, 53169689Skan so that it can connect to the <a href="postlogd.8.html"><b>postlogd</b>(8)</a> daemon process (Postfix 3.7 54169689Skan and later; earlier implementations of this command must not have 55169689Skan set-groupid or set-userid permissions). 56169689Skan 57169689Skan<b>ENVIRONMENT</b> 58169689Skan MAIL_CONFIG 59169689Skan Directory with the <a href="postconf.5.html"><b>main.cf</b></a> file. 60169689Skan 61169689Skan<b>CONFIGURATION PARAMETERS</b> 62169689Skan The following <a href="postconf.5.html"><b>main.cf</b></a> parameters are especially relevant to this pro- 63169689Skan gram. 64169689Skan 65169689Skan The text below provides only a parameter summary. See <a href="postconf.5.html"><b>postconf</b>(5)</a> for 66169689Skan more details including examples. 67169689Skan 68169689Skan <b><a href="postconf.5.html#config_directory">config_directory</a> (see 'postconf -d' output)</b> 69169689Skan The default location of the Postfix <a href="postconf.5.html">main.cf</a> and <a href="master.5.html">master.cf</a> con- 70169689Skan figuration files. 71169689Skan 72169689Skan <b><a href="postconf.5.html#import_environment">import_environment</a> (see 'postconf -d' output)</b> 73169689Skan The list of environment variables that a privileged Postfix 74169689Skan process will import from a non-Postfix parent process, or 75169689Skan name=value environment overrides. 76169689Skan 77169689Skan <b><a href="postconf.5.html#syslog_facility">syslog_facility</a> (mail)</b> 78169689Skan The syslog facility of Postfix logging. 79169689Skan 80169689Skan <b><a href="postconf.5.html#syslog_name">syslog_name</a> (see 'postconf -d' output)</b> 81 A prefix that is prepended to the process name in syslog 82 records, so that, for example, "smtpd" becomes "prefix/smtpd". 83 84 Available in Postfix 3.4 and later: 85 86 <b><a href="postconf.5.html#maillog_file">maillog_file</a> (empty)</b> 87 The name of an optional logfile that is written by the Postfix 88 <a href="postlogd.8.html"><b>postlogd</b>(8)</a> service. 89 90 <b><a href="postconf.5.html#postlog_service_name">postlog_service_name</a> (postlog)</b> 91 The name of the <a href="postlogd.8.html"><b>postlogd</b>(8)</a> service entry in <a href="master.5.html">master.cf</a>. 92 93<b>SEE ALSO</b> 94 <a href="postconf.5.html">postconf(5)</a>, configuration parameters 95 <a href="postlogd.8.html">postlogd(8)</a>, Postfix logging 96 syslogd(8), system logging 97 98<b>LICENSE</b> 99 The Secure Mailer license must be distributed with this software. 100 101<b>HISTORY</b> 102 The <a href="postlog.1.html"><b>postlog</b>(1)</a> command was introduced with Postfix version 3.4. 103 104<b>AUTHOR(S)</b> 105 Wietse Venema 106 IBM T.J. Watson Research 107 P.O. Box 704 108 Yorktown Heights, NY 10598, USA 109 110 Wietse Venema 111 Google, Inc. 112 111 8th Avenue 113 New York, NY 10011, USA 114 115 POSTLOG(1) 116</pre> </body> </html> 117