xref: /netbsd-src/external/ibm-public/postfix/dist/html/postlog.1.html (revision cef8759bd76c1b621f8eab8faa6f208faabc2e15)
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=us-ascii">
5<title> Postfix manual - postlog(1) </title>
6</head> <body> <pre>
7POSTLOG(1)                                                          POSTLOG(1)
8
9<b>NAME</b>
10       postlog - Postfix-compatible logging utility
11
12<b>SYNOPSIS</b>
13       <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>]
14
15<b>DESCRIPTION</b>
16       The  <a href="postlog.1.html"><b>postlog</b>(1)</a>  command implements a Postfix-compatible logging inter-
17       face for use in, for example, shell scripts.
18
19       By default, <a href="postlog.1.html"><b>postlog</b>(1)</a> logs the <i>text</i> given on the command line  as  one
20       record.  If  no <i>text</i> is specified on the command line, <a href="postlog.1.html"><b>postlog</b>(1)</a> reads
21       from standard input and logs each input line as one record.
22
23       By default, logging is sent to  <b>syslogd</b>(8)  or  <a href="postlogd.8.html"><b>postlogd</b>(8)</a>;  when  the
24       standard error stream is connected to a terminal, logging is sent there
25       as well.
26
27       The following options are implemented:
28
29       <b>-c</b> <i>config</i><b>_</b><i>dir</i>
30              Read the <a href="postconf.5.html"><b>main.cf</b></a>  configuration  file  in  the  named  directory
31              instead of the default configuration directory.
32
33       <b>-i</b> (obsolete)
34              Include  the process ID in the logging tag. This flag is ignored
35              as of Postfix 3.4, where the PID is always included.
36
37       <b>-p</b> <i>priority</i> (default: <b>info</b>)
38              Specifies the logging severity: <b>info</b>,  <b>warn</b>,  <b>error</b>,  <b>fatal</b>,  or
39              <b>panic</b>.  With Postfix 3.1 and later, the program will pause for 1
40              second after reporting a <b>fatal</b> or  <b>panic</b>  condition,  just  like
41              other Postfix programs.
42
43       <b>-t</b> <i>tag</i> Specifies  the  logging  tag, that is, the identifying name that
44              appears at the beginning of each logging record. A  default  tag
45              is used when none is specified.
46
47       <b>-v</b>     Enable  verbose  logging  for  debugging  purposes.  Multiple <b>-v</b>
48              options make the software increasingly verbose.
49
50<b>ENVIRONMENT</b>
51       MAIL_CONFIG
52              Directory with the <a href="postconf.5.html"><b>main.cf</b></a> file.
53
54<b>CONFIGURATION PARAMETERS</b>
55       The following <a href="postconf.5.html"><b>main.cf</b></a> parameters are especially relevant to  this  pro-
56       gram.
57
58       The  text  below provides only a parameter summary. See <a href="postconf.5.html"><b>postconf</b>(5)</a> for
59       more details including examples.
60
61       <b><a href="postconf.5.html#config_directory">config_directory</a> (see 'postconf -d' output)</b>
62              The default location of the Postfix <a href="postconf.5.html">main.cf</a> and  <a href="master.5.html">master.cf</a>  con-
63              figuration files.
64
65       <b><a href="postconf.5.html#import_environment">import_environment</a> (see 'postconf -d' output)</b>
66              The  list  of  environment  parameters that a privileged Postfix
67              process will  import  from  a  non-Postfix  parent  process,  or
68              name=value environment overrides.
69
70       <b><a href="postconf.5.html#syslog_facility">syslog_facility</a> (mail)</b>
71              The syslog facility of Postfix logging.
72
73       <b><a href="postconf.5.html#syslog_name">syslog_name</a> (see 'postconf -d' output)</b>
74              A  prefix  that  is  prepended  to  the  process  name in syslog
75              records, so that, for example, "smtpd" becomes "prefix/smtpd".
76
77       Available in Postfix 3.4 and later:
78
79       <b><a href="postconf.5.html#maillog_file">maillog_file</a> (empty)</b>
80              The name of an optional logfile that is written by  the  Postfix
81              <a href="postlogd.8.html"><b>postlogd</b>(8)</a> service.
82
83       <b><a href="postconf.5.html#postlog_service_name">postlog_service_name</a> (postlog)</b>
84              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>.
85
86<b>SEE ALSO</b>
87       <a href="postconf.5.html">postconf(5)</a>, configuration parameters
88       <a href="postlogd.8.html">postlogd(8)</a>, Postfix logging
89       syslogd(8), system logging
90
91<b>LICENSE</b>
92       The Secure Mailer license must be distributed with this software.
93
94<b>AUTHOR(S)</b>
95       Wietse Venema
96       IBM T.J. Watson Research
97       P.O. Box 704
98       Yorktown Heights, NY 10598, USA
99
100       Wietse Venema
101       Google, Inc.
102       111 8th Avenue
103       New York, NY 10011, USA
104
105                                                                    POSTLOG(1)
106</pre> </body> </html>
107