.TH RELOCATED 5
.ad
.fi
.SH "نام (NAME)"
relocated \- قالب جدول جابه‌جاشدگان پست‌فیکس (Postfix)
.SH "خلاصه دستور (SYNOPSIS)"
.na
.nf
\fBpostmap /etc/postfix/relocated\fR
.SH "توضیحات (DESCRIPTION)"
.ad
.fi
جدول اختیاری
.BR relocated (5)
اطلاعاتی را فراهم می‌کند که در پیام‌های برگشتی (bounce) با مضمون «کاربر به \fInew_location\fR منتقل شده است» به‌کار می‌روند.

به‌طور معمول، جدول
.BR relocated (5)
به‌عنوان یک فایل متنی مشخص می‌شود که به‌عنوان ورودی به دستور
.BR postmap (1)
داده می‌شود تا فایلی نمایه‌سازی‌شده (indexed) برای جستجوی سریع ایجاد گردد.

برای بازسازی یک فایل نمایه‌سازی‌شده از نوع پیش‌فرض پس از تغییر فایل متنی، دستور
«\fBpostmap /etc/postfix/relocated\fR»
را اجرا کنید، یا برای تعیین یک نوع صریح، دستور
«\fBpostmap \fItype\fB:/etc/postfix/relocated\fR»
را به‌کار ببرید.

نوع فایل نمایه‌سازی‌شده پیش‌فرض با پارامتر
.B default_database_type
پیکربندی می‌شود. بسته به بستر اجرایی (پلتفرم)، این مقدار ممکن است یکی از موارد
.BR lmdb: ،
.BR cdb: ،
.B hash:
یا
.B dbm:
(بدون دو‌نقطه انتهایی) باشد.

هنگامی که جدول از روش‌های دیگری مانند NIS، LDAP یا SQL ارائه شود، همان جستجوهایی انجام می‌گیرد که برای فایل‌های نمایه‌سازی‌شده معمولی انجام می‌شود. مدیریت چنین پایگاه‌های داده‌ای خارج از حوزه وظایف Postfix است.

همچنین، این جدول می‌تواند به‌صورت یک نگاشت عبارت منظم ارائه شود که در آن الگوها در قالب عبارات منظم داده می‌شوند، یا اینکه جستجوها به یک کارساز مبتنی بر TCP هدایت شوند. در این حالت‌ها، جستجوها به‌گونه‌ای اندکی متفاوت انجام می‌شوند که در ادامه در بخش‌های «جدول‌های عبارت منظم» یا «جدول‌های مبتنی بر TCP» شرح داده شده است.

جستجوهای جدول به بزرگ و کوچکی حروف حساس نیستند (case insensitive).
.SH "تبدیل حروف (CASE FOLDING)"
.na
.nf
.ad
.fi
رشته جستجو پیش از جستجو در پایگاه داده، به حروف کوچک تبدیل می‌شود. از نسخه Postfix 2.3 به بعد، رشته جستجو برای انواع پایگاه داده مانند
.B regexp:
یا
.B pcre:
که فیلدهای جستجوی آن‌ها می‌توانند هم با حروف کوچک و هم حروف بزرگ مطابقت یابند، تبدیل حروف نمی‌شود.
.SH "قالب جدول (TABLE FORMAT)"
.na
.nf
.ad
.fi
.IP \(bu
به‌طور پیش‌فرض، Postfix پیشوند تغییرناپذیر «5.1.6 User has moved to » را به نتیجه جستجوی جدول اضافه می‌کند و قالب یک ورودی جدول به‌صورت زیر است:

.nf
     \fIpattern      new_location\fR
.fi

که در آن \fInew_location\fR اطلاعات تماس مانند نشانی ایمیل، یا احتمالاً نشانی پستی یا شماره تلفن را مشخص می‌کند.
.IP \(bu
در نسخه Postfix 3.11 و بالاتر می‌توان به‌صورت اختیاری این پیشوند تغییرناپذیر را غیرفعال کرد. مقدار
«relocated_prefix_enable = no»
را در
.B main.cf
تنظیم کنید و ورودی‌های
.B relocated_maps
را به همراه کد وضعیت بهبودیافته سازگار با RFC 3463 و متن دلخواه خود مشخص نمایید؛ برای نمونه:

.nf
     \fIpattern\fR      5.1.6 Mailbox has moved to user@example
     \fIpattern\fR      5.2.0 Mailbox is unavailable
     \fIpattern\fR      5.2.1 Mailbox is disabled
.fi
.IP \(bu
خطوط خالی و خطوطی که تنها شامل فاصله‌های سفید هستند نادیده گرفته می‌شوند، همانند خطوطی که نخستین نویسه غیرفاصله‌ای آن‌ها «#» است.
.IP \(bu
یک خط منطقی با یک متن غیرفاصله‌ای آغاز می‌شود. خطی که با فاصله سفید شروع شود ادامه یک خط منطقی محسوب می‌گردد.
.SH "ترتیب جستجوی جدول (TABLE SEARCH ORDER)"
.na
.nf
.ad
.fi
در جستجوها از فایل‌های نمایه‌سازی‌شده مانند DB یا DBM، یا از جدول‌های شبکه‌ای مانند NIS، LDAP یا SQL، الگوها به ترتیبی که در زیر آمده است بررسی می‌شوند:
.IP \fIuser\fR@\fIdomain\fR
با \fIuser\fR@\fIdomain\fR مطابقت دارد. این فرم نسبت به تمام فرم‌های دیگر اولویت دارد.
.IP \fIuser\fR
هنگامی که \fIsite\fR برابر $\fBmyorigin\fR باشد، هنگامی که \fIsite\fR در $\fBmydestination\fR فهرست شده باشد، یا هنگامی که \fIsite\fR در $\fBinet_interfaces\fR یا $\fBproxy_interfaces\fR فهرست شده باشد، با \fIuser\fR@\fIsite\fR مطابقت دارد.
.IP @\fIdomain\fR
با سایر نشانی‌ها در \fIdomain\fR مطابقت دارد. این فرم کمترین اولویت را دارد.
.SH "پسوند نشانی (ADDRESS EXTENSION)"
.na
.nf
.fi
.ad
هنگامی که بخش محلی (localpart) یک نشانی ایمیل شامل نویسه جداکننده اختیاری گیرنده باشد (برای نمونه، \fIuser+foo\fR@\fIdomain\fR)، ترتیب جستجو به‌صورت زیر خواهد بود:
\fIuser+foo\fR@\fIdomain\fR، \fIuser\fR@\fIdomain\fR، \fIuser+foo\fR،
\fIuser\fR و @\fIdomain\fR.
.SH "جدول‌های عبارت منظم (REGULAR EXPRESSION TABLES)"
.na
.nf
.ad
.fi
این بخش نحوه تغییر جستجوهای جدول را هنگامی که جدول در قالب عبارات منظم ارائه شده باشد یا هنگامی که جستجوها به یک کارساز مبتنی بر TCP هدایت شوند، شرح می‌دهد. برای مشاهده شرح نحو جدول جستجوی عبارت منظم،
.BR regexp_table (5)
یا
.BR pcre_table (5)
را ببینید. برای شرح قرارداد (پروتکل) جستجوی جدول کلاینت/کارساز TCP، به
.BR tcp_table (5)
مراجعه کنید. این قابلیت در Postfix 2.5 و نسخه‌های پس از آن در دسترس است.

هر الگو یک عبارت منظم است که بر کل نشانی مورد جستجو اعمال می‌شود. بنابراین، نشانی‌های ایمیل \fIuser@domain\fR به بخش‌های تشکیل‌دهنده \fIuser\fR و \fI@domain\fR شکسته نمی‌شوند و همچنین \fIuser+foo\fR به \fIuser\fR و \fIfoo\fR تفکیک نمی‌گردد.

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

نتایج همانند نتایج جستجو در فایل‌های نمایه‌سازی‌شده هستند، با این ویژگی افزوده که زیررشته‌های داخل پرانتز در الگو می‌توانند به‌صورت
.BR $1 ،
.B $2
و غیره جای‌گذاری شوند.
.SH "جدول‌های مبتنی بر TCP (TCP-BASED TABLES)"
.na
.nf
.ad
.fi
این بخش شرح می‌دهد که چگونه جستجوهای جدول در هنگام هدایت جستجوها به یک کارساز مبتنی بر TCP تغییر می‌کنند. برای شرح قرارداد جستجوی کلاینت/کارساز TCP،
.BR tcp_table (5)
را ببینید. این قابلیت در Postfix 2.5 و نسخه‌های پس از آن در دسترس است.

هر عملیات جستجو یک بار از کل نشانی استفاده می‌کند. بنابراین، نشانی‌های ایمیل \fIuser@domain\fR به بخش‌های تشکیل‌دهنده \fIuser\fR و \fI@domain\fR شکسته نمی‌شوند و \fIuser+foo\fR نیز به \fIuser\fR و \fIfoo\fR تفکیک نمی‌گردد.

نتایج مانند جستجو در فایل‌های نمایه‌سازی‌شده هستند.
.SH "اشکالات (BUGS)"
.ad
.fi
قالب جدول قراردادهای نقل‌قول (quoting conventions) را درک نمی‌کند.
.SH "پارامترهای پیکربندی (CONFIGURATION PARAMETERS)"
.na
.nf
.ad
.fi
پارامترهای زیر در
.B main.cf
به‌ویژه مرتبط هستند. متن زیر تنها خلاصه‌ای از پارامترها را ارائه می‌دهد. برای جزئیات بیشتر شامل مثال‌ها،
.BR postconf (5)
را ببینید.
.IP "\fBrelocated_maps (خالی)\fR"
جدول‌های جستجوی اختیاری حاوی اطلاعات تماس جدید برای کاربران یا دامنه‌هایی که دیگر وجود ندارند.
.PP
موجود در Postfix نسخه 3.11 و بالاتر:
.IP "\fBrelocated_prefix_enable (yes)\fR"
افزودن پیشوند «\fB5.1.6 User has moved to \fR» به ابتدای تمامی نتایج جستجوی relocated_maps.
.PP
سایر پارامترهای مهم:
.IP "\fBinet_interfaces (all)\fR"
نشانی‌های رابط شبکه محلی که این سامانه ایمیل روی آن‌ها پیام دریافت می‌کند.
.IP "\fBmydestination ($myhostname, localhost.$mydomain, localhost)\fR"
فهرست دامنه‌هایی که از طریق ترابری تحویل ایمیل local_transport$ تحویل داده می‌شوند.
.IP "\fBmyorigin ($myhostname)\fR"
نام دامنه‌ای که ایمیل‌های ارسال‌شده محلی به‌نظر می‌رسد از آن می‌آیند، و ایمیل‌های ارسال‌شده محلی به آن تحویل داده می‌شوند.
.IP "\fBproxy_interfaces (خالی)\fR"
نشانی‌های رابط شبکه دوردست که این سامانه ایمیل از طریق یک پراکسی یا واحد ترجمه نشانی شبکه (NAT) روی آن‌ها پیام دریافت می‌کند.
.SH "همچنین ببینید (SEE ALSO)"
.na
.nf
trivial\-rewrite(8), ارجاع‌دهنده نشانی
postmap(1), مدیر جدول جستجوی Postfix
postconf(5), پارامترهای پیکربندی
.SH "فایل‌های README (README FILES)"
.na
.nf
.ad
.fi
از دستور
«\fBpostconf readme_directory\fR»
یا
«\fBpostconf html_directory\fR»
برای مکان‌یابی این اطلاعات استفاده کنید.
.na
.nf
DATABASE_README, نمای کلی جدول جستجوی Postfix
ADDRESS_REWRITING_README, راهنمای بازنویسی نشانی
.SH "مجوز (LICENSE)"
.na
.nf
.ad
.fi
مجوز Secure Mailer باید همراه با این نرم‌افزار توزیع شود.
.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