.TH SCACHE 8
.ad
.fi
.SH "نام (NAME)"
scache
\-
کارساز حافظه موقت (کش) اشتراکی اتصالات Postfix
.SH "خلاصه دستور (SYNOPSIS)"
.na
.nf
\fBscache\fR [گزینه‌های عمومی دیمن Postfix]
.SH "توضیحات (DESCRIPTION)"
.ad
.fi
کارساز \fBscache\fR(8) یک حافظه موقت (کش) اشتراکی چند‌اتصالی را نگهداری و مدیریت می‌کند.
این اطلاعات می‌تواند به عنوان مثال توسط کلاینت‌های SMTP در Postfix یا سایر عامل‌های تحویل
Postfix مورد استفاده قرار گیرد.

کش اتصال به صورت نام‌های مقاصد منطقی، نام‌های نقاط پایانی فیزیکی، و اتصالات سازماندهی شده است.

به عنوان یک نمونه مشخص، مقاصد منطقی SMTP شامل (transport, domain, port) و نقاط پایانی فیزیکی SMTP
شامل (transport, IP address, port) هستند. یک اتصال SMTP ممکن است پس از یک تراکنش پستی موفق ذخیره شود.

در حالت کلی، یک مقصد منطقی ممکن است به صفر یا چند نقطه پایانی فیزیکی ارجاع دهد، یک نقطه پایانی فیزیکی
ممکن است توسط صفر یا چند مقصد منطقی مورد ارجاع قرار گیرد، و یک نقطه پایانی ممکن است به صفر یا چند اتصال ارجاع داشته باشد.

نحو دقیق نام یک مقصد منطقی یا نقطه پایانی وابسته به برنامه است؛ کارساز \fBscache\fR(8) کاری به آن ندارد.
یک اتصال به صورت یک توصیف‌گر فایل همراه با اطلاعات وابسته به برنامه که برای فعال‌سازی مجدد یک شیء اتصال نیاز است ذخیره می‌شود.
مجدداً، کارساز \fBscache\fR(8) از جزئیات این اطلاعات کاملاً بی‌خبر است.

تمام اطلاعات با یک زمان حیات محدود (ttl) ذخیره می‌شوند.
دیمن کش اتصال هنگامی که برای مدت زمان \fBmax_idle\fR هیچ کلاینتی متصل نباشد، خاتمه می‌یابد.

این کارساز درخواست‌های زیر را پیاده‌سازی می‌کند:
.IP "\fBsave_endp\fI ttl endpoint endpoint_properties file_descriptor\fR"
توصیف‌گر فایل و داده‌های ویژگی اتصال مشخص‌شده را تحت نام نقطه پایانی داده‌شده ذخیره می‌کند. ویژگی‌های نقطه پایانی
توسط کلاینت برای فعال‌سازی مجدد یک شیء اتصال غیرفعال‌شده استفاده می‌شود.
.IP "\fBfind_endp\fI endpoint\fR"
ویژگی‌های کش‌شده و توصیف‌گر فایل کش‌شده را برای نقطه پایانی مشخص‌شده جستجو می‌کند.
.IP "\fBsave_dest\fI ttl destination destination_properties endpoint\fR"
پیوند میان یک مقصد منطقی و یک نقطه پایانی را تحت نام مقصد، همراه با ویژگی‌های اتصال مختص به مقصد ذخیره می‌کند.
ویژگی‌های مقصد توسط کلاینت برای فعال‌سازی مجدد یک شیء اتصال غیرفعال‌شده استفاده می‌شود.
.IP "\fBfind_dest\fI destination\fR"
ویژگی‌های مقصد کش‌شده، ویژگی‌های نقطه پایانی کش‌شده و توصیف‌گر فایل کش‌شده را برای مقصد منطقی مشخص‌شده جستجو می‌کند.
.SH "امنیت (SECURITY)"
.na
.nf
.ad
.fi
کارساز \fBscache\fR(8) از نظر امنیتی حساس نیست. این کارساز با شبکه ارتباط برقرار نمی‌کند و با کاربران محلی نیز
ارتباطی ندارد. کارساز \fBscache\fR(8) می‌تواند در محیط chroot با امتیازات پایین ثابت اجرا شود.

کارساز \fBscache\fR(8) یک فرآیند قابل‌اعتماد نیست. نباید برای ذخیره‌سازی اطلاعات حساس امنیتی استفاده شود.
.SH "عیب‌یابی (DIAGNOSTICS)"
.ad
.fi
مشکلات و تراکنش‌ها در \fBsyslogd\fR(8) یا \fBpostlogd\fR(8) ثبت می‌شوند.
.SH "اشکالات (BUGS)"
.ad
.fi
کش نشست (session cache) نمی‌تواند بین چندین ماشین به اشتراک گذاشته شود.

هنگامی که یک اتصال از کش منقضی می‌شود، بدون دست‌تکانی (handshake) مناسب ویژه پروتکل بسته می‌شود.
.SH "پارامترهای پیکربندی (CONFIGURATION PARAMETERS)"
.na
.nf
.ad
.fi
تغییرات در \fBmain.cf\fR به صورت خودکار اعمال می‌شوند زیرا فرآیندهای \fBscache\fR(8) تنها برای مدت زمان محدودی اجرا می‌شوند.
برای تسریع در اعمال تغییرات از دستور "\fBpostfix reload\fR" استفاده کنید.

متن زیر تنها خلاصه‌ای از پارامترها را ارائه می‌دهد. برای جزئیات بیشتر به همراه مثال‌ها به
\fBpostconf\fR(5) مراجعه کنید.
.SH "کنترل‌های منابع (RESOURCE CONTROLS)"
.na
.nf
.ad
.fi
.IP "\fBconnection_cache_ttl_limit (2s)\fR"
حداکثر مقدار زمان حیات (time\-to\-live) که کارساز کش اتصال \fBscache\fR(8) مجاز می‌داند.
.IP "\fBconnection_cache_status_update_time (600s)\fR"
توالی زمانی ثبت آمار مصرف توسط کارساز \fBscache\fR(8) به همراه نرخ‌های موفقیت (hit) و عدم موفقیت (miss) کش اتصال برای مقاصد منطقی و نقاط پایانی فیزیکی.
.SH "کنترل‌های متفرقه (MISCELLANEOUS CONTROLS)"
.na
.nf
.ad
.fi
.IP "\fBconfig_directory (see 'postconf -d' output)\fR"
مکان پیش‌فرض فایل‌های پیکربندی main.cf و master.cf در Postfix.
.IP "\fBdaemon_timeout (18000s)\fR"
مدت زمانی که یک فرآیند دیمن Postfix مجاز است صرف رسیدگی به یک درخواست کند پیش از آنکه توسط یک تایمر نظارتی (watchdog) داخلی متوقف شود.
.IP "\fBipc_timeout (3600s)\fR"
محدودیت زمانی برای ارسال یا دریافت اطلاعات از طریق یک کانال ارتباطی داخلی.
.IP "\fBmax_idle (100s)\fR"
حداکثر مدت زمانی که یک فرآیند دیمن بیکار Postfix برای یک اتصال ورودی منتظر می‌ماند پیش از آنکه به صورت داوطلبانه پایان یابد.
.IP "\fBprocess_id (read\-only)\fR"
شناسه فرآیند (PID) یک دستور یا فرآیند دیمن Postfix.
.IP "\fBprocess_name (read\-only)\fR"
نام فرآیند یک دستور یا فرآیند دیمن Postfix.
.IP "\fBsyslog_facility (mail)\fR"
تسهیلات syslog برای ثبت وقایع Postfix.
.IP "\fBsyslog_name (see 'postconf -d' output)\fR"
پیشوندی که به نام فرآیند در رکوردهای syslog اضافه می‌شود، به عنوان مثال "smtpd" به "prefix/smtpd" تبدیل می‌شود.
.PP
در Postfix نسخه 3.3 و بالاتر موجود است:
.IP "\fBservice_name (read\-only)\fR"
نام سرویس master.cf مربوط به یک فرآیند دیمن Postfix.
.SH "همچنین ببینید (SEE ALSO)"
.na
.nf
smtp(8), کلاینت SMTP
postconf(5), پارامترهای پیکربندی
master(8), مدیر فرآیند
postlogd(8), ثبت وقایع Postfix
syslogd(8), ثبت وقایع سیستم
.SH "فایل‌های راهنما (README FILES)"
.na
.nf
.ad
.fi
برای یافتن این اطلاعات از "\fBpostconf readme_directory\fR" یا
"\fBpostconf html_directory\fR" استفاده کنید.
.na
.nf
CONNECTION_CACHE_README, کش اتصال Postfix
.SH "مجوز (LICENSE)"
.na
.nf
.ad
.fi
مجوز Secure Mailer باید همراه با این نرم‌افزار توزیع شود.
.SH "تاریخچه (HISTORY)"
.ad
.fi
این سرویس با نسخه 2.2 در 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