.TH TCP_TABLE 5
.ad
.fi
.SH "نام (NAME)"
tcp_table \- پروتکل جستجوی جدول کلاینت/سرور Postfix
.SH "خلاصه دستور (SYNOPSIS)"
.na
.nf
\fBpostmap \-q "\fIstring\fB" tcp:\fIhost:port\fR

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

در روش جایگزین، جستجوهای جدول می‌توانند به یک سرور TCP هدایت شوند.
برای آزمایش جدول‌های جستجو، از دستور "\fBpostmap \-q\fR" همان‌گونه که در
بخش خلاصه دستور در بالا شرح داده شده استفاده کنید.
.SH "شرح پروتکل (PROTOCOL DESCRIPTION)"
.na
.nf
.ad
.fi
کلاس نگاشت TCP پروتکلی بسیار ساده را پیاده‌سازی می‌کند: کلاینت یک
درخواست ارسال می‌کند و سرور یک پاسخ می‌فرستد. درخواست‌ها و پاسخ‌ها
به‌صورت یک خط متنی ASCII و خاتمه‌یافته با نویسه خط جدید ASCII ارسال می‌شوند.
پارامترهای درخواست و پاسخ (به زیر مراجعه کنید) با فاصله خالی (whitespace)
از یکدیگر جدا می‌شوند.

عملیات ارسال و دریافت باید ظرف ۱۰۰ ثانیه تکمیل شوند.
.SH "قالب درخواست (REQUEST FORMAT)"
.na
.nf
.ad
.fi
پروتکل tcp_table تنها از درخواست lookup پشتیبانی می‌کند.
درخواست قالب زیر را دارد:
.IP "\fBget\fR SPACE \fIkey\fR NEWLINE"
جستجوی داده تحت کلید مشخص‌شده.
.PP
سیستم Postfix کلیدهای جستجوی ناقص مانند نام‌های دامنه بدون یک یا چند
زیردامنه، نشانی‌های شبکه بدون یک یا چند بایت کم‌ارزش (least-significant octets)،
یا نشانی‌های ایمیل بدون بخش محلی (localpart)، پسوند نشانی یا بخش دامنه تولید
نخواهد کرد. این رفتار در جدول‌های cidr:، pcre: و regexp: نیز دیده می‌شود.
.SH "قالب پاسخ (REPLY FORMAT)"
.na
.nf
.ad
.fi
هر پاسخ یک کد وضعیت و یک متن را مشخص می‌کند. پاسخ‌ها نباید بیش از
۴۰۹۶ نویسه با احتساب پایان‌دهنده خط جدید باشند.
.IP "\fB500\fR SPACE \fItext\fR NEWLINE"
در مورد یک درخواست lookup، داده مورد درخواست وجود ندارد.
متن، ماهیت مشکل را شرح می‌دهد.
.IP "\fB400\fR SPACE \fItext\fR NEWLINE"
این وضعیت نشان‌دهنده شرایط خطا است. متن، ماهیت مشکل را شرح می‌دهد.
کلاینت باید بعداً درخواست را دوباره امتحان کند.
.IP "\fB200\fR SPACE \fItext\fR NEWLINE"
درخواست موفقیت‌آمیز بود. در مورد یک درخواست lookup، متن حاوی
نسخه کدگذاری‌شده داده‌های مورد درخواست است.
.SH "کدگذاری (ENCODING)"
.na
.nf
.ad
.fi
در پارامترهای درخواست و پاسخ، نویسه %، هر نویسه غیرقابل‌چاپ و هر نویسه
فاصله خالی باید با %XX جایگزین شود، که در آن XX مقدار نویسه هگزادسیمال
ASCII متناظر است. کدهای هگزادسیمال می‌توانند با هر اندازه‌ای (بزرگ، کوچک، ترکیبی)
مشخص شوند.

کلاینت Postfix همیشه یک درخواست را کدگذاری می‌کند.
سرور می‌تواند از کدگذاری صرف‌نظر کند به شرطی که تضمین شود پاسخ
شامل نویسه % یا NEWLINE نیست.
.SH "امنیت (SECURITY)"
.na
.nf
.ad
.fi
از جدول‌های جستجوی TCP برای اهداف حساس امنیتی استفاده نکنید.
اتصال کلاینت-سرور محافظت‌نشده است و هویت سرور اعتبارسنجی نمی‌شود.
.SH "ایرادات (BUGS)"
.ad
.fi
در حال حاضر تنها روش lookup پیاده‌سازی شده است.

زمانی که اتصال برای مدت طولانی بیکار باشد، کلاینت ارتباط را قطع نمی‌کند.
.SH "همچنین ببینید (SEE ALSO)"
.na
.nf
postmap(1), مدیر جدول جستجوی Postfix
regexp_table(5), قالب جدول‌های عبارات منظم
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 "مجوز (LICENSE)"
.na
.nf
.ad
.fi
مجوز Secure Mailer باید همراه این نرم‌افزار توزیع شود.
.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