.TH FLUSH 8
.ad
.fi
.SH "نام (NAME)"
flush \- کارساز پاک‌سازی سریع Postfix
.SH "خلاصه دستور (SYNOPSIS)"
.na
.nf
\fBflush\fR [generic Postfix daemon options]
.SH "توضیحات (DESCRIPTION)"
.ad
.fi
کارساز
\fBflush\fR(8)
پیشینه‌ای از نامه‌های به تعویق افتاده را بر پایه مقصد نگهداری می‌کند.
این اطلاعات برای بهبود کارایی درخواست
\fBETRN\fR
در SMTP و معادل خط فرمانی آن،
"\fBsendmail \-qR\fR"
یا
"\fBpostqueue \-f\fR"
به کار می‌رود.
این برنامه انتظار دارد از مدیر فرایند
\fBmaster\fR(8)
اجرا شود.

این پیشینه در قالب یک لاگ‌فایل به ازای هر مقصد پیاده‌سازی شده است که
شناسه‌های صف نامه‌های به تعویق افتاده محتوای آن را تشکیل می‌دهند. یک لاگ‌فایل
فقط‌افزودنی (append\-only) است و زمانی که تحویل نامه برای مقصد مربوطه
درخواست شود، کوتاه (truncate) می‌شود. یک مقصد، بخشی است که در سمت راست
راست‌ترین نویسه
\fB@\fR
در یک نشانی ایمیل قرار دارد.

لاگ‌فایل‌های به ازای هر مقصد نامه‌های به تعویق افتاده تنها برای مقاصد
واجد شرایط نگهداری می‌شوند. فهرست مقاصد واجد شرایط با پارامتر پیکربندی
\fBfast_flush_domains\fR
مشخص می‌شود که مقدار پیش‌فرض آن
\fB$relay_domains\fR
است.

این کارساز درخواست‌های زیر را پیاده‌سازی می‌کند:
.IP "\fBadd\fI sitename queueid\fR"
به کارساز
\fBflush\fR(8)
اطلاع می‌دهد که پیامی با شناسه صف مشخص‌شده، برای مقصد معین در صف قرار گرفته است.
.IP "\fBsend_site\fI sitename\fR"
درخواست تحویل نامه‌هایی را می‌دهد که برای مقصد مشخص‌شده در صف قرار دارند.
.IP "\fBsend_file\fI queueid\fR"
درخواست تحویل پیام معوقه مشخص‌شده را می‌دهد.
.IP \fBrefresh\fR
لاگ‌فایل‌های غیرخالی به ازای هر مقصد را که در
\fB$fast_flush_refresh_time\fR
ساعت گذشته خوانده نشده‌اند، با شبیه‌سازی درخواست‌های ارسال (به بالا نگاه کنید) برای مقاصد مربوطه تازه‌سازی می‌کند.
.sp
لاگ‌فایل‌های خالی به ازای هر مقصد را که در
\fB$fast_flush_purge_time\fR
روز گذشته به‌روزرسانی نشده‌اند، حذف می‌کند.
.sp
این درخواست در پس‌زمینه تکمیل می‌شود.
.IP \fBpurge\fR
عملیات
\fBrefresh\fR
را برای تمام لاگ‌فایل‌های به ازای هر مقصد انجام می‌دهد.
.SH "امنیت (SECURITY)"
.na
.nf
.ad
.fi
کارساز
\fBflush\fR(8)
از نظر امنیتی حساس نیست. این کارساز نه با شبکه ارتباط برقرار می‌کند و نه با کاربران محلی.
کارساز فلاش سریع می‌تواند به‌صورت chroot با سطح دسترسی پایین و ثابت اجرا شود.
.SH "عیب‌یابی (DIAGNOSTICS)"
.ad
.fi
مشکلات و تراکنش‌ها در
\fBsyslogd\fR(8)
یا
\fBpostlogd\fR(8)
ثبت می‌شوند.
.SH "ایرادات (BUGS)"
.ad
.fi
لاگ‌فایل‌های فلاش سریع تنها پس از یک درخواست "send" کوتاه (truncate) می‌شوند،
نه هنگامی که نامه واقعاً تحویل داده شد؛ از این رو ممکن است داده‌های منسوخ یا تکراری در آن‌ها انباشته شود. به منظور حفظ سلامت عملکرد،
باید "refresh" به صورت دوره‌ای اجرا گردد. این کار می‌تواند با یک تنظیم مناسب برای تایمر بیدارباش در فایل پیکربندی
\fBmaster.cf\fR
خودکارسازی شود.

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

متن زیر تنها خلاصه‌ای از پارامترها را ارائه می‌دهد. برای جزئیات بیشتر شامل مثال‌ها به
\fBpostconf\fR(5)
مراجعه فرمایید.
.IP "\fBconfig_directory (خروجی 'postconf \-d' را ببینید)\fR"
مکان پیش‌فرض فایل‌های پیکربندی main.cf و master.cf مربوط به Postfix.
.IP "\fBdaemon_timeout (18000s)\fR"
حداکثر زمانی که یک فرایند دیمن Postfix مجاز است برای رسیدگی به یک درخواست صرف کند، پیش از آنکه توسط تایمر مراقب (watchdog) داخلی متوقف شود.
.IP "\fBfast_flush_domains ($relay_domains)\fR"
فهرست اختیاری از مقاصدی که واجد شرایط نگهداری لاگ‌فایل‌های به ازای هر مقصد برای نامه‌های صف‌بندی‌شده هستند.
.IP "\fBfast_flush_refresh_time (12h)\fR"
مدت زمانی که پس از آن، یک لاگ‌فایل غیرخالی اما خوانده‌نشده "fast flush" به ازای هر مقصد باید تازه‌سازی شود.
.IP "\fBfast_flush_purge_time (7d)\fR"
مدت زمانی که پس از آن، یک لاگ‌فایل خالی "fast flush" به ازای هر مقصد پاک می‌شود.
.IP "\fBipc_timeout (3600s)\fR"
محدودیت زمانی برای ارسال یا دریافت اطلاعات از طریق یک کانال ارتباطی داخلی.
.IP "\fBmax_idle (100s)\fR"
حداکثر مدت زمانی که یک فرایند دیمن بیکار Postfix قبل از خاتمه داوطلبانه، منتظر اتصال ورودی می‌ماند.
.IP "\fBmax_use (100)\fR"
حداکثر تعداد اتصالات ورودی که یک فرایند دیمن Postfix پیش از خاتمه داوطلبانه سرویس‌دهی می‌کند.
.IP "\fBparent_domain_matches_subdomains (خروجی 'postconf \-d' را ببینید)\fR"
فهرستی از ویژگی‌های Postfix که در آن‌ها الگوی "example.com" با زیردامنه‌های example.com نیز مطابقت دارد، به جای اینکه به الگوی صریح ".example.com" نیاز داشته باشد.
.IP "\fBprocess_id (فقط‌خواندنی)\fR"
شناسه فرایند (PID) یک دستور یا فرایند دیمن Postfix.
.IP "\fBprocess_name (فقط‌خواندنی)\fR"
نام فرایند مربوط به یک دستور یا فرایند دیمن Postfix.
.IP "\fBqueue_directory (خروجی 'postconf \-d' را ببینید)\fR"
مکان دایرکتوری سطح بالای صف Postfix.
.IP "\fBsyslog_facility (mail)\fR"
تسهیلات syslog برای لاگ‌گیری Postfix.
.IP "\fBsyslog_name (خروجی 'postconf \-d' را ببینید)\fR"
پیشوندی که به نام فرایند در رکوردهای syslog اضافه می‌شود، به عنوان مثال "smtpd" به "prefix/smtpd" تبدیل می‌شود.
.PP
موجود در Postfix نسخه 3.3 و بالاتر:
.IP "\fBservice_name (فقط‌خواندنی)\fR"
نام سرویس در master.cf برای یک فرایند دیمن Postfix.
.SH "فایل‌ها (FILES)"
.na
.nf
/var/spool/postfix/flush, لاگ‌فایل‌های "fast flush".
.SH "همچنین ببینید (SEE ALSO)"
.na
.nf
smtpd(8), کارساز SMTP
qmgr(8), مدیر صف
postconf(5), پارامترهای پیکربندی
master(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
ETRN_README, راهنمای ETRN در Postfix
.SH "مجوز (LICENSE)"
.na
.nf
.ad
.fi
مجوز Secure Mailer باید همراه با این نرم‌افزار توزیع شود.
.SH "تاریخچه (HISTORY)"
.ad
.fi
این سرویس با Postfix نسخه 1.0 معرفی شد.
.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