123 lines
6.2 KiB
HTML
123 lines
6.2 KiB
HTML
<!doctype html public "-//W3C//DTD HTML 4.01 Transitional//EN"
|
|
"https://www.w3.org/TR/html4/loose.dtd">
|
|
<html> <head>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
|
|
<link rel='stylesheet' type='text/css' href='postfix-doc.css'>
|
|
<title> Postfix manual - postlog(1) </title>
|
|
</head> <body> <pre>
|
|
POSTLOG(1) POSTLOG(1)
|
|
|
|
<b><a name="name">NAME</a></b>
|
|
postlog - Postfix-compatible logging utility
|
|
|
|
<b><a name="synopsis">SYNOPSIS</a></b>
|
|
<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>]
|
|
|
|
<b><a name="description">DESCRIPTION</a></b>
|
|
The <a href="postlog.1.html"><b>postlog</b>(1)</a> command implements a Postfix-compatible logging inter-
|
|
face for use in, for example, shell scripts.
|
|
|
|
By default, <a href="postlog.1.html"><b>postlog</b>(1)</a> logs the <i>text</i> given on the command line as one
|
|
record. If no <i>text</i> is specified on the command line, <a href="postlog.1.html"><b>postlog</b>(1)</a> reads
|
|
from standard input and logs each input line as one record.
|
|
|
|
Logging is sent to <b>syslogd</b>(8) or <a href="postlogd.8.html"><b>postlogd</b>(8)</a>, and to the standard error
|
|
stream (with Postfix < 3.8, <a href="postlog.1.html"><b>postlog</b>(1)</a> writes to the standard error
|
|
stream only if that stream is connected to a terminal).
|
|
|
|
The following options are implemented:
|
|
|
|
<b>-c</b> <i>config</i><b>_</b><i>dir</i>
|
|
Read the <a href="postconf.5.html"><b>main.cf</b></a> configuration file in the named directory
|
|
instead of the default configuration directory.
|
|
|
|
<b>-i</b> (obsolete)
|
|
Include the process ID in the logging tag. This flag is ignored
|
|
as of Postfix 3.4, where the PID is always included.
|
|
|
|
<b>-p</b> <i>priority</i> (default: <b>info</b>)
|
|
Specifies the logging severity: <b>info</b>, <b>warn</b>, <b>error</b>, <b>fatal</b>, or
|
|
<b>panic</b>. With Postfix 3.1 and later, the program will pause for 1
|
|
second after reporting a <b>fatal</b> or <b>panic</b> condition, just like
|
|
other Postfix programs.
|
|
|
|
<b>-t</b> <i>tag</i> Specifies the logging tag, that is, the identifying name that
|
|
appears at the beginning of each logging record. A default tag
|
|
is used when none is specified.
|
|
|
|
<b>-v</b> Enable verbose logging for debugging purposes. Multiple <b>-v</b>
|
|
options make the software increasingly verbose.
|
|
|
|
<b><a name="security">SECURITY</a></b>
|
|
The <a href="postlog.1.html"><b>postlog</b>(1)</a> command is designed to run with set-groupid privileges,
|
|
so that it can connect to the <a href="postlogd.8.html"><b>postlogd</b>(8)</a> daemon process (Postfix 3.7
|
|
and later; earlier implementations of this command must not have
|
|
set-groupid or set-userid permissions).
|
|
|
|
<b><a name="environment">ENVIRONMENT</a></b>
|
|
MAIL_CONFIG
|
|
Directory with the <a href="postconf.5.html"><b>main.cf</b></a> file.
|
|
|
|
<b><a name="configuration_parameters">CONFIGURATION PARAMETERS</a></b>
|
|
The following <a href="postconf.5.html"><b>main.cf</b></a> parameters are especially relevant to this pro-
|
|
gram.
|
|
|
|
The text below provides only a parameter summary. See <a href="postconf.5.html"><b>postconf</b>(5)</a> for
|
|
more details including examples.
|
|
|
|
<b><a href="postconf.5.html#config_directory">config_directory</a> (see 'postconf -d' output)</b>
|
|
The default location of the Postfix <a href="postconf.5.html">main.cf</a> and <a href="master.5.html">master.cf</a> con-
|
|
figuration files.
|
|
|
|
<b><a href="postconf.5.html#import_environment">import_environment</a> (see 'postconf -d' output)</b>
|
|
The list of environment variables that a privileged Postfix
|
|
process will import from a non-Postfix parent process, or
|
|
name=value environment overrides.
|
|
|
|
<b><a href="postconf.5.html#syslog_facility">syslog_facility</a> (mail)</b>
|
|
The syslog facility of Postfix logging.
|
|
|
|
<b><a href="postconf.5.html#syslog_name">syslog_name</a> (see 'postconf -d' output)</b>
|
|
A prefix that is prepended to the process name in syslog
|
|
records, so that, for example, "smtpd" becomes "prefix/smtpd".
|
|
|
|
Available in Postfix 3.4 and later:
|
|
|
|
<b><a href="postconf.5.html#maillog_file">maillog_file</a> (empty)</b>
|
|
The name of an optional logfile that is written by the Postfix
|
|
<a href="postlogd.8.html"><b>postlogd</b>(8)</a> service.
|
|
|
|
<b><a href="postconf.5.html#postlog_service_name">postlog_service_name</a> (postlog)</b>
|
|
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>.
|
|
|
|
Available in Postfix 3.9 and later:
|
|
|
|
<b><a href="postconf.5.html#maillog_file_permissions">maillog_file_permissions</a> (0600)</b>
|
|
The file access permissions that will be set when the file
|
|
$<a href="postconf.5.html#maillog_file">maillog_file</a> is created for the first time, or when the file is
|
|
created after an existing file is rotated.
|
|
|
|
<b><a name="see_also">SEE ALSO</a></b>
|
|
<a href="postconf.5.html">postconf(5)</a>, configuration parameters
|
|
<a href="postlogd.8.html">postlogd(8)</a>, Postfix logging
|
|
syslogd(8), system logging
|
|
|
|
<b><a name="license">LICENSE</a></b>
|
|
The Secure Mailer license must be distributed with this software.
|
|
|
|
<b><a name="history">HISTORY</a></b>
|
|
The <a href="postlog.1.html"><b>postlog</b>(1)</a> command was introduced with Postfix version 3.4.
|
|
|
|
<b>AUTHOR(S)</b>
|
|
Wietse Venema
|
|
IBM T.J. Watson Research
|
|
P.O. Box 704
|
|
Yorktown Heights, NY 10598, USA
|
|
|
|
Wietse Venema
|
|
Google, Inc.
|
|
111 8th Avenue
|
|
New York, NY 10011, USA
|
|
|
|
POSTLOG(1)
|
|
</pre> </body> </html>
|