| SOCKETMAP_TABLE(5) | File Formats Manual | SOCKETMAP_TABLE(5) |
نام (NAME)
socketmap_table - کلاینت جستجوی جدول socketmap در Postfix
خلاصه دستور (SYNOPSIS)
postmap -q "string" socketmap:inet:host:port:name postmap -q "string" socketmap:unix:pathname:name postmap -q - socketmap:inet:host:port:name <inputfile postmap -q - socketmap:unix:pathname:name <inputfile
توضیحات (DESCRIPTION)
سیستم ایمیل Postfix از جدول‌های اختیاری برای بازنویسی آدرس یا مسیریابی ایمیل استفاده می‌کند. این جدول‌ها معمولاً در قالب‌های lmdb:، cdb:، hash: یا dbm: هستند.
کلاینت socketmap در Postfix انتظار نام‌های نقطه پایانی TCP به فرم inet:host:port:name یا نقاط پایانی دامنه یونیکس (UNIX-domain) به فرم unix:pathname:name را دارد. در هر دو حالت، name فیلد نام را در یک درخواست کلاینت socketmap مشخص می‌کند (بخش «قالب درخواست (REQUEST FORMAT)» را در زیر ببینید).
پروتکل (PROTOCOL)
سرویس socketmap از یک پروتکل ساده استفاده می‌کند: کلاینت یک درخواست ارسال می‌کند و سرور یک پاسخ می‌فرستد. هر درخواست و هر پاسخ به عنوان یک شیء netstring ارسال می‌شوند.
قالب درخواست (REQUEST FORMAT)
پروتکل socketmap تنها از درخواست جستجو (lookup) پشتیبانی می‌کند. درخواست دارای ساختار زیر است:
- name <space> key
- جستجوی کلید مشخص‌شده در socketmap با نام تعیین‌شده.
سیستم Postfix کلیدهای جستجوی ناقص مانند نام‌های دامنه بدون یک یا چند زیردامنه، آدرس‌های شبکه بدون یک یا چند بایت کم‌ارزش (least-significant octets)، یا آدرس‌های ایمیل بدون بخش محلی (localpart)، پسوند آدرس یا بخش دامنه را تولید نخواهد کرد. این رفتار در جدول‌های cidr:، pcre: و regexp: نیز دیده می‌شود.
قالب پاسخ (REPLY FORMAT)
پاسخ‌ها باید ساختار زیر را داشته باشند:
- OK <space> data
- داده درخواستی پیدا شد.
- NOTFOUND <space>
- داده درخواستی پیدا نشد.
- TEMP <space> reason
- TIMEOUT <space> reason
- PERM <space> reason
- درخواست با شکست مواجه شد. در صورت خالی نبودن، دلیل (reason) یک متن توصیفی است.
محدودیت‌های پروتکل (PROTOCOL LIMITS)
کلاینت socketmap در Postfix ایجاب می‌کند که طول پاسخ‌ها بیشتر از ۱۰۰۰۰۰ بایت (بدون احتساب بسته‌بندی netstring) نباشد. این محدودیت می‌تواند با پارامتر پیکربندی socketmap_max_reply_size تغییر کند (در Postfix نسخه ۳.۱۰ و بالاتر).
کلاینت socketmap در Postfix یک محدودیت زمانی ۱۰۰ ثانیه‌ای برای اتصال به سرور socketmap، ارسال درخواست و دریافت پاسخ اعمال می‌کند. این کلاینت یک اتصال غیرفعال (idle) را پس از ۱۰ ثانیه و یک اتصال فعال را پس از ۱۰۰ ثانیه می‌بندد. این محدودیت‌ها (هنوز) قابل‌پیکربندی نیستند.
امنیت (SECURITY)
از این نگاشت نمی‌توان برای اطلاعات حساس از نظر امنیتی استفاده کرد، زیرا نه اتصال و نه سرور هیچ‌کدام احراز هویت نمی‌شوند.
پارامترهای پیکربندی (CONFIGURATION PARAMETERS)
- socketmap_max_reply_size (100000)
- حداکثر اندازه مجاز پاسخ از یک سرور socketmap، بدون احتساب بسته‌بندی netstring.
همچنین ببینید (SEE ALSO)
https://cr.yp.to/proto/netstrings.txt, تعریف netstring postconf(1), جدول‌های جستجوی پشتیبانی‌شده در Postfix postmap(1), مدیریت جدول‌های جستجوی Postfix regexp_table(5), قالب جدول‌های عبارت‌های منظم (regular expression) pcre_table(5), قالب جدول‌های PCRE cidr_table(5), قالب جدول‌های CIDR
فایل‌های راهنما (README FILES)
از "postconf readme_directory" یا "postconf html_directory" برای مکان‌یابی این اطلاعات استفاده کنید.
DATABASE_README, نمای کلی جدول‌های جستجوی Postfix
اشکالات (BUGS)
محدودیت‌های زمانی پروتکل هنوز قابل‌پیکربندی نیستند.
مجوز (LICENSE)
مجوز Secure Mailer باید به همراه این نرم‌افزار توزیع شود.
تاریخچه (HISTORY)
پشتیبانی از Socketmap در نسخه ۲.۱۰ از Postfix معرفی شد.
پروتکل socketmap همراه با Sendmail نسخه ۸.۱۳ منتشر شد.
نویسندگان (AUTHORS)
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 Wietse Venema porcupine.org