info > postlog(1)

man perldoc info pydoc3 ri search

📛 NAME

postlog - Postfix-compatible logging utility

🚀 Quick Reference

Use Case	Command	Description
📝 Log a message	postlog "message"	Logs the given text as one record via syslog
⚠️ Log with priority	postlog -p warn "message"	Specify severity: info, warn, error, fatal, panic
📄 Log from stdin	echo "line" | postlog	Reads input lines and logs each as one record
🏷️ Custom tag	postlog -t myapp "message"	Sets the identifying logging tag
🔍 Verbose debug	postlog -v -v "message"	Enable increasingly verbose logging
📂 Custom config	postlog -c /path/to/config "message"	Read main.cf from alternative directory
🆔 PID in tag (obsolete)	postlog -i "message"	Ignored as of Postfix 3.4; PID always included

📋 SYNOPSIS

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

📖 DESCRIPTION

The postlog(1) command implements a Postfix-compatible logging interface for use in, for example, shell scripts.

By default, postlog(1) logs the text given on the command line as one record. If no text is specified on the command line, postlog(1) reads from standard input and logs each input line as one record.

By default, logging is sent to syslogd(8) or postlogd(8); when the standard error stream is connected to a terminal, logging is sent there as well.

⚙️ Options

• -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.

🌍 ENVIRONMENT

• MAIL_CONFIG 📁 Directory with the main.cf file.

⚙️ CONFIGURATION PARAMETERS

The following main.cf parameters are especially relevant to this program. The text below provides only a parameter summary. See postconf(5) for more details including examples.

• 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 (default: 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.

🆕 Available in Postfix 3.4 and later

• maillog_file (default: empty) — 📄 The name of an optional logfile that is written by the Postfix postlogd(8) service.
• postlog_service_name (default: 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.

👤 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

📛 NAME 🚀 Quick Reference 📋 SYNOPSIS 📖 DESCRIPTION 🌍 ENVIRONMENT ⚙️ CONFIGURATION PARAMETERS 📚 SEE ALSO 📜 LICENSE 👤 AUTHOR(S)