1POSTLOG(1)                  General Commands Manual                 POSTLOG(1)
2
3
4

NAME

6       postlog - Postfix-compatible logging utility
7

SYNOPSIS

9       postlog [-iv] [-c config_dir] [-p priority] [-t tag] [text...]
10

DESCRIPTION

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

SECURITY

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

ENVIRONMENT

53       MAIL_CONFIG
54              Directory with the main.cf file.
55

CONFIGURATION PARAMETERS

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

SEE ALSO

89       postconf(5), configuration parameters
90       postlogd(8), Postfix logging
91       syslogd(8), system logging
92

LICENSE

94       The Secure Mailer license must be distributed with this software.
95

HISTORY

97       The postlog(1) command was introduced with Postfix version 3.4.
98

AUTHOR(S)

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)
Impressum