.TH SOCKETMAP_TABLE 5
.ad
.fi
.SH "نام (NAME)"
socketmap_table \- کلاینت جستجوی جدول socketmap در Postfix
.SH "خلاصه دستور (SYNOPSIS)"
.na
.nf
\fBpostmap \-q "\fIstring\fB" socketmap:inet:\fIhost\fB:\fIport\fB:\fIname\fR
.br
\fBpostmap \-q "\fIstring\fB" socketmap:unix:\fIpathname\fB:\fIname\fR

\fBpostmap \-q \- socketmap:inet:\fIhost\fB:\fIport\fB:\fIname\fB <\fIinputfile\fR
.br
\fBpostmap \-q \- socketmap:unix:\fIpathname\fB:\fIname\fB <\fIinputfile\fR
.SH "توضیحات (DESCRIPTION)"
.ad
.fi
سیستم ایمیل Postfix از جدول‌های اختیاری برای بازنویسی آدرس یا
مسیریابی ایمیل استفاده می‌کند. این جدول‌ها معمولاً در قالب‌های
\fBlmdb:\fR، \fBcdb:\fR، \fBhash:\fR یا \fBdbm:\fR هستند.

کلاینت socketmap در Postfix انتظار نام‌های نقطه پایانی TCP به فرم
\fBinet:\fIhost\fB:\fIport\fB:\fIname\fR
یا نقاط پایانی دامنه یونیکس (UNIX\-domain) به فرم
\fBunix:\fIpathname\fB:\fIname\fR
را دارد. در هر دو حالت،
\fIname\fR
فیلد نام را در یک درخواست کلاینت socketmap مشخص می‌کند (بخش «قالب درخواست (REQUEST FORMAT)» را در زیر ببینید).
.SH "پروتکل (PROTOCOL)"
.na
.nf
.ad
.fi
سرویس socketmap از یک پروتکل ساده استفاده می‌کند: کلاینت یک درخواست ارسال می‌کند و سرور یک پاسخ می‌فرستد. هر درخواست و هر پاسخ به عنوان یک شیء netstring ارسال می‌شوند.
.SH "قالب درخواست (REQUEST FORMAT)"
.na
.nf
.ad
.fi
پروتکل socketmap تنها از درخواست جستجو (lookup) پشتیبانی می‌کند.
درخواست دارای ساختار زیر است:

.IP "\fB\fIname\fB <space> \fIkey\fR"
جستجوی کلید مشخص‌شده در socketmap با نام تعیین‌شده.
.PP
سیستم Postfix کلیدهای جستجوی ناقص مانند نام‌های دامنه بدون یک یا چند زیردامنه، آدرس‌های شبکه بدون یک یا چند بایت کم‌ارزش (least\-significant octets)، یا آدرس‌های ایمیل بدون بخش محلی (localpart)، پسوند آدرس یا بخش دامنه را تولید نخواهد کرد. این رفتار در جدول‌های
cidr:، pcre:
و
regexp:
نیز دیده می‌شود.
.SH "قالب پاسخ (REPLY FORMAT)"
.na
.nf
.ad
.fi
پاسخ‌ها باید ساختار زیر را داشته باشند:
.IP "\fBOK <space> \fIdata\fR"
داده درخواستی پیدا شد.
.IP "\fBNOTFOUND <space>"
داده درخواستی پیدا نشد.
.IP "\fBTEMP <space> \fIreason\fR"
.IP "\fBTIMEOUT <space> \fIreason\fR"
.IP "\fBPERM <space> \fIreason\fR"
درخواست با شکست مواجه شد. در صورت خالی نبودن، دلیل (\fIreason\fR) یک متن توصیفی است.
.SH "محدودیت‌های پروتکل (PROTOCOL LIMITS)"
.na
.nf
.ad
.fi
کلاینت socketmap در Postfix ایجاب می‌کند که طول پاسخ‌ها بیشتر از ۱۰۰۰۰۰ بایت (بدون احتساب بسته‌بندی netstring) نباشد. این محدودیت می‌تواند با پارامتر پیکربندی
socketmap_max_reply_size
تغییر کند (در Postfix نسخه ۳.۱۰ و بالاتر).

کلاینت socketmap در Postfix یک محدودیت زمانی ۱۰۰ ثانیه‌ای برای اتصال به سرور socketmap، ارسال درخواست و دریافت پاسخ اعمال می‌کند. این کلاینت یک اتصال غیرفعال (idle) را پس از ۱۰ ثانیه و یک اتصال فعال را پس از ۱۰۰ ثانیه می‌بندد. این محدودیت‌ها (هنوز) قابل‌پیکربندی نیستند.
.SH "امنیت (SECURITY)"
.na
.nf
.ad
.fi
از این نگاشت نمی‌توان برای اطلاعات حساس از نظر امنیتی استفاده کرد، زیرا نه اتصال و نه سرور هیچ‌کدام احراز هویت نمی‌شوند.
.SH "پارامترهای پیکربندی (CONFIGURATION PARAMETERS)"
.na
.nf
.ad
.fi
.IP "\fBsocketmap_max_reply_size (100000)\fR"
حداکثر اندازه مجاز پاسخ از یک سرور socketmap، بدون احتساب بسته‌بندی netstring.
.SH "همچنین ببینید (SEE ALSO)"
.na
.nf
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
.SH "فایل‌های راهنما (README FILES)"
.na
.nf
.ad
.fi
از
"\fBpostconf readme_directory\fR"
یا
"\fBpostconf html_directory\fR"
برای مکان‌یابی این اطلاعات استفاده کنید.
.na
.nf
DATABASE_README, نمای کلی جدول‌های جستجوی Postfix
.SH "اشکالات (BUGS)"
.ad
.fi
محدودیت‌های زمانی پروتکل هنوز قابل‌پیکربندی نیستند.
.SH "مجوز (LICENSE)"
.na
.nf
.ad
.fi
مجوز Secure Mailer باید به همراه این نرم‌افزار توزیع شود.
.SH "تاریخچه (HISTORY)"
.ad
.fi
پشتیبانی از Socketmap در نسخه ۲.۱۰ از Postfix معرفی شد.

پروتکل socketmap همراه با Sendmail نسخه ۸.۱۳ منتشر شد.
.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

Wietse Venema
porcupine.org