نام (NAME)

postqueue - کنترل صف Postfix

خلاصه دستور (SYNOPSIS)

برای تخلیه صف ایمیل:
postqueue [-v] [-c config_dir] -f
postqueue [-v] [-c config_dir] -i queue_id
postqueue [-v] [-c config_dir] -s site
برای فهرست کردن صف ایمیل:
postqueue [-v] [-c config_dir] -j
postqueue [-v] [-c config_dir] -p

توضیحات (DESCRIPTION)

دستور postqueue(1) رابط کاربری Postfix را برای مدیریت صف پیاده‌سازی می‌کند. این دستور عملیاتی را اجرا می‌کند که به طور سنتی از طریق دستور sendmail(1) در دسترس بودند. برای عملیات صف که نیازمند دسترسی‌های مدیر سیستم (کاربر ارشد) هستند، مانند حذف یک پیام از صف یا تغییر وضعیت یک پیام، به دستور postsuper(1) مراجعه کنید.

گزینه‌های زیر پشتیبانی می‌شوند:

-c config_dir

فایل پیکربندی main.cf به جای دایرکتوری پیش‌فرض، در دایرکتوری نام‌برده‌شده قرار دارد. همچنین تنظیم محیطی MAIL_CONFIG را در ادامه ببینید.

-f

تخلیه صف: تلاش برای تحویل تمام نامه‌های موجود در صف.

این گزینه با تماس با دیمن qmgr(8) در Postfix، دستور سنتی «sendmail -q» را پیاده‌سازی می‌کند.

هشدار: تخلیه مکرر نامه‌های غیرقابل تحویل منجر به افت کارایی تحویل تمام نامه‌های دیگر خواهد شد.

-i queue_id

زمان‌بندی تحویل فوری نامه‌های به تعویق افتاده با شناسه صف (queue ID) مشخص‌شده.

این گزینه با تماس با سرور flush(8)، دستور سنتی sendmail -qI را پیاده‌سازی می‌کند.

این ویژگی در Postfix نسخه ۲.۴ و بالاتر در دسترس است.

-j

تولید فهرست صف در قالب JSON LINES، بر اساس خروجی دیمن showq(8). برای جزئیات به بخش «قالب شیء JSON» در ادامه مراجعه کنید.

این ویژگی در Postfix نسخه ۳.۱ و بالاتر در دسترس است.

-p

تولید فهرست سنتی صف به سبک sendmail. این گزینه با تماس با دیمن showq(8) در Postfix، دستور سنتی mailq را پیاده‌سازی می‌کند.

هر مدخل صف، شناسه فایل صف، اندازه پیام، زمان ورود، فرستنده و گیرندگانی را که هنوز باید پیام به آن‌ها تحویل داده شود نمایش می‌دهد. اگر در آخرین تلاش امکان تحویل نامه وجود نداشته باشد، دلیل شکست نمایش داده می‌شود. در Postfix نسخه ۳.۱۱ و بالاتر، خروجی همچنین ممکن است گیرندگان برگشت‌خورده‌ای را نمایش دهد که در انتظار ایجاد پیام اعلان وضعیت عدم تحویل برای بازگرداندن به فرستنده هستند.

پس از رشته شناسه صف، یک نویسه وضعیت اختیاری قرار می‌گیرد:

*: پیام در صف فعال (active) است، یعنی پیام برای تحویل انتخاب شده است.
!: پیام در صف تعلیق (hold) است، یعنی تا زمانی که نامه از حالت تعلیق خارج نشود هیچ تلاش دیگری برای تحویل صورت نخواهد گرفت.
#: پیام مجبور به انقضا شده است. گزینه‌های -e یا -f در postsuper(1) را ببینید.
این ویژگی در Postfix نسخه ۳.۵ و بالاتر در دسترس است.

-s site: زمان‌بندی تحویل فوری تمام نامه‌هایی که برای site مشخص‌شده در صف قرار دارند. یک مقصد عددی باید به صورت یک نشانی معتبر RFC 5321 درون [] مشخص شود، دقیقاً مانند نشانی‌های ایمیل. مقصد باید برای سرویس «fast flush» واجد شرایط باشد. برای اطلاعات بیشتر درباره سرویس «fast flush» به flush(8) مراجعه کنید.
این گزینه با برقراری تماس با دیمن flush(8) در Postfix، دستور سنتی «sendmail -qRsite» را پیاده‌سازی می‌کند.
-v: فعال کردن ثبت لاگ پرجزئیات برای اهداف اشکال‌زدایی. استفاده چندباره از گزینه -v نرم‌افزار را به طور فزاینده‌ای پرجزئیات می‌کند. از نسخه ۲.۳ Postfix به بعد، این گزینه فقط برای مدیر سیستم (کاربر ارشد) در دسترس است.

قالب شیء JSON (JSON OBJECT FORMAT)

هر شیء JSON نشان‌دهنده یک فایل صف است؛ این شیء به صورت یک خط متنی منفرد و به دنبال آن یک نویسه خط جدید صادر می‌شود.

اعضای شیء دارای مقادیر رشته‌ای هستند مگر آنکه خلاف آن مشخص شده باشد. برنامه‌ها باید اعضایی را که در اینجا فهرست نشده‌اند نادیده بگیرند؛ انتظار می‌رود فهرست اعضا در طول زمان گسترش یابد.

queue_name: نام صفی که پیام در آن یافت شده است. توجه داشته باشید که محتوای صف ایمیل ممکن است در حین فهرست‌بندی تغییر کند؛ برخی پیام‌ها ممکن است بیش از یک‌بار ظاهر شوند و برخی پیام‌ها ممکن است از قلم بیفتند.
queue_id: نام فایل صف. شناسه صف (queue_id) ممکن است در یک نمونه Postfix دوباره استفاده شود، مگر آنکه «enable_long_queue_ids = true» تنظیم شده و زمان یکنواخت (monotonic) باشد. حتی در این صورت نیز انتظار نمی‌رود queue_id بین نمونه‌های مختلف Postfix یکتا باشد. ابزارهای مدیریتی که نیازمند نامی یکتا هستند باید queue_id را با تنظیم myhostname نمونه Postfix ترکیب کنند.
arrival_time: تعداد ثانیه‌های سپری‌شده از مبدأ زمان یونیکس (UNIX epoch).
message_size: تعداد بایت‌های موجود در سرآیند و بدنه پیام. این عدد شامل اطلاعات پاکت (envelope) پیام نمی‌شود. این مقدار تقریباً برابر با تعداد بایت‌هایی است که از طریق SMTP به همراه پایان‌خط‌های <CR><LF> منتقل می‌شوند.
forced_expire (Postfix >= 3.5): آیا پیام مجبور به انقضا شده است (true یا false). گزینه‌های -e یا -f در postsuper(1) را ببینید.
sender: نشانی فرستنده در پاکت پیام.
recipients: آرایه‌ای حاوی صفر یا چند شیء با اعضای زیر:

address: یک نشانی گیرنده.
orig_address (Postfix >= 3.11): یک نشانی اصلی گیرنده.
delay_reason: در صورت وجود، دلیل تأخیر در تحویل. گیرندگان با تأخیر ممکن است دلیل تأخیری نداشته باشند، برای نمونه هنگام انجام تحویل، یا پس از آنکه سیستم پیش از ثبت دلیل متوقف شده باشد.
bounce_reason (Postfix >= 3.11): در صورت وجود، دلیل برگشت خوردن این گیرنده. گیرنده همچنان در انتظار ایجاد پیام اعلان وضعیت عدم تحویل است که به فرستنده بازگردانده خواهد شد.

امنیت (SECURITY)

این برنامه به گونه‌ای طراحی شده است که با دسترسی‌های set-group ID اجرا شود تا بتواند به فرآیندهای دیمن Postfix متصل شود.

استانداردها (STANDARDS)

RFC 7159 (نشانه‌گذاری JSON)

عیب‌یابی (DIAGNOSTICS)

مشکلات در syslogd(8) یا postlogd(8) و در جریان خطای استاندارد ثبت می‌شوند.

محیط (ENVIRONMENT)

MAIL_CONFIG: دایرکتوری حاوی فایل main.cf. به منظور جلوگیری از سوءاستفاده از مجوزهای set-group ID، استفاده از دایرکتوری غیرپیش‌فرض تنها در صورتی مجاز است که:

نام آن در فایل پیش‌فرض main.cf با پارامتر پیکربندی alternate_config_directories یا multi_instance_directories فهرست شده باشد.
دستور توسط مدیر سیستم (کاربر ارشد) فراخوانی شده باشد.

پارامترهای پیکربندی (CONFIGURATION PARAMETERS)

پارامترهای main.cf زیر به‌ویژه با این برنامه مرتبط هستند. متن زیر تنها خلاصه‌ای از پارامترها را ارائه می‌دهد. برای جزئیات بیشتر از جمله مثال‌ها، به postconf(5) مراجعه کنید.

alternate_config_directories (empty): فهرستی از دایرکتوری‌های غیرپیش‌فرض پیکربندی Postfix که می‌توان با «-c config_directory» در خط فرمان (در مورد sendmail(1) با گزینه «-C») یا از طریق پارامتر محیطی MAIL_CONFIG مشخص کرد.
config_directory (see 'postconf -d' output): مکان پیش‌فرض فایل‌های پیکربندی main.cf و master.cf در Postfix.
command_directory (see 'postconf -d' output): محل قرارگیری تمام دستورات مدیریتی Postfix.
fast_flush_domains ($relay_domains): فهرست اختیاری مقصدهایی که برای فایل‌های لاگ اختصاصی به ازای هر مقصد با نامه‌های در صف آن مقصدها واجد شرایط هستند.
import_environment (see 'postconf -d' output): فهرست متغیرهای محیطی که یک فرآیند دارای دسترسی Postfix از یک فرآیند والد غیر Postfix وارد می‌کند، یا جایگزینی‌های محیطی به صورت name=value.
queue_directory (see 'postconf -d' output): محل دایرکتوری سطح بالای صف Postfix.
syslog_facility (mail): امکانات syslog (syslog facility) برای لاگ‌برداری Postfix.
syslog_name (see 'postconf -d' output): پیشوندی که در رکوردهای syslog به ابتدای نام فرآیند اضافه می‌شود، به طوری که به عنوان مثال «smtpd» به «prefix/smtpd» تبدیل می‌شود.
trigger_timeout (10s): محدودیت زمانی برای ارسال یک محرک (trigger) به یک دیمن Postfix (برای مثال دیمن pickup(8) یا qmgr(8)).

موجود در Postfix نسخه ۲.۲ و بالاتر:

authorized_flush_users (static:anyone): فهرست کاربرانی که مجاز به تخلیه صف هستند.
authorized_mailq_users (static:anyone): فهرست کاربرانی که مجاز به مشاهده صف هستند.

فایل‌ها (FILES)

/var/spool/postfix, صف ایمیل

همچنین ببینید (SEE ALSO)

qmgr(8), مدیر صف
showq(8), فهرست کردن صف ایمیل
flush(8), سرویس تخلیه سریع
sendmail(1), رابط کاربری سازگار با Sendmail
postsuper(1), عملیات مجاز صف
postlogd(8), لاگ‌برداری Postfix
syslogd(8), لاگ‌برداری سیستم

فایل‌های README (README FILES)

برای مکان‌یابی این اطلاعات از «postconf readme_directory» یا «postconf html_directory» استفاده کنید.

ETRN_README, راهنمای جامع Postfix ETRN

مجوز (LICENSE)

مجوز Secure Mailer باید همراه با این نرم‌افزار توزیع شود.

تاریخچه (HISTORY)

دستور postqueue در نسخه ۱.۱ برنامه Postfix معرفی شد.

نویسندگان (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