.TH POSTSUPER 1 
.ad
.fi
.SH "نام (NAME)"
postsuper \- ناظر و مدیر ارشد صف Postfix
.SH "خلاصه دستور (SYNOPSIS)"
.na
.nf
.fi
\fBpostsuper\fR [\fB\-psSv\fR]
        [\fB\-c \fIconfig_dir\fR] [\fB\-d \fIqueue_id\fR]
        [\fB\-e \fIqueue_id\fR] [\fB\-f \fIqueue_id\fR]
        [\fB\-h \fIqueue_id\fR] [\fB\-H \fIqueue_id\fR]
        [\fB\-r \fIqueue_id\fR] [\fIdirectory ...\fR]
.SH "توضیحات (DESCRIPTION)"
.ad
.fi
دستور \fBpostsuper\fR(1) کارهای مربوط به نگه‌داری و مدیریت صف Postfix را انجام می‌دهد. استفاده از این دستور به کاربر مدیر سیستم (superuser/root) محدود شده است.
برای عملیات بدون امتیاز ویژه روی صف، مانند فهرست کردن یا ارسال فوری صف ایمیل، به دستور \fBpostqueue\fR(1) مراجعه کنید.

به‌طور پیش‌فرض، \fBpostsuper\fR(1) عملیات‌های درخواست‌شده با گزینه‌های خط فرمان \fB\-s\fR و \fB\-p\fR را روی تمام دایرکتوری‌های صف Postfix اجرا می‌کند \- این شامل دایرکتوری‌های \fBincoming\fR، \fBactive\fR، \fBdeferred\fR و \fBhold\fR حاوی فایل‌های پیام، و دایرکتوری‌های \fBbounce\fR، \fBdefer\fR، \fBtrace\fR و \fBflush\fR حاوی فایل‌های ثبت رویداد (log) است.

گزینه‌ها:
.IP "\fB\-c \fIconfig_dir\fR"
فایل پیکربندی \fBmain.cf\fR به جای دایرکتوری پیش‌فرض پیکربندی، در دایرکتوری مشخص‌شده قرار دارد. همچنین متغیر محیطی MAIL_CONFIG را در ادامه ببینید.
.IP "\fB\-d \fIqueue_id\fR"
یک پیام با شناسه صف (queue ID) مشخص‌شده را از صف(های) نام‌برده حذف می‌کند (پیش‌فرض: \fBhold\fR، \fBincoming\fR، \fBactive\fR و \fBdeferred\fR).

برای حذف چندین فایل، گزینهٔ \fB\-d\fR را چندین بار مشخص کنید، یا برای خواندن شناسه‌های صف از ورودی استاندارد، مقدار \fIqueue_id\fR را \fB\-\fR بگذارید. برای مثال، جهت حذف تمامی نامه‌هایی که دقیقاً یک گیرنده به آدرس \fBuser@example.com\fR دارند:
.sp
.nf
postqueue \-j | jq \-r '
    # See JSON OBJECT FORMAT section in the postqueue(1) manpage
    select(.recipients[0].address == "user@example.com")
    | select(.recipients[1].address == null)
    | .queue_id
 ' | postsuper \-d \-
.fi
.sp
(به گزینهٔ \(lqjq \-r\(rq توجه کنید)، یا شکل سنتی آن:
.sp
.nf
mailq | tail \-n +2 | grep \-v '^ *(' | awk  'BEGIN { RS = "" }
    # $7=sender, $8=recipient1, $9=recipient2
    { if ($8 == "user@example.com" && $9 == "")
          print $1 }
 ' | tr \-d '*!' | postsuper \-d \-
.fi
.sp
برای حذف تمام پیام‌ها مقدار \(lq\fB\-d ALL\fR\(rq را مشخص کنید؛ به عنوان نمونه، برای حذف تمام نامه‌های موجود در صف \fBdeferred\fR، مقدار \(lq\fB\-d ALL deferred\fR\(rq را مشخص کنید. به عنوان یک اقدام ایمنی، کلمهٔ \fBALL\fR حتماً باید با حروف بزرگ نوشته شود.
.sp
هشدار: شناسه‌های صف Postfix دوباره استفاده می‌شوند (همواره در Postfix نسخهٔ ۲.۸ و قدیمی‌تر؛ و در Postfix نسخهٔ ۲.۹ به بعد زمانی که enable_long_queue_ids=no باشد). احتمال بسیار اندکی وجود دارد که اگر postsuper در حین تحویل ایمیل توسط سیستم Postfix اجرا شود، فایل پیام اشتباهی را حذف کند.
.sp
سناریو به شرح زیر است:
.RS
.IP 1)
مدیر صف Postfix پیامی را که از \fBpostsuper\fR(1) خواسته شده حذف شود، حذف می‌کند؛ زیرا کار Postfix با پیام تمام شده است (یا تحویل داده شده، یا به فرستنده بازگردانده شده است).
.IP 2)
ایمیل جدیدی می‌رسد و به این پیام جدید همان شناسه صفی اختصاص می‌یابد که قرار بود \fBpostsuper\fR(1) آن را حذف کند. احتمال استفادهٔ مجدد از یک شناسه صف حذف‌شده تقریباً ۱ در 2**15 است (تعداد مقادیر میکروثانیه متفاوتی که ساعت سیستم می‌تواند در طول یک ثانیه تفکیک کند).
.IP 3)
دستور \fBpostsuper\fR(1) پیام جدید را به جای پیام قدیمی که باید حذف می‌شد، حذف می‌کند.
.RE
.IP "\fB\-e \fIqueue_id\fR"
.IP "\fB\-f \fIqueue_id\fR"
درخواست انقضای اجباری برای یک پیام با شناسه صف مشخص‌شده در صف(های) نام‌برده (پیش‌فرض: \fBhold\fR، \fBincoming\fR، \fBactive\fR و \fBdeferred\fR).
.RS
.IP \(bu
هنگامی که مدیر صف تلاش کند آن پیام را تحویل دهد، پیام به فرستنده بازگردانده خواهد شد (توجه داشته باشید که Postfix هرگز پیام‌های موجود در صف \fBhold\fR را تحویل نمی‌دهد).
.IP \(bu
هر دو گزینهٔ \fB\-e\fR و \fB\-f\fR درخواست انقضای اجباری را ثبت می‌کنند. تفاوت در این است که \fB\-f\fR پیامی را که در صف \fBhold\fR باشد نیز آزاد می‌کند. با \fB\-e\fR، چنین پیامی تا زمانی که با \fB\-f\fR یا \fB\-H\fR آزاد نشود به فرستنده بازگردانده نخواهد شد.
.IP \(bu
هنگامی که یک پیام به تعویق افتاده (deferred) به‌صورت اجباری منقضی می‌شود، پیام برگشتی دلیل این تأخیر را اعلام خواهد کرد. در غیر این صورت، دلیل به‌صورت \(lqmessage is administratively expired\(rq (پیام از نظر مدیریتی منقضی شده است) درج خواهد شد.
.RE
.IP
برای منقضی کردن چندین فایل، گزینهٔ \fB\-e\fR یا \fB\-f\fR را چندین بار مشخص کنید، یا برای خواندن شناسه‌های صف از ورودی استاندارد، مقدار \fIqueue_id\fR را \fB\-\fR بگذارید (برای نمونه به گزینهٔ \fB\-d\fR در بالا نگاه کنید، اما مطمئن شوید که \fB\-d\fR را در مثال جایگزین می‌کنید).
.sp
برای منقضی کردن همهٔ پیام‌ها عبارت \(lq\fB\-e ALL\fR\(rq یا \(lq\fB\-f ALL\fR\(rq را مشخص کنید؛ مثلاً برای منقضی کردن همهٔ نامه‌ها در صف \fBdeferred\fR، مقدار \(lq\fB\-e ALL deferred\fR\(rq را وارد کنید. به عنوان یک اقدام ایمنی، کلمهٔ \fBALL\fR باید با حروف بزرگ نوشته شود.
.sp
این قابلیت‌ها در Postfix نسخهٔ ۳.۵ و بالاتر در دسترس هستند.
.IP "\fB\-h \fIqueue_id\fR"
قرار دادن ایمیل در حالت تعلیق یا نگه‌داشته‌شده (on hold) تا تلاشی برای تحویل آن انجام نگیرد. یک پیام با شناسه صف مشخص‌شده را از صف(های) نام‌برده (پیش‌فرض: \fBincoming\fR، \fBactive\fR و \fBdeferred\fR) به صف \fBhold\fR منتقل می‌کند.

برای نگه‌داشتن چندین فایل، گزینهٔ \fB\-h\fR را چندین بار مشخص کنید، یا برای خواندن شناسه‌های صف از ورودی استاندارد، مقدار \fIqueue_id\fR را \fB\-\fR قرار دهید.
.sp
برای نگه‌داشتن همهٔ پیام‌ها عبارت \(lq\fB\-h ALL\fR\(rq را مشخص کنید؛ برای نمونه عبارت \(lq\fB\-h ALL deferred\fR\(rq را برای معلق کردن تمام نامه‌های صف \fBdeferred\fR به کار ببرید. به عنوان یک تدبیر ایمنی، کلمهٔ \fBALL\fR باید با حروف بزرگ درج شود.
.sp
نکته: تا زمانی که ایمیل در حالت \(lqon hold\(rq قرار دارد، با گذشت مدت‌زمان حضور آن در صف از حد تعیین‌شده در \fBmaximal_queue_lifetime\fR یا \fBbounce_queue_lifetime\fR منقضی نخواهد شد. این پیام پس از رهاسازی از حالت تعلیق مشمول انقضا می‌شود.
.sp
این قابلیت در Postfix نسخهٔ ۲.۰ و بالاتر ارائه شده است.
.IP "\fB\-H \fIqueue_id\fR"
آزاد کردن نامه‌ای که در حالت تعلیق (on hold) قرار داشته است.
یک پیام با شناسه صف مشخص‌شده را از صف(های) نام‌برده (پیش‌فرض: \fBhold\fR) به صف \fBdeferred\fR منتقل می‌کند.

برای رهاسازی چندین فایل، گزینهٔ \fB\-H\fR را چندین بار مشخص کنید، یا مقدار \fIqueue_id\fR را \fB\-\fR تعیین کنید تا شناسه‌های صف از ورودی استاندارد خوانده شوند.
.sp
نکته: برای رهاسازی نامه‌ای که برای بخش قابل‌توجهی از زمان \fB$maximal_queue_lifetime\fR یا \fB$bounce_queue_lifetime\fR (یا بیشتر) در حالت تعلیق نگه داشته شده است، عبارت \(lq\fBpostsuper \-r\fR\(rq را مشخص کنید.
.sp
برای رهاسازی تمام نامه‌های معلق عبارت \(lq\fB\-H ALL\fR\(rq را تعیین کنید. به عنوان یک اقدام ایمنی، کلمهٔ \fBALL\fR باید حتماً با حروف بزرگ نوشته شود.
.sp
این قابلیت در Postfix نسخهٔ ۲.۰ و بالاتر موجود است.
.IP \fB\-p\fR
پاک‌سازی فایل‌های موقت قدیمی که پس از خرابی سیستم یا نرم‌افزار به جا مانده‌اند.
عملیات‌های \fB\-p\fR، \fB\-s\fR و \fB\-S\fR پیش از سایر عملیات انجام می‌شوند.
.IP "\fB\-r \fIqueue_id\fR"
قرار دادن دوبارهٔ پیام با شناسه صف مشخص‌شده در صف پردازش (requeue) از صف(های) نام‌برده (پیش‌فرض: \fBhold\fR، \fBincoming\fR، \fBactive\fR و \fBdeferred\fR).

برای صف‌بندی دوبارهٔ چندین فایل، گزینهٔ \fB\-r\fR را چندین بار تکرار کنید، یا برای خواندن شناسه‌های صف از ورودی استاندارد مقدار \fIqueue_id\fR را \fB\-\fR قرار دهید.
.sp
برای قرار دادن مجدد همهٔ پیام‌ها در صف، عبارت \(lq\fB\-r ALL\fR\(rq را مشخص کنید. به عنوان یک اقدام ایمنی، کلمهٔ \fBALL\fR باید با حروف بزرگ نوشته شود..sp
یک پیام دوباره صف‌بندی‌شده به صف \fBmaildrop\fR منتقل می‌شود،
جایی که توسط دیمن‌های \fBpickup\fR(8) و
\fBcleanup\fR(8) در یک فایل صف جدید رونویسی می‌شود. از
جنبه‌های بسیاری، نحوه رفتار با آن نسبت به یک ارسال محلی
جدید تفاوت دارد.
.RS
.IP \(bu
پیام مشمول تنظیمات smtpd_milters یا
non_smtpd_milters نمی‌شود. هنگامی که نامه از یک فیلتر محتوای
خارجی عبور کرده باشد، این امر نتایج نادرستی را با
برنامه‌های Milter که وابسته به اطلاعات وضعیت اتصال اولیه
SMTP هستند، تولید خواهد کرد.
.IP \(bu
پیام مجدداً مشمول بازنویسی و جایگزینی آدرس نامه
می‌شود. این مورد زمانی مفید است که قوانین بازنویسی یا
نگاشت‌های مجازی تغییر کرده باشند.
.sp
زمینه بازنویسی آدرس (محلی یا دوردست) همان زمینه‌ای است
که پیام در زمان دریافت داشته است.
.IP \(bu
پیام مشمول همان تنظیمات content_filter (در صورت وجود) می‌شود
که برای ارسال نامه‌های محلی جدید به کار می‌رود. این امر
هنگامی مفید است که تنظیمات content_filter تغییر کرده باشند.
.RE
.IP
هشدار: شناسه‌های صف Postfix دوباره استفاده می‌شوند (همواره
در Postfix <= 2.8؛ و در Postfix >= 2.9 هنگامی که enable_long_queue_ids=no باشد).
احتمال بسیار اندکی وجود دارد که \fBpostsuper\fR(1) در صورت
اجرا هنگام فعال بودن سامانه پستی Postfix، فایل پیام اشتباهی
را دوباره در صف قرار دهد، اما نباید آسیبی وارد شود.
.sp
این قابلیت در Postfix نسخه 1.1 و بالاتر موجود است.
.IP \fB\-s\fR
بررسی ساختار و تعمیر ساختار. این کار باید یک‌بار پیش از
راه‌اندازی Postfix انجام شود.
عملیات‌های \fB\-p\fR، \fB\-s\fR و \fB\-S\fR پیش از سایر
عملیات‌ها انجام می‌شوند.
.RS
.IP \(bu
تغییر نام فایل‌هایی که نام آن‌ها با شماره inode فایل پیام
مطابقت ندارد. این عملیات پس از بازیابی صف نامه از یک
ماشین دیگر یا از نسخه پشتیبان، زمانی که فایل‌های صف با
Postfix <= 2.8 یا با "enable_long_queue_ids = no" ایجاد
شده باشند، ضروری است.
.IP \(bu
انتقال فایل‌های صفی که در جای نادرستی از سلسله‌مراتب سیستم‌فایل
قرار دارند و حذف زیردایرکتوری‌هایی که دیگر به آن‌ها نیازی نیست.
چینش مجدد جایگاه فایل‌ها پس از تغییر در پارامترهای
پیکربندی \fBhash_queue_names\fR و/یا \fBhash_queue_depth\fR
ضروری است.
.IP \(bu
تغییر نام فایل‌های صف ایجاد شده با "enable_long_queue_ids =
yes" به نام‌های کوتاه، جهت مهاجرت به Postfix <= 2.8. روش
انجام به شرح زیر است:
.sp
.nf
.na
# postfix stop
# postconf enable_long_queue_ids=no
# postsuper
.ad
.fi
.sp
دستور \fBpostsuper\fR(1) را مکرراً اجرا کنید تا زمانی که گزارش
تغییر نام فایل‌ها متوقف شود.
.RE
.IP \fB\-S\fR
یک نسخه مضاعف از \fB\-s\fR که نیازمند آن است که نام‌های فایل
طولانی نیز با شماره inode فایل پیام مطابقت داشته باشند. این
گزینه برای مقاصد آزمایشی وجود دارد و در Postfix نسخه 2.9
و بالاتر در دسترس است.
عملیات‌های \fB\-p\fR، \fB\-s\fR و \fB\-S\fR پیش از سایر
عملیات‌ها انجام می‌شوند.
.IP \fB\-v\fR
فعال‌سازی ثبت گزارش مشروح برای مقاصد اشکال‌زدایی. استفاده
چندباره از گزینه \fB\-v\fR نرم‌افزار را به مراتب پرگوتر می‌کند.
.SH "خطاها (DIAGNOSTICS)"
.ad
.fi
مشکلات به جریان خطای استاندارد و به \fBsyslogd\fR(8) یا
\fBpostlogd\fR(8) گزارش می‌شوند.

دستور \fBpostsuper\fR(1) تعداد پیام‌های حذف‌شده با \fB\-d\fR،
تعداد پیام‌های منقضی‌شده با \fB\-e\fR، تعداد پیام‌های منقضی
یا رهاشده با \fB\-f\fR، تعداد پیام‌های نگه‌داشته‌شده یا
آزادشده با \fB\-h\fR یا \fB\-H\fR، تعداد پیام‌های دوباره
صف‌بندی‌شده با \fB\-r\fR و تعداد پیام‌هایی که نام فایل صف
آن‌ها با \fB\-s\fR تصحیح شده است را گزارش می‌کند. گزارش مربوطه
در جریان خطای استاندارد و در \fBsyslogd\fR(8) یا \fBpostlogd\fR(8)
نوشته می‌شود..SH "محیط (ENVIRONMENT)"
.na
.nf
.ad
.fi
.IP MAIL_CONFIG
دایرکتوری حاوی فایل \fBmain.cf\fR.
.SH "گزارش باگ‌ها (BUGS)"
.ad
.fi
ایمیل‌هایی که توسط Postfix پاک‌سازی نشده‌اند (یعنی ایمیل‌های موجود در صف \fBmaildrop\fR) را نمی‌توان در حالت «معلق» (on hold) قرار داد.
.SH "پارامترهای پیکربندی (CONFIGURATION PARAMETERS)"
.na
.nf
.ad
.fi
پارامترهای \fBmain.cf\fR زیر به‌ویژه با این برنامه مرتبط هستند.
متن زیر تنها خلاصه‌ای از پارامترها را ارائه می‌دهد. برای جزئیات
بیشتر از جمله مثال‌ها، \fBpostconf\fR(5) را ببینید.
.IP "\fBconfig_directory (خروجی 'postconf \-d' را ببینید)\fR"
مکان پیش‌فرض فایل‌های پیکربندی main.cf و master.cf در Postfix.
.IP "\fBhash_queue_depth (1)\fR"
تعداد سطوح زیردایرکتوری برای دایرکتوری‌های صف فهرست‌شده با پارامتر hash_queue_names.
.IP "\fBhash_queue_names (deferred, defer)\fR"
نام‌های دایرکتوری‌های صف که در چندین سطح زیردایرکتوری تقسیم شده‌اند.
.IP "\fBimport_environment (خروجی 'postconf \-d' را ببینید)\fR"
فهرست متغیرهای محیطی که یک فرایند دارای امتیاز Postfix از فرایند والد غیر Postfix وارد می‌کند، یا بازنویسی‌های متغیرهای محیطی به‌صورت name=value.
.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 نسخه 2.9 و بالاتر موجود است:
.IP "\fBenable_long_queue_ids (no)\fR"
فعال‌سازی شناسه‌های طولانی و غیرتکراری برای صف (نام فایل‌های صف).
.SH "همچنین ببینید (SEE ALSO)"
.na
.nf
sendmail(1)، رابط کاربری سازگار با Sendmail
postqueue(1)، عملیات صف بدون امتیاز
postlogd(8)، ثبت وقایع Postfix
syslogd(8)، ثبت وقایع سیستم
.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