summaryrefslogtreecommitdiffstats
path: root/man/man8/postlogd.8
blob: aeb95c7d8abd8ed345d0e251a53f2b2c45ab267e (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
.TH POSTLOGD 8 
.ad
.fi
.SH NAME
postlogd
\-
Postfix internal log server
.SH "SYNOPSIS"
.na
.nf
\fBpostlogd\fR [generic Postfix daemon options]
.SH DESCRIPTION
.ad
.fi
This program logs events on behalf of Postfix programs
when the maillog configuration parameter specifies a non\-empty
value.
.SH BUGS
.ad
.fi
Non\-daemon Postfix programs don't know that they should log
to the internal logging service before they have processed
command\-line options and main.cf parameters. These programs
still log earlier events to the syslog service.

If Postfix is down, the non\-daemon programs \fBpostfix\fR(1),
\fBpostsuper\fR(1), \fBpostmulti\fR(1), and \fBpostlog\fR(1),
will log directly to \fB$maillog_file\fR. These programs
expect to run with root privileges, for example during
Postfix start\-up, reload, or shutdown.

Other non\-daemon Postfix programs will never write directly to
\fB$maillog_file\fR (also, logging to stdout would interfere
with the operation of some of these programs). These programs
can log to \fBpostlogd\fR(8) if they are run by the super\-user,
or if their executable file has set\-gid permission. Do not
set this permission on programs other than \fBpostdrop\fR(1),
\fBpostqueue\fR(1) and (Postfix >= 3.7) \fBpostlog\fR(1).
.SH "CONFIGURATION PARAMETERS"
.na
.nf
.ad
.fi
Changes to \fBmain.cf\fR are not picked up automatically,
because \fBpostlogd\fR(8) terminates only after reaching
the \fBmax_idle\fR time limit.
Use the command "\fBpostfix reload\fR" to speed up a change.

The text below provides only a parameter summary. See
\fBpostconf\fR(5) for more details including examples.
.IP "\fBconfig_directory (see 'postconf -d' output)\fR"
The default location of the Postfix main.cf and master.cf
configuration files.
.IP "\fBmaillog_file (empty)\fR"
The name of an optional logfile that is written by the Postfix
\fBpostlogd\fR(8) service.
.IP "\fBprocess_id (read\-only)\fR"
The process ID of a Postfix command or daemon process.
.IP "\fBprocess_name (read\-only)\fR"
The process name of a Postfix command or daemon process.
.IP "\fBsyslog_name (see 'postconf -d' output)\fR"
A prefix that is prepended to the process name in syslog
records, so that, for example, "smtpd" becomes "prefix/smtpd".
.IP "\fBservice_name (read\-only)\fR"
The master.cf service name of a Postfix daemon process.
.IP "\fBpostlogd_watchdog_timeout (10s)\fR"
How much time a \fBpostlogd\fR(8) process may take to process a request
before it is terminated by a built\-in watchdog timer.
.PP
Available in Postfix 3.9 and later:
.IP "\fBmaillog_file_permissions (0600)\fR"
The file access permissions that will be set when the file
$maillog_file is created for the first time, or when the file is
created after an existing file is rotated.
.SH "SEE ALSO"
.na
.nf
postconf(5), configuration parameters
syslogd(8), system logging
.SH "README_FILES"
.na
.nf
.ad
.fi
Use "\fBpostconf readme_directory\fR" or
"\fBpostconf html_directory\fR" to locate this information.
.na
.nf
MAILLOG_README, Postfix logging to file or stdout
.SH "LICENSE"
.na
.nf
.ad
.fi
The Secure Mailer license must be distributed with this software.
.SH HISTORY
.ad
.fi
.ad
.fi
This service was introduced with Postfix version 3.4.
.SH "AUTHOR(S)"
.na
.nf
Wietse Venema
Google, Inc.
111 8th Avenue
New York, NY 10011, USA