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

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

\fBpostmap \-q \- /etc/postfix/generic <\fIinputfile\fR
.SH "توضیحات (DESCRIPTION)"
.ad
.fi
جدول اختیاری \fBgeneric\fR(5) نگاشت آدرسی را مشخص می‌کند که هنگام تحویل نامه اعمال می‌شود. این برعکس نگاشت \fBcanonical\fR(5) است که هنگام دریافت نامه اعمال می‌گردد.

به‌طور معمول، جدول \fBgeneric\fR(5) در سیستمی استفاده می‌شود که نام دامنهٔ معتبر اینترنتی ندارد و در عوض از چیزی مانند \fIlocaldomain.local\fR استفاده می‌کند. سپس جدول \fBgeneric\fR(5) توسط کلاینت \fBsmtp\fR(8) برای تبدیل آدرس‌های ایمیل محلی به آدرس‌های ایمیل اینترنتی معتبر در زمان ارسال نامه از طریق اینترنت استفاده می‌شود. بخش «مثال‌ها» را در انتهای این سند مشاهده کنید.

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

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

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

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

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

به عنوان جایگزین، جدول می‌تواند به عنوان یک نگاشت عبارت منظم (regular-expression) ارائه شود که در آن الگوها به عنوان عبارات منظم داده می‌شوند، یا جستجوها می‌توانند به یک سرور مبتنی بر TCP هدایت شوند. در این موارد، جستجوها به روشی کمی متفاوت انجام می‌شوند که در ادامه تحت عنوان «جداول عبارت منظم» یا «جداول مبتنی بر TCP» توضیح داده شده است.
.SH "یکسان‌سازی بزرگی و کوچکی حروف (CASE FOLDING)"
.na
.nf
.ad
.fi
رشتهٔ جستجو قبل از جستجو در پایگاه‌داده به حروف کوچک تبدیل می‌شود. از نسخهٔ Postfix 2.3 به بعد، رشتهٔ جستجو برای انواع پایگاه‌داده مانند regexp: یا pcre: که فیلدهای جستجوی آن‌ها می‌توانند با هر دو حالت حروف بزرگ و کوچک مطابقت داشته باشند، به حروف کوچک تبدیل نمی‌شود.
.SH "قالب جدول (TABLE FORMAT)"
.na
.nf
.ad
.fi
قالب ورودی برای دستور \fBpostmap\fR(1) به شرح زیر است:
.IP "\fIpattern result\fR"
هنگامی که \fIpattern\fR با یک آدرس ایمیل مطابقت داشته باشد، آن را با \fIresult\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. این حالت بالاترین اولویت را دارد.
.IP "\fIuser address\fR"
جایگزینی \fIuser\fR@\fIsite\fR با \fIaddress\fR زمانی که \fIsite\fR برابر با $\fBmyorigin\fR باشد، زمانی که \fIsite\fR در $\fBmydestination\fR فهرست شده باشد، یا زمانی که در $\fBinet_interfaces\fR یا $\fBproxy_interfaces\fR فهرست شده باشد.
.IP "@\fIdomain address\fR"
جایگزینی سایر آدرس‌ها در \fIdomain\fR با \fIaddress\fR. این حالت کمترین اولویت را دارد.
.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) مراجعه کنید. این قابلیت در Postfix 2.5 و بالاتر موجود است.

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

نتایج همانند جستجوهای فایل‌های نمایه‌سازی‌شده است.
.SH "مثال‌ها (EXAMPLES)"
.na
.nf
.ad
.fi
در ادامه یک نگاشت generic با یک فایل نمایه‌سازی‌شده نمایش داده شده است. هنگامی که نامه از طریق SMTP به یک میزبان راه‌دور ارسال می‌شود، این پیکربندی \fIhis@localdomain.local\fR را با آدرس ایمیل ISP او جایگزین می‌کند، \fIher@localdomain.local\fR را با آدرس ایمیل ISP او جایگزین می‌کند، و سایر آدرس‌های محلی را با حساب ISP او، با پسوند آدرس \fI+local\fR جایگزین می‌نماید (این مثال فرض می‌کند که ISP از پسوندهای آدرس با فرمت "+" پشتیبانی می‌کند).

.na
.nf
/etc/postfix/main.cf:
    smtp_generic_maps = hash:/etc/postfix/generic

/etc/postfix/generic:
    his@localdomain.local   hisaccount@hisisp.example
    her@localdomain.local   heraccount@herisp.example
    @localdomain.local      hisaccount+local@hisisp.example

.ad
.fi
هر زمان که جدول تغییر کرد، دستور «\fBpostmap /etc/postfix/generic\fR» را اجرا کنید. به جای \fBhash\fR، برخی سیستم‌ها از فایل‌های پایگاه‌دادهٔ \fBdbm\fR استفاده می‌کنند. برای اطلاع از اینکه سیستم شما از چه جداولی پشتیبانی می‌کند، از دستور «\fBpostconf \-m\fR» استفاده کنید.
.SH "گزارش باگ‌ها (BUGS)"
.ad
.fi
قالب جدول قراردادهای نقل‌قول (quoting) را درک نمی‌کند.
.SH "پارامترهای پیکربندی (CONFIGURATION PARAMETERS)"
.na
.nf
.ad
.fi
پارامترهای زیر در \fBmain.cf\fR به‌ویژه مرتبط هستند. متن زیر تنها یک خلاصه از پارامترها را ارائه می‌دهد. برای جزئیات بیشتر شامل مثال‌ها به \fBpostconf\fR(5) مراجعه کنید.
.IP "\fBsmtp_generic_maps (empty)\fR"
جداول جستجوی اختیاری که بازنویسی آدرس را در کلاینت Postfix SMTP انجام می‌دهند، معمولاً برای تبدیل یک آدرس معتبر محلی به یک آدرس معتبر جهانی هنگام ارسال نامه از طریق اینترنت.
.IP "\fBpropagate_unmatched_extensions (canonical, virtual)\fR"
مشخص می‌کند کدام جداول جستجوی آدرس، پسوند آدرس را از کلید جستجو به نتیجهٔ جستجو کپی می‌کنند.
.PP
سایر پارامترهای مهم:
.IP "\fBinet_interfaces (all)\fR"
آدرس‌های رابط شبکهٔ محلی که این سیستم پستی روی آن‌ها نامه دریافت می‌کند.
.IP "\fBproxy_interfaces (empty)\fR"
آدرس‌های رابط شبکهٔ راه‌دور که این سیستم پستی از طریق یک پروکسی یا واحد ترجمهٔ آدرس شبکه (NAT) روی آن‌ها نامه دریافت می‌کند.
.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)، و عدم تفکیک بخش‌های محلی آدرس owner\-\fIlistname\fR و \fIlistname\fR\-request هنگامی که recipient_delimiter روی "-" تنظیم شده باشد.
.SH "همچنین ببینید (SEE ALSO)"
.na
.nf
postmap(1)، مدیر جدول جستجوی Postfix
postconf(5)، پارامترهای پیکربندی
smtp(8)، کلاینت Postfix SMTP
.SH "فایل‌های راهنما (README FILES)"
.na
.nf
.ad
.fi
برای یافتن این اطلاعات از «\fBpostconf readme_directory\fR» یا «\fBpostconf html_directory\fR» استفاده کنید.
.na
.nf
ADDRESS_REWRITING_README، راهنمای بازنویسی آدرس
DATABASE_README، نمای کلی جدول جستجوی Postfix
STANDARD_CONFIGURATION_README، مثال‌های پیکربندی
.SH "مجوز (LICENSE)"
.na
.nf
.ad
.fi
مجوز Secure Mailer باید به همراه این نرم‌افزار توزیع شود.
.SH "تاریخچه (HISTORY)"
.ad
.fi
قابلیت genericstable در MTA مربوط به Sendmail وجود دارد.

این قابلیت در Postfix نسخهٔ 2.2 و بالاتر در دسترس است.
.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