نام (NAME)

bounce - گزارش‌های وضعیت تحویل در Postfix

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

bounce [generic Postfix daemon options]

توضیحات (DESCRIPTION)

دیمن bounce(8) فایل‌های گزارش وضعیت تحویل را به ازای هر پیام نگهداری می‌کند. نام هر فایل گزارش برگرفته از فایل صف متناظر با آن است، و در زیردایرکتوری‌ای از صف نگهداری می‌شود که نام آن با توجه به نام سرویس در فایل master.cf (یکی از bounce، defer یا trace) تعیین شده است. این برنامه انتظار دارد که از طریق مدیر فرایند master(8) اجرا شود.

دیمن bounce(8) دو نوع درخواست سرویس را پردازش می‌کند:

افزودن رکورد وضعیت تحویل (یا عدم تحویل) به یک گیرنده به فایل گزارش هر پیام.
قرار دادن پیام اعلان وضعیت تحویل در صف، به همراه یک نسخه از فایل گزارش آن پیام و پیام متناظر. هنگامی که پیام اعلان وضعیت تحویل با موفقیت در صف قرار گرفت، فایل گزارش آن پیام حذف می‌شود.

این نرم‌افزار نهایت تلاش خود را برای ارسال اعلان به کار می‌گیرد. حتی در صورتی که فایل گزارش یا پیام اصلی قابل خواندن نباشد، یک اعلان عدم تحویل ارسال می‌شود.

به‌صورت اختیاری، یک کلاینت bounce (یا defer، trace) می‌تواند درخواست کند که در صورت شکست عملیات درخواستی، فایل گزارش پیام حذف شود. این سازوکار توسط کلاینت‌هایی استفاده می‌شود که خودشان نمی‌توانند تراکنش‌ها را مجدداً امتحان کنند و به منطق تلاش مجدد در سمت کلاینت خود متکی هستند.

استانداردها (STANDARDS)

RFC 822 (پیام‌های متنی اینترنت ARPA)
RFC 2045 (قالب بدنه پیام‌های اینترنتی)
RFC 2822 (قالب پیام‌های اینترنتی)
RFC 3462 (اعلان‌های وضعیت تحویل)
RFC 3464 (اعلان‌های وضعیت تحویل)
RFC 3834 (سرآیند پیام Auto-Submitted:)
RFC 5322 (قالب پیام‌های اینترنتی)
RFC 6531 (پروتکل SMTP بین‌المللی‌شده)
RFC 6532 (قالب پیام بین‌المللی‌شده)
RFC 6533 (اعلان‌های وضعیت تحویل بین‌المللی‌شده)

عیب‌یابی (DIAGNOSTICS)

مشکلات و تراکنش‌ها در syslogd(8) یا postlogd(8) ثبت می‌شوند.

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

تغییرات اعمال‌شده در main.cf به‌صورت خودکار اعمال می‌شوند، زیرا فرایندهای bounce(8) تنها برای مدت محدودی اجرا می‌شوند. برای تسریع در اعمال تغییرات، از دستور "postfix reload" استفاده کنید.

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

2bounce_notice_recipient (postmaster): گیرنده نامه‌های غیرقابل‌تحویلی که نمی‌توان آن‌ها را به فرستنده بازگرداند.
backwards_bounce_logfile_compatibility (yes): تولید رکوردهای اضافی در فایل گزارش bounce(8) که برای نسخه‌های قبل از 2.0 در Postfix قابل خواندن باشند.
bounce_notice_recipient (postmaster): گیرنده اعلان‌های مدیر پست (postmaster) حاوی سرآیندهای نامه‌هایی که Postfix تحویل نداده است، و رونوشت روندهای گفتگوی SMTP برای نامه‌هایی که Postfix دریافت نکرده است.
bounce_size_limit (50000): حداکثر مقدار متن پیام اصلی که در یک اعلان عدم تحویل ارسال می‌شود.
bounce_template_file (empty): مسیر فایل پیکربندی حاوی الگوهای پیام برگشتی (bounce).
config_directory (see 'postconf -d' output): محل پیش‌فرض فایل‌های پیکربندی main.cf و master.cf در Postfix.
daemon_timeout (18000s): مدت زمانی که یک فرایند دیمن Postfix مجاز است برای رسیدگی به یک درخواست صرف کند، پیش از آنکه توسط تایمر نظارتی داخلی متوقف شود.
delay_notice_recipient (postmaster): گیرنده اعلان‌های مدیر پست (postmaster) حاوی سرآیندهای پیام‌هایی که در بازه زمانی تعیین‌شده با $delay_warning_time تحویل داده نشده‌اند.
deliver_lock_attempts (20): حداکثر تعداد تلاش‌ها برای به‌دست آوردن قفل انحصاری روی فایل صندوق پستی یا فایل گزارش bounce(8).
deliver_lock_delay (1s): فاصله زمانی میان تلاش‌ها برای به‌دست آوردن قفل انحصاری روی فایل صندوق پستی یا فایل گزارش bounce(8).
ipc_timeout (3600s): محدودیت زمانی برای ارسال یا دریافت اطلاعات از طریق یک کانال ارتباطی داخلی.
internal_mail_filter_classes (empty): دسته‌هایی از نامه‌های تولیدشده توسط Postfix که مشمول بازرسی محتوا پیش از صف (before-queue) از طریق non_smtpd_milters، header_checks و body_checks می‌شوند.
mail_name (Postfix): نام سیستم پستی که در سرآیندهای Received:، بنر خوش‌آمدگویی SMTP و نامه‌های برگشتی نمایش داده می‌شود.
max_idle (100s): حداکثر مدت زمانی که یک فرایند دیمن بیکار Postfix پیش از پایان دادن داوطلبانه به کار خود، در انتظار اتصال ورودی می‌ماند.
max_use (100): حداکثر تعداد اتصالات ورودی که یک فرایند دیمن Postfix پیش از پایان دادن داوطلبانه به کار خود، به آن‌ها پاسخ می‌دهد.
notify_classes (resource, software): فهرست رده‌های خطایی که به مدیر پست (postmaster) گزارش می‌شوند.
process_id (read-only): شناسه فرایند (PID) یک دستور یا فرایند دیمن Postfix.
process_name (read-only): نام فرایند یک دستور یا فرایند دیمن Postfix.
queue_directory (see 'postconf -d' output): محل دایرکتوری سطح بالای صف در Postfix.
syslog_facility (mail): تسهیلات لاگ (syslog facility) برای سیستم ثبت گزارش Postfix.
syslog_name (see 'postconf -d' output): پیشوندی که در رکوردهای syslog به ابتدای نام فرایند اضافه می‌شود، به طوری که به عنوان مثال "smtpd" به "prefix/smtpd" تبدیل می‌شود.

در Postfix نسخه 3.0 و بالاتر موجود است:

smtputf8_autodetect_classes (sendmail, verify): تشخیص این که یک پیام برای رده‌های مبدا مشخص‌شده نامه، نیازمند پشتیبانی از SMTPUTF8 است.

در Postfix نسخه 3.3 و بالاتر موجود است:

service_name (read-only): نام سرویس یک فرایند دیمن Postfix در master.cf.

در Postfix نسخه 3.6 و بالاتر موجود است:

enable_threaded_bounces (no): فعال‌سازی اعلان‌های عدم تحویل، تحویل موفق و تاخیر به گونه‌ای که با گنجاندن سرآیندهای References: و In-Reply-To: همراه با مقدار Message-ID اصلی، به پیام اولیه متصل و زنجیره‌بندی شوند.

در Postfix نسخه 3.7 و بالاتر موجود است:

header_from_format (standard): قالب سرآیند From: تولیدشده توسط Postfix.

در Postfix نسخه 3.10 و بالاتر موجود است:

tls_required_enable (yes): فعال‌سازی پشتیبانی از سرآیند پیام "TLS-Required: no" که در RFC 8689 تعریف شده است.

در Postfix نسخه 3.11 و بالاتر موجود است:

requiretls_redact_dsn (yes): هنگام ارسال اعلان وضعیت تحویل برای پیامی اصلی که با گزینه REQUIRETLS دریافت شده است، بدنه پیام اصلی ارسال نشود (همانند حالتی که پیام با "RET=HDRS" دریافت شده باشد) و الزام REQUIRETLS نیز اعمال نگردد (همانند حالتی که پیام بدون REQUIRETLS دریافت شده باشد).

فایل‌ها (FILES)

/var/spool/postfix/bounce/* رکوردهای عدم تحویل
/var/spool/postfix/defer/* رکوردهای عدم تحویل
/var/spool/postfix/trace/* رکوردهای وضعیت تحویل

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

bounce(5)، قالب الگوی پیام برگشتی (bounce)
qmgr(8)، مدیر صف
postconf(5)، پارامترهای پیکربندی
master(5)، گزینه‌های عمومی دیمن
master(8)، مدیر فرایندها
postlogd(8)، سیستم ثبت گزارش Postfix
syslogd(8)، سیستم ثبت گزارش سیستمی

مجوز (LICENSE)

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

نویسندگان (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
Wietse Venema
porcupine.org