111 lines
3.3 KiB
Groff
111 lines
3.3 KiB
Groff
.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_file 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
|
|
|
|
Wietse Venema
|
|
porcupine.org
|