1POSTLOG(1) General Commands Manual POSTLOG(1)
2
3
4
6 postlog - Postfix-compatible logging utility
7
9 postlog [-iv] [-c config_dir] [-p priority] [-t tag] [text...]
10
12 The postlog(1) command implements a Postfix-compatible logging inter‐
13 face for use in, for example, shell scripts.
14
15 By default, postlog(1) logs the text given on the command line as one
16 record. If no text is specified on the command line, postlog(1) reads
17 from standard input and logs each input line as one record.
18
19 By default, logging is sent to syslogd(8) or postlogd(8); when the
20 standard error stream is connected to a terminal, logging is sent there
21 as well.
22
23 The following options are implemented:
24
25 -c config_dir
26 Read the main.cf configuration file in the named directory in‐
27 stead of the default configuration directory.
28
29 -i (obsolete)
30 Include the process ID in the logging tag. This flag is ignored
31 as of Postfix 3.4, where the PID is always included.
32
33 -p priority (default: info)
34 Specifies the logging severity: info, warn, error, fatal, or
35 panic. With Postfix 3.1 and later, the program will pause for 1
36 second after reporting a fatal or panic condition, just like
37 other Postfix programs.
38
39 -t tag Specifies the logging tag, that is, the identifying name that
40 appears at the beginning of each logging record. A default tag
41 is used when none is specified.
42
43 -v Enable verbose logging for debugging purposes. Multiple -v op‐
44 tions make the software increasingly verbose.
45
47 The postlog(1) command is designed to run with set-groupid privileges,
48 so that it can connect to the postlogd(8) daemon process (Postfix 3.7
49 and later; earlier implementations of this command must not have
50 set-groupid or set-userid permissions).
51
53 MAIL_CONFIG
54 Directory with the main.cf file.
55
57 The following main.cf parameters are especially relevant to this pro‐
58 gram.
59
60 The text below provides only a parameter summary. See postconf(5) for
61 more details including examples.
62
63 config_directory (see 'postconf -d' output)
64 The default location of the Postfix main.cf and master.cf con‐
65 figuration files.
66
67 import_environment (see 'postconf -d' output)
68 The list of environment parameters that a privileged Postfix
69 process will import from a non-Postfix parent process, or
70 name=value environment overrides.
71
72 syslog_facility (mail)
73 The syslog facility of Postfix logging.
74
75 syslog_name (see 'postconf -d' output)
76 A prefix that is prepended to the process name in syslog
77 records, so that, for example, "smtpd" becomes "prefix/smtpd".
78
79 Available in Postfix 3.4 and later:
80
81 maillog_file (empty)
82 The name of an optional logfile that is written by the Postfix
83 postlogd(8) service.
84
85 postlog_service_name (postlog)
86 The name of the postlogd(8) service entry in master.cf.
87
89 postconf(5), configuration parameters
90 postlogd(8), Postfix logging
91 syslogd(8), system logging
92
94 The Secure Mailer license must be distributed with this software.
95
97 The postlog(1) command was introduced with Postfix version 3.4.
98
100 Wietse Venema
101 IBM T.J. Watson Research
102 P.O. Box 704
103 Yorktown Heights, NY 10598, USA
104
105 Wietse Venema
106 Google, Inc.
107 111 8th Avenue
108 New York, NY 10011, USA
109
110
111
112 POSTLOG(1)