POSTLOG(1) POSTLOG(1)
名称
postlog - Postfix 兼容的日志记录工具
概要
postlog [-iv] [-c 配置目录] [-p 优先级] [-t 标签] [文本...]
描述
postlog(1) 命令实现了与 Postfix 兼容的日志记录接口，可用于 shell 脚本等场景。
默认情况下，postlog(1) 会将命令行中指定的 文本 记录为单条日志。若未在命令行中指定 文本，则从标准输入读取内容，并将每行输入记录为单独的日志条目。
日志会被发送至 syslogd(8) 或 postlogd(8) 服务，同时输出到标准错误流（在 Postfix 3.8 之前的版本中，仅当标准错误流连接到终端时才会输出）。
支持以下选项：
-c 配置目录
使用指定目录中的 main.cf 配置文件，而非默认配置目录。
-i（已废弃）
在日志标签中包含进程 ID。从 Postfix 3.4 开始，此标志将被忽略，因为 PID 会始终包含。
-p 优先级（默认：info）
指定日志级别：info（信息）、warn（警告）、error（错误）、fatal（致命）或 panic（紧急）。Postfix 3.1 及更高版本中，程序在报告 fatal 或 panic 状态后会暂停 1 秒，与其他 Postfix 程序行为一致。
-t 标签
指定日志标签，即每条日志记录开头的标识名称。未指定时将使用默认标签。
-v
启用详细日志记录以进行调试。多次指定此选项可增加日志详细程度。
安全性
postlog(1) 命令设计为以 set-groupid 权限运行，以便能够连接到 postlogd(8) 守护进程（Postfix 3.7 及更高版本；此命令的早期实现不得具有 set-groupid 或 set-userid 权限）。
环境变量
MAIL_CONFIG
包含 main.cf 文件的目录路径。
配置参数
以下 main.cf 参数与本程序特别相关。
下文仅提供参数摘要，更多详细信息（包括示例）请参阅 postconf(5)。
config_directory（参见 'postconf -d' 输出）
Postfix main.cf 和 master.cf 配置文件的默认存储位置。
import_environment（参见 'postconf -d' 输出）
特权 Postfix 进程从非 Postfix 父进程继承的环境变量列表，或 name=value 形式的环境变量覆盖。
syslog_facility (mail)
Postfix 日志使用的 syslog 设施。
syslog_name（参见 'postconf -d' 输出）
预置在 syslog 记录中进程名称前的前缀，例如 "smtpd" 会变为 "prefix/smtpd"。
Postfix 3.4 及更高版本支持：
maillog_file（空）
由 Postfix postlogd(8) 服务写入的可选日志文件路径。
postlog_service_name (postlog)
postlogd(8) 服务在 master.cf 中的服务名称。
Postfix 3.9 及更高版本支持：
maillog_file_permissions (0600)
首次创建 $maillog_file 文件时，或在轮换现有文件后重新创建时设置的文件访问权限。
参见
postconf(5)，配置参数
postlogd(8)，Postfix 日志服务
syslogd(8)，系统日志服务
许可
必须随本软件一同分发 Secure Mailer 许可证。
历史
postlog(1) 命令随 Postfix 3.4 版本引入。
作者
Wietse Venema
IBM T.J. Watson 研究院
邮政信箱 704
美国纽约州约克镇高地，邮编 10598
Wietse Venema
Google 公司
纽约第八大道 111 号
美国纽约州，邮编 10011
POSTLOG(1)