summaryrefslogtreecommitdiffstats
path: root/html/postlog.1.html
blob: d3c038f4984d54552776ee5e84035093ba5d9b64 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
<!doctype html public "-//W3C//DTD HTML 4.01 Transitional//EN"
        "http://www.w3.org/TR/html4/loose.dtd">
<html> <head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title> Postfix manual - postlog(1) </title>
</head> <body> <pre>
POSTLOG(1)                                                          POSTLOG(1)

<b>NAME</b>
       postlog - Postfix-compatible logging utility

<b>SYNOPSIS</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>DESCRIPTION</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.

       By default, logging is sent to  <b>syslogd</b>(8)  or  <a href="postlogd.8.html"><b>postlogd</b>(8)</a>;  when  the
       standard error stream is connected to a terminal, logging is sent there
       as well.

       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>SECURITY</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>ENVIRONMENT</b>
       MAIL_CONFIG
              Directory with the <a href="postconf.5.html"><b>main.cf</b></a> file.

<b>CONFIGURATION PARAMETERS</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 parameters  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>.

<b>SEE ALSO</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>LICENSE</b>
       The Secure Mailer license must be distributed with this software.

<b>HISTORY</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>