نام (NAME)

postlog - ابزار ثبت وقایع سازگار با Postfix

خلاصه دستور (SYNOPSIS)

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

توضیحات (DESCRIPTION)

دستور postlog(1) یک رابط ثبت وقایع (لاگ‌گیری) سازگار با Postfix را برای استفاده در مواردی همچون اسکریپت‌های شل پیاده‌سازی می‌کند.

به‌طور پیش‌فرض، postlog(1) متن text مشخص‌شده در خط فرمان را به عنوان یک رکورد ثبت می‌کند. در صورتی که هیچ text مشخص نشده باشد، postlog(1) از ورودی استاندارد خوانده و هر سطر ورودی را به عنوان یک رکورد ثبت می‌نماید.

گزارش‌ها به syslogd(8) یا postlogd(8) و همچنین جریان خطای استاندارد ارسال می‌شوند (در Postfix قبل از نسخه ۳.۸، postlog(1) تنها در صورتی روی جریان خطای استاندارد می‌نویسد که آن جریان به یک ترمینال متصل باشد).

گزینه‌های زیر پیاده‌سازی شده‌اند:

-c config_dir: فایل پیکربندی main.cf به جای دایرکتوری پیش‌فرض، در دایرکتوری مشخص‌شده قرار دارد. همچنین تنظیمات متغیر محیطی MAIL_CONFIG در زیر را ببینید.
-i (منسوخ): گنجاندن شناسه فرایند (PID) در برچسب ثبت وقایع. این پرچم از Postfix 3.4 به بعد نادیده گرفته می‌شود؛ چرا که در این نگارش‌ها، PID همیشه درج می‌گردد.
-p priority (پیش‌فرض: info): میزان اهمیت و اولویت ثبت گزارش را مشخص می‌کند: info، warn، error، fatal، یا panic. در Postfix 3.1 و جدیدتر، برنامه درست مانند دیگر برنامه‌های Postfix پس از گزارش یک وضعیت fatal یا panic به مدت ۱ ثانیه مکث خواهد کرد.
-t tag: برچسب ثبت وقایع را مشخص می‌کند؛ یعنی نام شناسایی‌کننده‌ای که در ابتدای هر رکورد لاگ ظاهر می‌شود. در صورت مشخص نشدن، از یک برچسب پیش‌فرض استفاده می‌شود.
-v: ثبت گزارش با جزئیات بیشتر را برای اهداف اشکال‌زدایی فعال می‌کند. تکرار گزینه -v موجب افزایش بیشتر جزئیات خروجی نرم‌افزار می‌شود.

امنیت (SECURITY)

دستور postlog(1) طوری طراحی شده است که با امتیازات set-groupid اجرا شود تا بتواند به فرایند دیمن postlogd(8) متصل گردد (Postfix 3.7 و بالاتر؛ پیاده‌سازی‌های پیشین این دستور نباید دسترسی‌های set-groupid یا set-userid داشته باشند).

محیط (ENVIRONMENT)

MAIL_CONFIG: دایرکتوری حاوی فایل main.cf. به منظور جلوگیری از سوءاستفاده از امتیازات set-group ID، استفاده از یک دایرکتوری غیرپیش‌فرض تنها در موارد زیر مجاز است:

نام آن در فایل main.cf پیش‌فرض با پارامتر پیکربندی alternate_config_directories یا multi_instance_directories فهرست شده باشد.
دستور توسط کاربر ریشه یا مدیر سیستم (super-user) فراخوانی شده باشد.

پارامترهای پیکربندی (CONFIGURATION PARAMETERS)

پارامترهای زیر در main.cf به‌ویژه با این برنامه مرتبط هستند.

متن زیر تنها خلاصه‌ای از پارامترها را ارائه می‌دهد. برای جزئیات بیشتر شامل مثال‌ها، postconf(5) را ببینید.

config_directory (خروجی 'postconf -d' را ببینید): محل پیش‌فرض فایل‌های پیکربندی main.cf و master.cf در Postfix.
import_environment (خروجی 'postconf -d' را ببینید): فهرست متغیرهای محیطی که یک فرایند باامتیاز Postfix از یک فرایند والد غیر-Postfix وارد می‌کند، یا بازنویسی‌های متغیرهای محیطی به صورت name=value.
syslog_facility (mail): امکانات یا دسته‌بندی (facility) مربوط به syslog در ثبت وقایع Postfix.
syslog_name (خروجی 'postconf -d' را ببینید): پیشوندی که در رکوردهای syslog به نام فرایند الحاق می‌شود؛ برای نمونه "smtpd" به "prefix/smtpd" تبدیل می‌شود.

در دسترس از Postfix 3.4 و بالاتر:

maillog_file (خالی): نام یک فایل لاگ اختیاری که توسط سرویس postlogd(8) در Postfix نوشته می‌شود.
postlog_service_name (postlog): نام مدخل سرویس postlogd(8) در master.cf.

در دسترس از Postfix 3.9 و بالاتر:

maillog_file_permissions (0600): مجوزهای دسترسی به فایل که هنگام ایجاد فایل $maillog_file برای بار اول، یا ایجاد فایل پس از چرخش (rotate) فایل موجود تنظیم می‌شود.

همچنین ببینید (SEE ALSO)

postconf(5)، پارامترهای پیکربندی
postlogd(8)، ثبت وقایع Postfix
syslogd(8)، ثبت وقایع سیستم

مجوز (LICENSE)

مجوز نرم‌افزار Secure Mailer باید به همراه این نرم‌افزار توزیع شود.

تاریخچه (HISTORY)

دستور postlog(1) در نسخه 3.4 برنامه Postfix معرفی شد.

نویسندگان (AUTHORS)

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