.TH CANONICAL 5
.ad
.fi
.SH "نام (NAME)"
canonical \- قالب جدول متعارف Postfix
.SH "خلاصه دستور (SYNOPSIS)"
.na
.nf
\fBpostmap /etc/postfix/canonical\fR

\fBpostmap \-q "\fIstring\fB" /etc/postfix/canonical\fR

\fBpostmap \-q \- /etc/postfix/canonical <\fIinputfile\fR
.SH "توضیحات (DESCRIPTION)"
.ad
.fi
جدول اختیاری \fBcanonical\fR(5) یک نگاشت نشانی را برای
نشانی‌های محلی و غیرمحلی مشخص می‌کند. این نگاشت پیش از ذخیره شدن
ایمیل در صف، توسط دیمن \fBcleanup\fR(8) استفاده می‌شود.
نگاشت نشانی به صورت بازگشتی است.

به طور معمول، جدول \fBcanonical\fR(5) به عنوان یک فایل متنی مشخص می‌شود
که به عنوان ورودی برای دستور \fBpostmap\fR(1) عمل می‌کند تا یک فایل
ایندکس‌شده برای جستجوی سریع ایجاد شود.

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

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

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

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

به طور پیش‌فرض، نگاشت \fBcanonical\fR(5) هم بر نشانی‌های سرآیند پیام
(یعنی نشانی‌هایی که درون پیام‌ها ظاهر می‌شوند) و هم بر نشانی‌های پاکت نامه
پیام (برای مثال، نشانی‌هایی که در دستورات پروتکل SMTP استفاده می‌شوند)
تأثیر می‌گذارد. این رفتار با پارامتر \fBcanonical_classes\fR کنترل می‌شود.

نکته: در Postfix نسخه‌های 2.2 و بالاتر، سرآیندهای پیام دریافت شده از کلاینت‌های
راه دور SMTP تنها در صورتی بازنویسی می‌شوند که کلاینت با پارامتر
local_header_rewrite_clients مطابقت داشته باشد، یا پارامتر پیکربندی
remote_header_rewrite_domain مقداری غیرخالی تعیین کرده باشد. برای دستیابی
به رفتار قبل از Postfix 2.2، عبارت «local_header_rewrite_clients = static:all»
را مشخص کنید.

به طور معمول، از جدول \fBcanonical\fR(5) برای جایگزینی نام‌های ورود با
\fIFirstname.Lastname\fR، یا برای پاکسازی نشانی‌های تولیدشده توسط
سیستم‌های ایمیل قدیمی استفاده می‌شود.

نگاشت \fBcanonical\fR(5) نباید با پشتیبانی از \fIنام مستعار مجازی\fR یا با
نام‌های مستعار محلی اشتباه گرفته شود. برای تغییر مقصد بدون تغییر سرآیندها،
به جای آن از نگاشت \fBvirtual\fR(5) یا \fBaliases\fR(5) استفاده کنید.
.SH "تبدیل بزرگی/کوچکی حروف (CASE FOLDING)"
.na
.nf
.ad
.fi
رشته جستجو پیش از جستجو در پایگاه داده، به حروف کوچک تبدیل می‌شود.
از Postfix 2.3 به بعد، رشته جستجو در انواع پایگاه داده مانند regexp:
یا pcre: که فیلدهای جستجوی آن‌ها می‌توانند هم با حروف بزرگ و هم با حروف
کوچک تطابق یابند، تبدیل به حروف کوچک نمی‌شود.
.SH "قالب جدول (TABLE FORMAT)"
.na
.nf
.ad
.fi
قالب ورودی برای دستور \fBpostmap\fR(1) به شرح زیر است:
.IP "\fIpattern address\fR"
هنگامی که \fIpattern\fR با یک نشانی ایمیل مطابقت داشته باشد، آن را با
\fIaddress\fR متناظر جایگزین می‌کند.
.IP "خطوط خالی و توضیحات"
خطوط خالی و خطوطی که فقط حاوی فاصله‌اند نادیده گرفته می‌شوند،
همچنین خطوطی که اولین نویسه غیرفاصله‌ای آن‌ها یک «#» باشد.
.IP "متن چندخطی"
یک خط منطقی با متنی غیر از فاصله خالی آغاز می‌شود. خطی که با
فاصله خالی شروع شود، ادامه خط منطقی قبلی خواهد بود.
.SH "ترتیب جستجوی جدول (TABLE SEARCH ORDER)"
.na
.nf
.ad
.fi
در جستجوها از فایل‌های ایندکس‌شده مانند DB یا DBM، یا از جدول‌های تحت
شبکه مانند NIS، LDAP یا SQL، هر پرس‌وجوی \fIuser\fR@\fIdomain\fR
دنباله‌ای از الگوهای پرس‌وجو را به شرح زیر ایجاد می‌کند.

پیش از امتحان کردن الگوی پرس‌وجوی بعدی، هر الگوی پرس‌وجو به هر جدول
جستجوی مشخص‌شده ارسال می‌شود تا زمانی که یک تطابق پیدا شود.
.IP "\fIuser\fR@\fIdomain address\fR"
\fIuser\fR@\fIdomain\fR را با \fIaddress\fR جایگزین می‌کند.
این فرم بالاترین اولویت را دارد.
.sp
این فرم برای پاکسازی نشانی‌های تولیدشده توسط سیستم‌های ایمیل قدیمی مفید است.
همچنین می‌تواند برای ایجاد نشانی‌هایی به سبک \fIFirstname.Lastname\fR استفاده شود،
اما برای راه‌حل ساده‌تر به بخش‌های بعدی مراجعه کنید.
.IP "\fIuser address\fR"
هنگامی که \fIsite\fR برابر با $\fBmyorigin\fR باشد، یا در $\fBmydestination\fR
فهرست شده باشد، یا در $\fBinet_interfaces\fR یا $\fBproxy_interfaces\fR
فهرست شده باشد، \fIuser\fR@\fIsite\fR را با \fIaddress\fR جایگزین می‌کند.
.sp
این فرم برای جایگزینی نام‌های ورود با \fIFirstname.Lastname\fR مفید است.
.IP "@\fIdomain address\fR"
سایر نشانی‌ها در \fIdomain\fR را با \fIaddress\fR جایگزین می‌کند.
این فرم کمترین اولویت را دارد.
.sp
نکته: @\fIdomain\fR یک نویسه عمومی (wild-card) است. هنگامی که این فرم
برای نشانی‌های گیرنده اعمال می‌شود، کارساز SMTP نرم‌افزار Postfix ایمیل‌ها
را برای هر گیرنده‌ای در \fIdomain\fR، صرف‌نظر از اینکه آن گیرنده واقعاً وجود
داشته باشد یا خیر، می‌پذیرد. این موضوع ممکن است سیستم ایمیل شما را به یک
منبع بازپخش ناخواسته (backscatter) تبدیل کند: Postfix ابتدا ایمیل را برای گیرندگان
ناموجود می‌پذیرد و سپس سعی می‌کند آن ایمیل را به عنوان «غیرقابل تحویل» به نشانی
فرستنده که اغلب جعلی است بازگرداند.
.sp
برای جلوگیری از بروز پدیده backscatter با ایمیل‌های دامنه دارای نویسه عمومی،
نگاشت wild-card را با نگاشت‌های صریح 1:1 جایگزین کنید، یا محدودیت
reject_unverified_recipient را برای آن دامنه اضافه نمایید:

.nf
    smtpd_recipient_restrictions =
        ...
        reject_unauth_destination
        check_recipient_access
            inline:{example.com=reject_unverified_recipient}
    unverified_recipient_reject_code = 550
.fi

در مثال بالا، در صورتی که گیرنده به یک نشانی راه دور بازنویسی شود،
ممکن است Postfix با یک کارساز راه دور تماس برقرار کند.
.SH "بازنویسی نشانی نتیجه (RESULT ADDRESS REWRITING)"
.na
.nf
.ad
.fi
نتیجه جستجو مشمول بازنویسی نشانی می‌شود:
.IP \(bu
هنگامی که نتیجه به فرم @\fIotherdomain\fR باشد، نتیجه تبدیل به
همان \fIuser\fR در \fIotherdomain\fR می‌شود.
.IP \(bu
هنگامی که «\fBappend_at_myorigin=yes\fR» باشد، مقدار «\fB@$myorigin\fR»
به نشانی‌های بدون «@domain» پیوست می‌شود.
.IP \(bu
هنگامی که «\fBappend_dot_mydomain=yes\fR» باشد، مقدار
«\fB.$mydomain\fR» به نشانی‌های بدون «.domain» پیوست می‌شود.
.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.

پارامتر \fBpropagate_unmatched_extensions\fR کنترل می‌کند که آیا یک پسوند
نشانی تطبیق‌نیافته (\fI+foo\fR) به نتیجه جستجوی جدول منتقل شود یا خیر.
.SH "جدول‌های عبارات باقاعده (REGULAR EXPRESSION TABLES)"
.na
.nf
.ad
.fi
این بخش نحوه تغییر جستجوهای جدول را هنگامی که جدول در قالب عبارات باقاعده
ارائه شده باشد شرح می‌دهد. برای مشاهده شرح نحو جدول جستجوی عبارت باقاعده،
به \fBregexp_table\fR(5) یا \fBpcre_table\fR(5) مراجعه کنید.

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

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

نتایج مشابه جستجوها در فایل‌های ایندکس‌شده است، با این ویژگی افزوده که زیررشته‌های
درون پرانتز در الگو می‌توانند به صورت \fB$1\fR، \fB$2\fR و غیره درون‌ریزی شوند.
.SH "جدول‌های مبتنی بر TCP (TCP-BASED TABLES)"
.na
.nf
.ad
.fi
این بخش نحوه تغییر جستجوهای جدول را هنگامی که جستجوها به یک کارساز مبتنی
بر TCP هدایت می‌شوند شرح می‌دهد. برای مشاهده شرح پروتکل جستجوی
کلاینت/کارساز TCP، به \fBtcp_table\fR(5) مراجعه کنید.
این ویژگی تا نسخه 2.4 نرم‌افزار Postfix (شامل آن نسخه نیز) در دسترس نیست.

هر عملیات جستجو کل نشانی را در یک نوبت استفاده می‌کند. بنابراین،
نشانی‌های ایمیل \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
پارامترهای زیر در \fBmain.cf\fR به‌ویژه مرتبط هستند.
متن زیر تنها خلاصه‌ای از پارامترها را ارائه می‌دهد. برای جزئیات بیشتر شامل
مثال‌ها، به \fBpostconf\fR(5) مراجعه کنید.
.IP "\fBcanonical_classes (envelope_sender, envelope_recipient, header_sender, header_recipient)\fR"
مشخص می‌کند چه نشانی‌هایی مشمول نگاشت نشانی canonical_maps هستند.
.IP "\fBcanonical_maps (empty)\fR"
جدول‌های جستجوی اختیاری نگاشت نشانی برای سرآیندها و پاکت‌های پیام.
.IP "\fBrecipient_canonical_maps (empty)\fR"
جدول‌های جستجوی اختیاری نگاشت نشانی برای نشانی‌های گیرنده در پاکت نامه و سرآیند.
.IP "\fBsender_canonical_maps (empty)\fR"
جدول‌های جستجوی اختیاری نگاشت نشانی برای نشانی‌های فرستنده در پاکت نامه و سرآیند.
.IP "\fBpropagate_unmatched_extensions (canonical, virtual)\fR"
مشخص می‌کند کدام جدول‌های جستجوی نشانی، پسوند نشانی را از کلید جستجو به نتیجه
جستجو کپی می‌کنند.
.PP
سایر پارامترهای مرتبط:
.IP "\fBinet_interfaces (all)\fR"
نشانی‌های رابط شبکه محلی که این سیستم ایمیل روی آن‌ها ایمیل دریافت می‌کند.
.IP "\fBlocal_header_rewrite_clients (permit_inet_interfaces)\fR"
سرآیندهای پیام را در ایمیل‌های این کلاینت‌ها بازنویسی کرده یا اضافه می‌کند،
نشانی‌های ناقص را با نام دامنه در $myorigin یا $mydomain به‌روزرسانی کرده،
و سرآیندهای گمشده را می‌افزاید.
.IP "\fBproxy_interfaces (empty)\fR"
نشانی‌های رابط شبکه راه دور که این سیستم ایمیل از طریق یک پراکسی یا واحد
ترجمه نشانی شبکه (NAT) روی آن‌ها ایمیل دریافت می‌کند.
.IP "\fBmasquerade_classes (envelope_sender, header_sender, header_recipient)\fR"
مشخص می‌کند چه نشانی‌هایی مشمول نقاب‌گذاری نشانی (address masquerading) هستند.
.IP "\fBmasquerade_domains (empty)\fR"
فهرست اختیاری از دامنه‌هایی که ساختار زیردامنه‌ای آن‌ها در نشانی‌های ایمیل
حذف خواهد شد.
.IP "\fBmasquerade_exceptions (empty)\fR"
فهرست اختیاری از نام‌های کاربری که حتی اگر نشانی آن‌ها با $masquerade_domains
مطابقت داشته باشد، مشمول نقاب‌گذاری نشانی نمی‌شوند.
.IP "\fBmydestination ($myhostname, localhost.$mydomain, localhost)\fR"
فهرست دامنه‌هایی که از طریق ترابری تحویل ایمیل $local_transport تحویل
داده می‌شوند.
.IP "\fBmyorigin ($myhostname)\fR"
نام دامنه‌ای که به نظر می‌رسد ایمیل‌های ارسال‌شده به صورت محلی از آن آمده‌اند،
و ایمیل‌های ارسال‌شده محلی به آن تحویل داده می‌شوند.
.IP "\fBowner_request_special (yes)\fR"
رفتار ویژه برای مدخل‌های owner\-\fIlistname\fR در فایل \fBaliases\fR(5) را
فعال می‌کند، و زمانی که recipient_delimiter روی «\-» تنظیم شده باشد،
بخش‌های محلی نشانی‌های owner\-\fIlistname\fR و \fIlistname\fR\-request را تفکیک نمی‌کند.
.IP "\fBremote_header_rewrite_domain (empty)\fR"
اگر مقدار پارامتر remote_header_rewrite_domain غیرخالی باشد، سرآیندهای پیام
را در ایمیل‌های کلاینت‌های راه دور بازنویسی کرده یا اضافه می‌کند، نشانی‌های ناقص را با
دامنه مشخص‌شده در پارامتر remote_header_rewrite_domain به‌روزرسانی کرده،
و سرآیندهای گمشده را می‌افزاید.
.SH "همچنین ببینید (SEE ALSO)"
.na
.nf
cleanup(8), استانداردسازی و قراردادن ایمیل در صف
postmap(1), مدیریت جدول‌های جستجوی Postfix
postconf(5), پارامترهای پیکربندی
virtual(5), نام‌های مستعار مجازی
.SH "فایل‌های راهنما (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