summaryrefslogtreecommitdiffstats
path: root/man/man8/postlogd.8
blob: 9168a3429dd1306f295e548ac4f828d54ad1495c (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
.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 picked up automatically, as
\fBpostlogd\fR(8) processes run for only a limited amount
of time. 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.
.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