.TH PCRE_TABLE 5 
.ad
.fi
.SH "نام (NAME)"
pcre_table \- قالب جدول‌های PCRE در Postfix
.SH "خلاصه دستور (SYNOPSIS)"
.na
.nf
\fBpostmap \-q "\fIstring\fB" pcre:/etc/postfix/\fIfilename\fR

\fBpostmap \-q \- pcre:/etc/postfix/\fIfilename\fB <\fIinputfile\fR

\fBpostmap \-hmq \- pcre:/etc/postfix/\fIfilename\fB <\fIinputfile\fR

\fBpostmap \-bmq \- pcre:/etc/postfix/\fIfilename\fB <\fIinputfile\fR
.SH "توضیحات (DESCRIPTION)"
.ad
.fi
سیستم ایمیل Postfix از جدول‌های اختیاری برای بازنویسی آدرس (address rewriting) یا مسیریابی ایمیل (mail routing) استفاده می‌کند. این جدول‌ها معمولاً در قالب‌های \fBlmdb:\fR، \fBcdb:\fR، \fBhash:\fR یا \fBdbm:\fR هستند.

به عنوان جایگزین، جدول‌های جستجو را می‌توان در قالب عبارت‌های باقاعده سازگار با پرل (Perl Compatible Regular Expression یا PCRE) مشخص کرد. در این حالت، هر ورودی با فهرستی از الگوها مقایسه می‌شود. هنگامی که یک تطابق یافت شد، نتیجه مربوطه بازگردانده شده و جستجو پایان می‌یابد.

برای آگاهی از اینکه سیستم Postfix شما از چه نوع جدول‌های جستجویی پشتیبانی می‌کند، از دستور «\fBpostconf \-m\fR» استفاده کنید.

برای آزمایش جدول‌های جستجو، از دستور «\fBpostmap \-q\fR» همان‌طور که در بخش خلاصه دستور در بالا شرح داده شد، استفاده کنید. از «\fBpostmap \-hmq \-\fR <\fIfile\fR» برای الگوهای header_checks(5) و از «\fBpostmap \-bmq \-\fR <\fIfile\fR» برای body_checks(5) (در Postfix نسخه ۲.۶ و بالاتر) استفاده کنید.

این درایور را می‌توان با کتابخانه pcre2 (در Postfix نسخه ۳.۷ و بالاتر) یا با کتابخانه قدیمی pcre (تمام نسخه‌های Postfix) ساخت.
.SH "سازگاری (COMPATIBILITY)"
.na
.nf
.ad
.fi
در Postfix نسخه ۲.۲ و قدیمی‌تر، برای پرس‌وجو از جدولی که شامل الگوهای حساس به حروف کوچک و بزرگ است، «\fBpostmap \-fq\fR» را مشخص کنید. الگوها به‌طور پیش‌فرض به بزرگی و کوچکی حروف حساس نیستند.
.SH "قالب جدول (TABLE FORMAT)"
.na
.nf
.ad
.fi
قالب کلی یک جدول PCRE به صورت زیر است:
.IP "\fB/\fIpattern\fB/\fIflags result\fR"
هنگامی که \fIpattern\fR با رشته ورودی مطابقت داشته باشد، از مقدار \fIresult\fR مربوطه استفاده می‌شود.
.IP "\fB!/\fIpattern\fB/\fIflags result\fR"
هنگامی که \fIpattern\fR با رشته ورودی مطابقت \fBنداشته باشد\fR، از مقدار \fIresult\fR مربوطه استفاده می‌شود.
.IP "\fBif /\fIpattern\fB/\fIflags\fR"
.IP "\fBendif\fR"
اگر رشته ورودی با /\fIpattern\fR/ مطابقت داشته باشد، آن رشته ورودی با الگوهای بین \fBif\fR و \fBendif\fR مقایسه می‌شود. بلوک‌های \fBif\fR..\fBendif\fR می‌توانند تو در تو باشند.
.sp
نکته: در ابتدای الگوهای داخل \fBif\fR..\fBendif\fR از نویسه‌های فاصله (whitespace) استفاده نکنید.
.sp
این ویژگی در Postfix نسخه ۲.۱ و بالاتر در دسترس است.
.IP "\fBif !/\fIpattern\fB/\fIflags\fR"
.IP "\fBendif\fR"
اگر رشته ورودی با /\fIpattern\fR/ مطابقت نداشته باشد، آن رشته ورودی با الگوهای بین \fBif\fR و \fBendif\fR مقایسه می‌شود. بلوک‌های \fBif\fR..\fBendif\fR می‌توانند تو در تو باشند.
.sp
نکته: در ابتدای الگوهای داخل \fBif\fR..\fBendif\fR از نویسه‌های فاصله (whitespace) استفاده نکنید.
.sp
این ویژگی در Postfix نسخه ۲.۱ و بالاتر در دسترس است.
.IP "خطوط خالی و کامنت‌ها"
خطوط خالی و خطوطی که فقط حاوی نویسه‌های فاصله هستند نادیده گرفته می‌شوند، همان‌طور که خطوطی که اولین نویسه غیرفاصله‌ای آن‌ها «#» است نادیده گرفته می‌شوند.
.IP "متن چندخطی"
یک خط منطقی با متنی غیر از نویسه‌های فاصله آغاز می‌شود. خطی که با نویسه فاصله آغاز شود ادامه‌دهنده خط منطقی است.
.PP
هر الگو یک عبارت باقاعده شبیه به perl است. جداکننده عبارت (delimiter) می‌تواند هر نویسه غیرحرفی-عددی به جز نویسه‌های فاصله یا نویسه‌های دارای معنای خاص باشد (به‌طور سنتی از اسلش «/» استفاده می‌شود). عبارت باقاعده می‌تواند شامل نویسه‌های فاصله باشد.

به‌طور پیش‌فرض، تطابق بدون حساسیت به بزرگی و کوچکی حروف است و خطوط جدید به عنوان نویسه‌های خاص در نظر گرفته نمی‌شوند. این رفتار توسط پرچم‌ها (flags) کنترل می‌شود که با افزودن یک یا چند مورد از نویسه‌های زیر به انتهای الگو فعال یا غیرفعال می‌شوند:
.IP "\fBi\fR (پیش‌فرض: روشن)"
تغییر وضعیت پرچم حساسیت به بزرگی و کوچکی حروف. به‌طور پیش‌فرض، تطابق به بزرگی و کوچکی حروف حساس نیست.
.IP "\fBm\fR (پیش‌فرض: خاموش)"
تغییر وضعیت پرچم MULTILINE در pcre. هنگامی که این پرچم روشن است، فرانَویسه‌های (metacharacters) \fB^\fR و \fB$\fR علاوه بر تطابق در ابتدا و انتهای رشته مورد نظر، به ترتیب بلافاصله پس از و بلافاصله قبل از یک نویسه خط جدید (newline) نیز تطابق می‌یابند.
.IP "\fBs\fR (پیش‌فرض: روشن)"
تغییر وضعیت پرچم DOTALL در pcre. هنگامی که این پرچم روشن است، فرانَویسه \fB.\fR با نویسه خط جدید نیز تطابق می‌یابد. در نسخه‌های قبل از ۲.۰ نرم‌افزار Postfix، این پرچم به‌طور پیش‌فرض خاموش بود که برای تطابق سرآیندهای پیام‌های چندخطی نامناسب بود.
.IP "\fBx\fR (پیش‌فرض: خاموش)"
تغییر وضعیت پرچم extended در pcre. هنگامی که این پرچم روشن است، نویسه‌های فاصله در الگو (به جز درون یک کلاس نویسه) نادیده گرفته می‌شوند. برای گنجاندن یک نویسه فاصله به عنوان بخشی از الگو، آن را با بک‌اسلش گریز دهید (escape کنید).
.sp
نکته: بعد از الگوها از \fB#\fIcomment\fR استفاده نکنید.
.IP "\fBA\fR (پیش‌فرض: خاموش)"
تغییر وضعیت پرچم ANCHORED در pcre. هنگامی که این پرچم روشن است، الگو مجبور می‌شود «مهار» شود، یعنی فقط در ابتدای رشته‌ای که مورد جستجو قرار می‌گیرد («رشته هدف») تطابق یابد. این اثر را می‌توان با ساختارهای مناسب در خود الگو نیز به دست آورد.
.IP "\fBE\fR (پیش‌فرض: خاموش)"
تغییر وضعیت پرچم DOLLAR_ENDONLY در pcre. هنگامی که این پرچم روشن است، فرانَویسه \fB$\fR در الگو فقط در انتهای رشته هدف تطابق می‌یابد. بدون این پرچم، اگر نویسه پایانی یک نویسه خط جدید باشد، علامت دلار بلافاصله قبل از آن نیز تطابق می‌یابد (اما قبل از سایر نویسه‌های خط جدید تطابق نمی‌یابد). اگر پرچم MULTILINE تنظیم شده باشد، این پرچم نادیده گرفته می‌شود.
.IP "\fBU\fR (پیش‌فرض: خاموش)"
تغییر وضعیت پرچم UNGREEDY در pcre. هنگامی که این پرچم روشن است، موتور تطابق الگو «طمع‌ورزی» (greediness) کمیت‌سنج‌ها را معکوس می‌کند، به طوری که به‌طور پیش‌فرض حریصانه نباشند، اما اگر بعد از آن‌ها «?» بیاید حریصانه شوند. این پرچم را می‌توان با تغییردهنده (?U) در داخل الگو نیز تنظیم کرد.
.IP "\fBX\fR (پیش‌فرض: خاموش)"
تغییر وضعیت پرچم EXTRA در pcre.
هنگامی که این پرچم روشن است، هر بک‌اسلش در الگو که پس از آن حرفی بدون معنای خاص قرار گیرد باعث ایجاد خطا می‌شود؛ بدین ترتیب این ترکیب‌ها برای استفاده‌های آینده رزرو می‌شوند.

این ویژگی در PCRE2 پشتیبانی نمی‌شود.
.SH "ترتیب جستجو (SEARCH ORDER)"
.na
.nf
.ad
.fi
الگوها به ترتیبی که در جدول مشخص شده‌اند اعمال می‌شوند، تا زمانی که الگویی پیدا شود که با رشته ورودی مطابقت داشته باشد.

هر الگو روی کل رشته ورودی اعمال می‌شود. بسته به کاربرد، آن رشته ممکن است کل نام میزبان سرویس‌گیرنده، کل آدرس IP سرویس‌گیرنده یا کل یک آدرس ایمیل باشد. بنابراین، هیچ جستجویی در دامنه والد یا شبکه والد انجام نمی‌شود و آدرس‌های ایمیل \fIuser@domain\fR به بخش‌های تشکیل‌دهنده \fIuser\fR و \fIdomain\fR تفکیک نمی‌شوند، و همچنین \fIuser+foo\fR به \fIuser\fR و \fIfoo\fR تجزیه نمی‌شود.
.SH "جایگزینی متن (TEXT SUBSTITUTION)"
.na
.nf
.ad
.fi
جایگزینی زیررشته‌ها (متنی که با الگوهای داخل «()» تطابق دارد) از عبارت تطابق‌یافته در رشته نتیجه با $1، $2 و غیره درخواست می‌شود؛ برای تولید نویسه $ در خروجی، $$ را مشخص کنید.
اگر پس از ماکروها در رشته نتیجه، نویسه فاصله نیاید، ممکن است لازم باشد به صورت ${n} یا $(n) نوشته شوند.
این ویژگی از نام‌های زیررشته در pcre2 پشتیبانی نمی‌کند.

نکته: از آنجا که الگوهای نفی‌شده (آن‌هایی که با \fB!\fR شروع می‌شوند) زمانی نتیجه را برمی‌گردانند که عبارت تطابق نداشته باشد، امکان جایگزینی برای الگوهای نفی‌شده وجود ندارد.
.SH "تعریف درون‌خطی (INLINE SPECIFICATION)"
.na
.nf
.ad
.fi
محتویات یک جدول را می‌توان در نام جدول مشخص کرد (در Postfix نسخه ۳.۷ و بالاتر).
نحو پایه عبارت است از:

.nf
main.cf:
    \fIparameter\fR \fB= .. pcre:{ { \fIrule\-1\fB }, { \fIrule\-2\fB } .. } ..\fR

master.cf:
    \fB.. \-o { \fIparameter\fR \fB= .. pcre:{ { \fIrule\-1\fB }, { \fIrule\-2\fB } .. } .. } ..\fR
.fi

نرم‌افزار Postfix به‌طور بازگشتی تمام نمونه‌های \fI$parametername\fR را در مقدار پارامتر بالا بسط می‌دهد، فاصله‌های بعد از «{» و قبل از «}» را نادیده می‌گیرد و هر \fIrule\fR را به صورت یک خط متنی در یک فایل درون‌حافظه‌ای می‌نویسد:

.nf
in\-memory file:
    rule\-1
    rule\-2
    ..
.fi

سپس Postfix نتیجه را به گونه‌ای پردازش می‌کند که گویی فایلی در مسیر /etc/postfix است.
.SH "هشدارهای تعریف درون‌خطی (INLINE SPECIFICATION CAVEATS)"
.na
.nf
.ad
.fi
.IP \(bu
هنگام استفاده از \fI$parametername\fR در داخل یک الگوی درون‌خطی، از \eQ\fI$parametername\fR\eE برای غیرفعال کردن فرانَویسه‌هایی مانند «.» در بسط \fI$parametername\fR استفاده کنید. در غیر این صورت، الگو ممکن است تطابق‌های غیرمنتظره‌ای داشته باشد.
.IP \(bu
هنگامی که یک قاعده درون‌خطی باید شامل \fB$\fR باشد، \fB$$\fR را مشخص کنید تا از تلاش Postfix برای بسط دادن \fI$name\fR در حین ارزیابی مقدار پارامتر جلوگیری شود. برای بررسی یک پیکربندی درون‌خطی، از گزینه «\fBpostconf \-x\fR» همان‌طور که در زیر نشان داده شده است استفاده کنید:
.RS
.IP \(bu
هنگامی که یک مقدار «\fIparametername = value\fR» در main.cf شامل یک جدول درون‌خطی :pcre است، از دستور «\fBpostconf \-x \fIparametername\fR» استفاده کنید. بررسی کنید که هیچ هشدار "undefined parameter" وجود نداشته باشد و خروجی دارای نحوی باشد که در یک فایل غیردرون‌خطی :pcre در Postfix استفاده می‌شود.
.IP \(bu
هنگامی که یک بازنویسی به صورت «\fB\-o { \fIparametername = value\fB }\fR» در master.cf شامل یک جدول درون‌خطی :pcre است، از دستور «\fBpostconf \-Px '*/*/\fIparametername\fB' \fR» استفاده کنید. بررسی کنید که هیچ هشدار "undefined parameter" وجود نداشته باشد و خروجی دارای نحوی باشد که در یک فایل غیردرون‌خطی :pcre در Postfix استفاده می‌شود.
.RE
.SH "مثال نگاشت دسترسی SMTPD (EXAMPLE SMTPD ACCESS MAP)"
.na
.nf
# محافظت از exploderهای خروجی majordomo شما
/^(?!owner\-)(.*)\-outgoing@(.*)/ 550 Use ${1}@${2} instead

# بازگرداندن friend@whatever، به جز زمانی که whatever دامنه خودمان باشد
/^(friend@(?!my\\.domain$).*)$/  550 Stick this in your pipe $1

# یک ورودی چندخطی. متن به صورت یک خط ارسال می‌شود.
#
/^noddy@my\\.domain$/
\ 550 This user is a funny one. You really don't want to send mail to
\ them as it only makes their head spin.
.SH "مثال نگاشت فیلتر سرآیند (EXAMPLE HEADER FILTER MAP)"
.na
.nf
/^Subject: make money fast/     REJECT
/^To: friend@public\\.com/       REJECT
.SH "مثال نگاشت فیلتر بدنه (EXAMPLE BODY FILTER MAP)"
.na
.nf
# ابتدا متن کدگذاری‌شده با base 64 را برای صرفه‌جویی در چرخه‌های پردازنده رد کنید.
# نیازمند PCRE نسخه ۳ است.
~^[[:alnum:]+/]{60,}$~          OK

# الگوهای بدنه خود را در اینجا قرار دهید.
.SH "همچنین ببینید (SEE ALSO)"
.na
.nf
postmap(1), مدیر جدول‌های جستجوی Postfix
postconf(5), پارامترهای پیکربندی
regexp_table(5), قالب جدول‌های عبارت باقاعده POSIX
.SH "فایل‌های راهنما (README FILES)"
.na
.nf
.ad
.fi
برای یافتن این اطلاعات از «\fBpostconf readme_directory\fR» یا «\fBpostconf html_directory\fR» استفاده کنید.
.na
.nf
DATABASE_README, بررسی اجمالی جدول‌های جستجوی Postfix
.SH "نویسندگان (AUTHORS)"
.na
.nf
کد جستجوی جدول PCRE در ابتدا توسط افراد زیر نوشته شد:
Andrew McNamara
andrewm@connect.com.au
connect.com.au Pty. Ltd.
Level 3, 213 Miller St
North Sydney, NSW, Australia

پذیرفته شده و تطبیق داده شده توسط:
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