.TH BOUNCE 5
.ad
.fi
.SH "نام (NAME)"
bounce \- قالب پیام‌های برگشتی (bounce) پُست‌فیکس (Postfix)
.SH "خلاصه دستور (SYNOPSIS)"
.na
.nf
\fBbounce_template_file = /etc/postfix/bounce.cf\fR

\fBpostconf \-b\fR [\fItemplate_file\fR]
.SH "توضیحات (DESCRIPTION)"
.ad
.fi
کارساز
.BR bounce (8)
پُست‌فیکس، پیام‌های اعلان وضعیت تحویل (DSN) را برای ایمیل‌های غیرقابل تحویل، ایمیل‌های دارای تأخیر، تحویل موفق یا درخواست‌های تأیید نشانی تولید می‌کند.
.PP
به‌طور پیش‌فرض، این اعلان‌ها از الگوهای توکار شامل سرآیندهای پیام و متن پیام ایجاد می‌شوند. مدیران سیستم می‌توانند با تعیین یک فایل الگوی برگشت (bounce) از طریق پارامتر پیکربندی
.BR bounce_template_file ،
اطلاعات پیش‌فرض توکار را بازنویسی و لغو کنند.
.PP
این سند روال کلی ایجاد یک فایل الگوی برگشت، و سپس جزئیات دقیق قالب‌های الگوی برگشت را شرح می‌دهد.
.SH "روال کلی (GENERAL PROCEDURE)"
.ad
.fi
برای ایجاد یک فایل الگوی برگشت سفارشی، یک نسخه موقت از فایل
.B /etc/postfix/bounce.cf.default
تهیه کرده و آن فایل موقت را ویرایش کنید.
.PP
برای پیش‌نمایش نتایج باز شدن و جایگزینی مقادیر
$\fIname\fR
در متن الگو، از دستور زیر استفاده کنید:
.PP
.nf
    \fBpostconf \-b\fR \fItemporary_file\fR
.fi
.PP
خطاهای موجود در الگو به جریان خروجی خطای استاندارد و دیمن
syslog
گزارش خواهند شد.
.PP
هنگام پیش‌نمایش متن، حتماً توجه ویژه‌ای به بسط پارامترهای مقدار زمانی داشته باشید که در متن اعلان ایمیل دارای تأخیر ظاهر می‌شوند.
.PP
پس از رضایت‌بخش بودن نتیجه، الگو را در دایرکتوری پیکربندی پُست‌فیکس رونوشت کرده و در
main.cf
عبارتی شبیه به زیر را مشخص کنید:
.PP
.nf
/etc/postfix/main.cf:
    bounce_template_file = /etc/postfix/bounce.cf
.fi
.SH "قالب فایل الگو (TEMPLATE FILE FORMAT)"
.ad
.fi
فایل الگو می‌تواند الگوهایی را برای ایمیل‌های ناموفق، ایمیل‌های دارای تأخیر، تحویل موفق یا تأیید نشانی مشخص کند. این الگوها به ترتیب با نام‌های
.BR failure_template ،
.BR delay_template ،
.B success_template
و
.B verify_template
نامیده می‌شوند. شما می‌توانید، اما مجبور نیستید، هر چهار الگو را در یک فایل الگوی برگشت مشخص کنید.
.PP
هر الگو با عبارت
"\fItemplate_name\fB = <<EOF\fR"
آغاز می‌شود و با خطی که فقط شامل کلمه
"\fBEOF\fR"
است پایان می‌یابد. می‌توانید کلمه EOF را تغییر دهید، اما نمی‌توانید آن را مانند شل یا پرل در داخل گیومه قرار دهید (\fItemplate_name\fB = <<'EOF'\fR). در ادامه یک نمونه آورده شده است:
.PP
.nf
    # الگوی failure_template برای ایمیل‌های غیرقابل تحویل استفاده می‌شود.

    failure_template = <<EOF
    Charset: us\-ascii
    From: MAILER\-DAEMON (Mail Delivery System)
    Subject: Undelivered Mail Returned to Sender
    Postmaster\-Subject: Postmaster Copy: Undelivered Mail

    This is the mail system at host $myhostname.

    I'm sorry to have to inform you that your message could not
    be delivered to one or more recipients. It's attached below.

    For further assistance, please send mail to postmaster.

    If you do so, please include this problem report. You can
    delete your own text from the attached returned message.

                       The mail system
    EOF
.fi
.PP
استفاده و تعیین الگوهای برگشت مشمول محدودیت‌های زیر است:
.IP \(bu
هیچ معنای خاصی به نویسه بک‌اسلش یا فاصله‌های خالی ابتدای خط داده نمی‌شود؛ این موارد همیشه به‌صورت عینی و لفظی در نظر گرفته می‌شوند.
.IP \(bu
درون بافت <<، نویسه «$» معنای ویژه دارد. برای تولید یک نویسه «$» واقعی در خروجی، مقدار «$$» را مشخص کنید.
.IP \(bu
در خارج از بافت <<، خطوطی که با «#» آغاز می‌شوند نادیده گرفته می‌شوند، همان‌طور که خطوط خالی و خطوطی که فقط از فاصله‌های خالی تشکیل شده‌اند نادیده گرفته خواهند شد.
.PP
نمونه‌هایی از تمام الگوها را می‌توان در فایل
.B bounce.cf.default
در دایرکتوری پیکربندی پُست‌فیکس یافت.
.SH "قالب سرآیند الگو (TEMPLATE HEADER FORMAT)"
.ad
.fi
بخش نخست از یک الگوی برگشت شامل سرآیندهای اختیاری الگو است. برخی از آن‌ها به سرآیندهای پیام در اعلان وضعیت تحویل تبدیل می‌شوند؛ برخی دیگر قالب‌بندی آن اعلان را کنترل می‌کنند. سرآیندهایی که در یک الگو مشخص نشده باشند، روی مقدار پیش‌فرض خود باقی می‌مانند.
.PP
سرآیندهای زیر پشتیبانی می‌شوند:
.IP \fBCharset:\fR
مجموعه نویسه‌های MIME برای متن پیام الگو. توضیحات «قالب متن پیام الگو» را در ادامه ببینید.
.IP \fBFrom:\fR
نشانی فرستنده در سرآیند پیام اعلان وضعیت تحویل.
.IP \fBSubject:\fR
موضوع در سرآیند پیام اعلان وضعیت تحویل که به فرستنده بازگردانده می‌شود.
.IP \fBPostmaster\-Subject:\fR
موضوعی که در رونوشت‌های مدیر پست (Postmaster) از اعلان‌های ایمیل ناموفق یا دارای تأخیر استفاده خواهد شد. این رونوشت‌ها تحت کنترل پارامتر پیکربندی notify_classes ارسال می‌شوند.
.PP
استفاده و مشخص‌سازی سرآیندهای پیام الگو مشمول محدودیت‌های زیر است:
.IP \(bu
نام سرآیندهای پیام الگو می‌تواند با حروف بزرگ، کوچک یا ترکیبی مشخص شود. پُست‌فیکس همیشه برچسب‌های سرآیند پیام برگشتی را به شکل
"\fBFrom:\fR"
و
"\fBSubject:\fR"
تولید می‌کند.
.IP \(bu
سرآیندهای پیام الگو نباید در چند خط گسترش یابند.
.IP \(bu
سرآیندهای پیام الگو از گسترش پارامترهای $parameter پشتیبانی نمی‌کنند.
.IP \(bu
سرآیندهای پیام الگو فقط باید شامل نویسه‌های ASCII باشند و نباید نویسه‌های تهی (null) در کدگذاری ASCII را شامل شوند.
.SH "قالب متن پیام الگو (TEMPLATE MESSAGE TEXT FORMAT)"
.ad
.fi
بخش دوم یک الگوی برگشت شامل متن پیام است. همان‌طور که در مثال بالا نشان داده شده است، متن پیام الگو می‌تواند حاوی $parameters از فایل main.cf باشد. علاوه بر پارامترهایی که در main.cf تعریف شده‌اند، پارامترهای زیر نیز بسته به پسوندی که به انتهای نام آن‌ها اضافه می‌شود، به‌طور ویژه مدیریت می‌شوند:
.IP \fBdelay_warning_time_\fIsuffix\fR
به مقدار پارامتر
.B delay_warning_time
گسترش می‌یابد، که در واحد زمانی مشخص‌شده توسط
.I suffix
بیان می‌شود و یکی از مقادیر
.BR seconds ،
.BR minutes ،
.BR hours ،
.B days
یا
.B weeks
است.
.IP \fBmaximal_queue_lifetime_\fIsuffix\fR
به مقدار پارامتر
.B maximal_queue_lifetime
گسترش می‌یابد، که در واحد زمانی مشخص‌شده توسط
.I suffix
بیان می‌شود. برای مقادیر مجاز
.I suffix
به بخش
.B delay_warning_time
در بالا مراجعه کنید.
.IP \fBmydomain\fR
به مقدار پارامتر
.B mydomain
گسترش می‌یابد. با تنظیم "smtputf8_enable = yes"، این ویژگی برچسب‌های ACE (مانند xn\-\-mumble) را با معادل UTF\-8 آن‌ها جایگزین می‌کند.
.sp
این قابلیت از نسخه Postfix 3.0 در دسترس است.
.IP \fBmyhostname\fR
به مقدار پارامتر
.B myhostname
گسترش می‌یابد. با تنظیم "smtputf8_enable = yes"، این ویژگی برچسب‌های ACE (مانند xn\-\-mumble) را با معادل UTF\-8 آن‌ها جایگزین می‌کند.
.sp
این قابلیت از نسخه Postfix 3.0 در دسترس است.
.PP
استفاده و مشخص‌سازی متن پیام الگو مشمول محدودیت‌های زیر است:
.IP \(bu
متن پیام الگو در رونوشت‌های مدیر پست (Postmaster) از اعلان‌های وضعیت تحویل ارسال نمی‌شود.
.IP \(bu
اگر متن پیام الگو شامل نویسه‌های غیر ASCII باشد، پُست‌فیکس الزام می‌کند که سرآیند الگوی
.B Charset:
به‌روزرسانی شود. یک زَبَرمجموعه مناسب از US\-ASCII را مشخص کنید. تعیین یک زبرمجموعه ضروری است زیرا پُست‌فیکس هنگام ارسال اعلان وضعیت تحویل، متن ASCII را به انتهای الگوی پیام پیوست می‌کند.
.SH "همچنین ببینید (SEE ALSO)"
.na
.nf
bounce(8), اعلان‌های وضعیت تحویل پُست‌فیکس
postconf(5), پارامترهای پیکربندی
.SH "مجوز (LICENSE)"
.ad
.fi
مجوز Secure Mailer باید همراه با این نرم‌افزار توزیع شود.
.SH "تاریخچه (HISTORY)"
.ad
.fi
قالب الگوی برگشت (bounce) در پُست‌فیکس در ابتدا توسط Nicolas Riendeau توسعه داده شد.
.SH "نویسندگان (AUTHORS)"
.na
.nf
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