.TH MEMCACHE_TABLE 5
.ad
.fi
.SH "نام (NAME)"
memcache_table \- پیکربندی کلاینت memcache در Postfix
.SH "خلاصه دستور (SYNOPSIS)"
.na
.nf
\fBpostmap \-q "\fIstring\fB" memcache:/etc/postfix/\fIfilename\fR

\fBpostmap \-q \- memcache:/etc/postfix/\fIfilename\fB <\fIinputfile\fR
.SH "توضیحات (DESCRIPTION)"
.ad
.fi
سیستم ایمیل Postfix از جدول‌های اختیاری برای بازنویسی آدرس یا
مسیریابی ایمیل استفاده می‌کند. این جدول‌ها معمولاً در قالب‌های
\fBlmdb:\fR، \fBcdb:\fR، \fBhash:\fR یا \fBdbm:\fR هستند.
.PP
به عنوان جایگزین، جدول‌های جستجو می‌توانند به صورت نمونه‌های memcache
مشخص شوند. برای استفاده از جستجوهای memcache، یک منبع memcache را
به عنوان جدول جستجو در main.cf تعریف کنید؛ برای مثال:
.nf
    virtual_alias_maps = memcache:/etc/postfix/memcache\-aliases.cf
.fi
.PP
فایل /etc/postfix/memcache\-aliases.cf ساختاری مشابه با فایل main.cf در
Postfix دارد و پارامترهای شرح داده‌شده در ادامه را مشخص می‌کند.
.PP
کلاینت memcache در Postfix از عملیات‌های جستجو (lookup)، به‌روزرسانی (update)،
حذف (delete) و توالی (sequence یا first/next) پشتیبانی می‌کند.
عملیات توالی نیازمند یک پایگاه‌داده پشتیبان است که از این عملیات پشتیبانی کند.
.SH "پارامترهای اصلی MEMCACHE (MEMCACHE MAIN PARAMETERS)"
.na
.nf
.ad
.fi
.IP "\fBmemcache (پیش‌فرض: inet:localhost:11211)\fR"
سرور memcache (توجه: به صورت مفرد) که Postfix تلاش می‌کند به آن متصل شود.
برای یک سرور TCP، مقدار "inet:" و به دنبال آن یک نام میزبان یا آدرس، ":"، و نام یا شماره پورت را مشخص کنید.
آدرس IPv6 را درون "[]" مشخص کنید.
برای یک سرور در دامنه یونیکس (UNIX\-domain) مقدار "unix:" و به دنبال آن مسیر سوکت را مشخص کنید. مثال‌ها:
.nf
    memcache = inet:memcache.example.com:11211
    memcache = inet:127.0.0.1:11211
    memcache = inet:[fc00:8d00:189::3]:11211
    memcache = unix:/path/to/socket
.fi
.PP
نکته: برای دسترسی به یک سوکت UNIX\-domain با سرور
.BR proxymap (8)،
سوکت باید توسط کاربر غیرممتاز postfix قابل دسترسی باشد.
.IP "\fBbackup (پیش‌فرض: تعریف‌نشده)\fR"
یک پایگاه‌داده اختیاری در Postfix که پشتیبان پایداری برای پایگاه‌داده memcache فراهم می‌کند.
کلاینت memcache در Postfix هر زمان که اطلاعاتی را در پایگاه‌داده پایدار جستجو کرده یا تغییر دهد،
پایگاه‌داده memcache را نیز به‌روزرسانی می‌کند. یک پایگاه‌داده Postfix از نوع "type:table" را مشخص کنید. مثال‌ها:
.nf
    # کش postscreen غیرمشترک.
    backup = btree:/var/lib/postfix/postscreen_cache_map

    # کش postscreen مشترک برای فرآیندهای روی همان میزبان.
    backup = proxy:btree:/var/lib/postfix/postscreen_cache_map
.fi
.PP
دسترسی به سرورهای راه دور proxymap در حال توسعه است.
.PP
نکته ۱: هنگام به اشتراک گذاشتن کش پایدار
.BR postscreen (8)
یا
.BR verify (8)،
پاکسازی خودکار کش را غیرفعال کنید (تنظیم
.B *_cache_cleanup_interval = 0
را اعمال کنید)، مگر با یک نمونه از Postfix که مسئول پاکسازی کش خواهد بود.
.PP
نکته ۲: هنگامی که چندین جدول از یک پایگاه‌داده memcache مشترک استفاده می‌کنند، هر جدول باید از قابلیت
.B key_format
(در ادامه ببینید) برای افزودن رشته یکتای خود به ابتدای کلید جستجو استفاده کند.
در غیر این صورت، پاکسازی خودکار کش
.BR postscreen (8)
یا
.BR verify (8)
ممکن است کار نکند.
.PP
نکته ۳: هنگامی که به پایگاه‌داده پشتیبان با جستجوهای "proxy:" دسترسی پیدا می‌شود،
نام کامل پایگاه‌داده پشتیبان (شامل پیشوند "proxy:") باید در تنظیمات
.B proxy_read_maps
یا
.B proxy_write_maps
سرور proxymap مشخص شود (بسته به این‌که دسترسی فقط‌خواندنی است یا خواندنی\-نوشتنی).
.IP "\fBflags (پیش‌فرض: 0)\fR"
پرچم‌های اختیاری که باید همراه با به‌روزرسانی memcache ذخیره شوند.
این پرچم‌ها هنگام جستجوی اطلاعات نادیده گرفته می‌شوند.
.IP "\fBttl (پیش‌فرض: 3600)\fR"
زمان انقضا بر حسب ثانیه برای به‌روزرسانی‌های memcache.
.PP
نکته ۱: هنگام استفاده از جدول memcache به عنوان کش
.BR postscreen (8)
یا
.BR verify (8)
بدون پشتیبان پایدار، مقدار صفر را برای
.B *_cache_cleanup_interval
در تمام نمونه‌های Postfix که از memcache استفاده می‌کنند مشخص کرده، و بزرگترین مقدار
.B *_ttl
در
.BR postscreen (8)
یا مقدار
.B *_expire_time
در
.BR verify (8)
را به عنوان مقدار
.B ttl
جدول memcache تعیین کنید.
.PP
نکته ۲: بر اساس مستندات پروتکل memcache، مقداری بزرگتر از ۳۰ روز (۲۵۹۲۰۰۰ ثانیه) بیانگر زمان مطلق یونیکس (UNIX time) است.
مقادیر کوچکتر نسبت به زمان به‌روزرسانی سنجیده می‌شوند.
.SH "پارامترهای کلید MEMCACHE (MEMCACHE KEY PARAMETERS)"
.na
.nf
.ad
.fi
.IP "\fBkey_digest (پیش‌فرض: خالی)\fR"
پس از پردازش تنظیمات
.B key_format
و پیش از ارسال درخواست به سرور memcache، کلید را از طریق الگوریتم خلاصه پیام (message digest) مشخص‌شده پردازش کرده
و نتیجه را به حروف هگزادسیمال کوچک تبدیل می‌کند. این کار از خطای دسترسی به پایگاه‌داده در مواقعی که ممکن است طول کلیدها از
محدودیت طول کلید در سرور memcache (معمولاً ۲۵۰ بایت) فراتر رود، جلوگیری می‌کند. نام الگوریتم خلاصه پیامی را که توسط OpenSSL
پشتیبانی می‌شود، به عنوان مثال
.BR sha256 ،
مشخص کنید.
.PP
این قابلیت در Postfix نسخه 3.11 و بالاتر در دسترس است و مستلزم آن است که Postfix با پشتیبانی از TLS ساخته شده باشد.
.IP "\fBkey_format (پیش‌فرض: %s)\fR"
قالب کلیدهای جستجو و به‌روزرسانی که کلاینت memcache در Postfix به سرور memcache ارسال می‌کند.
به طور پیش‌فرض، این کلیدها با کلیدهای جستجو و به‌روزرسانی که کلاینت memcache از برنامه‌های Postfix دریافت می‌کند یکسان هستند.
.PP
نکته ۱: قابلیت
.B key_format
برای درخواست‌های پایگاه‌داده
.B backup
استفاده نمی‌شود.
.PP
نکته ۲: هنگامی که چندین جدول از یک پایگاه‌داده memcache مشترک استفاده می‌کنند، هر جدول باید رشته یکتای خود را به ابتدای کلید جستجو اضافه کند.
در غیر این صورت، پاکسازی خودکار کش
.BR postscreen (8)
یا
.BR verify (8)
ممکن است کار نکند.
.PP
مثال‌ها:
.nf
    key_format = aliases:%s
    key_format = verify:%s
    key_format = postscreen:%s
.fi
.PP
پارامتر
.B key_format
از بسط‌های '%' زیر پشتیبانی می‌کند:
.RS
.IP "\fB%%\fR"
با یک نویسه '%' واقعی جایگزین می‌شود.
.IP "\fB%s\fR"
با کلید ورودی کلاینت memcache جایگزین می‌شود.
.IP "\fB%u\fR"
هنگامی که کلید ورودی آدرسی به فرم user@domain باشد،
\fB%u\fR
با بخش محلی (localpart) آدرس که طبق قواعد SQL نقل‌قول شده است جایگزین می‌شود. در غیر این صورت،
\fB%u\fR
با کل رشته جستجو جایگزین می‌شود. اگر بخش محلی خالی باشد، جستجو بدون هیچ پیامی نادیده گرفته شده و نتیجه‌ای برنمی‌گرداند (به‌روزرسانی با یک هشدار نادیده گرفته می‌شود).
.IP "\fB%d\fR"
هنگامی که کلید ورودی آدرسی به فرم user@domain باشد،
\fB%d\fR
با بخش دامنه آدرس جایگزین می‌شود. در غیر این صورت، جستجو بدون هیچ پیامی نادیده گرفته شده و نتیجه‌ای برنمی‌گرداند (به‌روزرسانی با یک هشدار نادیده گرفته می‌شود).
.IP "\fB%[SUD]\fR"
معادل‌های حروف بزرگ بسط‌های فوق در پارامتر
.B key_format
رفتاری دقیقاً مشابه با همتایان حروف کوچک خود دارند.
.IP "\fB%[1\-9]\fR"
الگوهای %1، %2، ... %9 با مؤلفه بااهمیت‌تر مربوطه از دامنه کلید ورودی جایگزین می‌شوند. اگر کلید ورودی
\fIuser@mail.example.com\fR
باشد، آن‌گاه %1 برابر با
\fBcom\fR،
%2 برابر با
\fBexample\fR
و %3 برابر با
\fBmail\fR
خواهد بود. اگر کلید ورودی فاقد صلاحیت باشد یا مؤلفه‌های دامنه کافی برای برآورده کردن تمام الگوهای مشخص‌شده نداشته باشد،
جستجو بدون هیچ پیامی نادیده گرفته شده و نتیجه‌ای برنمی‌گرداند (به‌روزرسانی با یک هشدار نادیده گرفته می‌شود).
.RE
.IP "\fBdomain (پیش‌فرض: بدون فهرست دامنه)\fR"
این قابلیت می‌تواند بار سرور پایگاه‌داده را به طور چشمگیری کاهش دهد.
فهرستی از نام‌های دامنه، مسیر فایل‌ها یا پایگاه‌های داده "type:table" را مشخص کنید.
در صورت تعیین، تنها کلیدهای جستجوی کاملاً واجد شرایط با یک بخش محلی *غیرخالی* و یک دامنه منطبق،
واجد شرایط جستجو یا به‌روزرسانی خواهند بود: جستجوهای صرف 'user'، جستجوهای صرف دامنه و جستجوهای "@domain" بدون هیچ پیامی نادیده گرفته می‌شوند (به‌روزرسانی‌ها با یک هشدار نادیده گرفته می‌شوند). مثال:
.nf
    domain = example.com, hash:/etc/postfix/searchdomains
.fi
.SH "کنترل‌های خطای MEMCACHE (MEMCACHE ERROR CONTROLS)"
.na
.nf
.ad
.fi
.IP "\fBdata_size_limit (پیش‌فرض: 10240)\fR"
حداکثر طول داده پاسخ memcache بر حسب بایت.
.IP "\fBline_size_limit (پیش‌فرض: 1024)\fR"
حداکثر طول خط پاسخ memcache بر حسب بایت.
.IP "\fBmax_try (پیش‌فرض: 2)\fR"
تعداد دفعات تلاش برای اجرای یک دستور memcache پیش از صرف‌نظر کردن.
کلاینت memcache در صورتی که سرور memcache هیچ اتصالی را نپذیرد، دستور را مجدداً تکرار نمی‌کند.
.IP "\fBretry_pause (پیش‌فرض: 1)\fR"
زمان بر حسب ثانیه پیش از تلاش مجدد برای اجرای یک دستور ناموفق memcache.
.IP "\fBtimeout (پیش‌فرض: 2)\fR"
محدودیت زمانی برای ارسال یک دستور memcache و دریافت پاسخ memcache.
.SH "اشکالات (BUGS)"
.ad
.fi
کلاینت memcache در Postfix نمی‌تواند برای جدول‌های حساس از نظر امنیتی مانند
\fBalias_maps\fR
(که ممکن است حاوی مقصدهای
"\fI|command\fR"
و
"\fI/file/name\fR"
باشند)، یا
\fBvirtual_uid_maps\fR،
\fBvirtual_gid_maps\fR
و
\fBvirtual_mailbox_maps\fR
(که امتیازات فرآیند یونیکس را برای مقصدهای
"\fI/file/name\fR"
تعیین می‌کنند) استفاده شود. در یک پیاده‌سازی معمول، پایگاه‌داده memcache توسط هر فرآیندی که بتواند با سرور memcache ارتباط برقرار کند قابل نوشتن است؛
در مقابل، جدول‌های حساس امنیتی هرگز نباید توسط کاربر غیرممتاز Postfix قابل نوشتن باشند.
.PP
کلاینت memcache در Postfix هنگام استفاده به عنوان کش
.BR postscreen (8)
یا
.BR verify (8)
به پیکربندی اضافی نیاز دارد. برای جزئیات بیشتر به توضیحات پارامترهای
.B backup
و
.B ttl
در بخش «پارامترهای اصلی MEMCACHE (MEMCACHE MAIN PARAMETERS)» در بالا مراجعه کنید.
.SH "همچنین ببینید (SEE ALSO)"
.na
.nf
postmap(1)، مدیر جدول‌های جستجوی Postfix
postconf(5)، پارامترهای پیکربندی
.SH "فایل‌های راهنما (README FILES)"
.na
.nf
.ad
.fi
برای یافتن این اطلاعات از "\fBpostconf readme_directory\fR" یا "\fBpostconf html_directory\fR" استفاده کنید.
.na
.nf
DATABASE_README، بررسی اجمالی جدول‌های جستجوی Postfix
MEMCACHE_README، راهنمای کلاینت memcache در Postfix
.SH "مجوز (LICENSE)"
.na
.nf
.ad
.fi
مجوز Secure Mailer باید همراه با این نرم‌افزار توزیع شود.
.SH "تاریخچه (HISTORY)"
.ad
.fi
.ad
.fi
پشتیبانی از memcache در نسخه 2.9 پُست‌فیکس (Postfix) معرفی شد.
.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