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

                                                            SOCKETMAP_TABLE(5)