NAME
postlog - Postfix-compatible logging utilitySYNOPSIS
postlog [-iv] [-c config_dir] [ -p priority] [ -t tag] [text...]
DESCRIPTION
The command implements a Postfix-compatible logging interface for use in, for example, shell scripts.
- -c config_dir
- Read the main.cf configuration file in the named directory instead of the default configuration directory.
- -i (obsolete)
- Include the process ID in the logging tag. This flag is ignored as of Postfix 3.4, where the PID is always included.
- -p priority (default: info)
- Specifies the logging severity: info, warn, error, fatal, or panic. With Postfix 3.1 and later, the program will pause for 1 second after reporting a fatal or panic condition, just like other Postfix programs.
- -t tag
- Specifies the logging tag, that is, the identifying name that appears at the beginning of each logging record. A default tag is used when none is specified.
- -v
- Enable verbose logging for debugging purposes. Multiple -v options make the software increasingly verbose.
SECURITY
The command is designed to run with set-groupid privileges, so that it can connect to the postlogd(8) daemon process (Postfix 3.7 and later; earlier implementations of this command must not have set-groupid or set-userid permissions).
ENVIRONMENT
- MAIL_CONFIG
- Directory with the main.cf file.
CONFIGURATION PARAMETERS
The following main.cf parameters are especially relevant to this program.
- config_directory (see 'postconf -d' output)
- The default location of the Postfix main.cf and master.cf configuration files.
- import_environment (see 'postconf -d' output)
- The list of environment parameters that a privileged Postfix process will import from a non-Postfix parent process, or name=value environment overrides.
- syslog_facility (mail)
- The syslog facility of Postfix logging.
- syslog_name (see 'postconf -d' output)
- A prefix that is prepended to the process name in syslog records, so that, for example, "smtpd" becomes "prefix/smtpd".
- maillog_file (empty)
- The name of an optional logfile that is written by the Postfix postlogd(8) service.
- postlog_service_name (postlog)
- The name of the postlogd(8) service entry in master.cf.
SEE ALSO
postconf(5), configuration parameters postlogd(8), Postfix logging syslogd(8), system logging
LICENSE
The Secure Mailer license must be distributed with this software.
HISTORY
The command was introduced with Postfix version 3.4.
AUTHOR(S)
Wietse Venema IBM T.J. Watson Research P.O. Box 704 Yorktown Heights, NY 10598, USA Wietse Venema Google, Inc. 111 8th Avenue New York, NY 10011, USA