.TH QSHAPE 1 
.ad
.fi
.SH "نام (NAME)"
qshape \- چاپ توزیع سنی و دامنه‌ای صف Postfix
.SH "خلاصه دستور (SYNOPSIS)"
.na
.nf
.fi
\fBqshape\fR [\fB\-s\fR] [\fB\-p\fR] [\fB\-m \fImin_subdomains\fR]
        [\fB\-b \fIbucket_count\fR] [\fB\-t \fIbucket_time\fR]
        [\fB\-l\fR] [\fB\-w \fIterminal_width\fR]
        [\fB\-N \fIbatch_msg_count\fR] [\fB\-n \fIbatch_top_domains\fR]
        [\fB\-c \fIconfig_directory\fR] [\fIqueue_name\fR ...]
.SH "توضیحات (DESCRIPTION)"
.ad
.fi
برنامهٔ \fBqshape\fR به مدیر سیستم کمک می‌کند تا توزیع زمانی پیام‌های صف
Postfix را بر اساس دامنهٔ فرستنده یا گیرنده بررسی کند. این برنامه نیازمند
دسترسی خواندن به دایرکتوری‌ها و فایل‌های صف است، بنابراین باید توسط کاربر
ریشه (superuser) یا کاربری که در مشخصهٔ \fBmail_owner\fR در \fBmain.cf\fR
تعیین شده (معمولاً \fBpostfix\fR) اجرا شود.

گزینه‌ها:
.IP \fB\-s\fR
نمایش توزیع بر اساس دامنهٔ فرستنده به‌جای دامنهٔ گیرنده. به‌طور پیش‌فرض،
توزیع گیرندگان نمایش داده می‌شود. از آنجا که یک پیام می‌تواند چندین گیرنده
داشته باشد اما فقط یک فرستنده دارد، توزیع فرستنده نمایانگر توزیع واقعی پیام‌هاست.
.IP \fB\-p\fR
تولید آمار تجمیعی برای دامنه‌های والد. دامنه‌های سطح‌بالا (TLD) و همچنین
دامنه‌هایی با کمتر از \fImin_subdomains\fR زیردامنه نمایش داده نمی‌شوند.
نام دامنه‌های والد با یک نقطه در ابتدا نشان داده می‌شوند (مانند \fI.example.com\fR).
.IP "\fB\-m \fImin_subdomains\fR"
هنگام استفاده همراه با گزینهٔ \fB\-p\fR، حداقل تعداد زیردامنه‌های لازم برای نمایش
یک خط جداگانه برای دامنهٔ والد را تعیین می‌کند. مقدار پیش‌فرض ۵ است.
.IP "\fB\-b \fIbucket_count\fR"
توزیع سنی پیام‌ها به دنباله‌ای از بازه‌های زمانی با رشد هندسی تقسیم می‌شود.
این گزینه تعداد بازه‌ها یا «bucket»ها را تعیین می‌کند. حداکثر سن صف در هر بازه
دو برابر بازهٔ قبلی است. آخرین بازه محدودیت سنی ندارد.
.IP "\fB\-t \fIbucket_time\fR"
محدودیت سنی بر حسب دقیقه برای اولین بازهٔ زمانی. مقدار پیش‌فرض ۵ است؛
بدین معنا که بازهٔ اول، پیام‌های با سن بین ۰ تا ۵ دقیقه را شمارش می‌کند.
.IP "\fB\-l\fR"
استفاده از دنبالهٔ زمانی خطی به‌جای دنبالهٔ هندسی؛ به عبارت دیگر مضارب
ساده‌ای از \fBbucket_time\fR.

این قابلیت در Postfix نسخهٔ 2.2 و بالاتر در دسترس است.
.IP "\fB\-w \fIterminal_width\fR"
خروجی راست‌چین می‌شود و شمارنده‌های آخرین بازه در ستون ۸۰ نمایش می‌یابند.
مقدار \fIterminal_width\fR را می‌توان برای نمایشگرهای عریض‌تر تنظیم کرد تا بازه‌های
بیشتری بدون بریده شدن نام دامنه‌ها در سمت چپ نشان داده شوند. هنگامی که یک
ردیف برای نام کامل دامنه و شمارنده‌های آن در تعداد ستون‌های مشخص‌شده جا نشود،
تنها ۱۷ بایت پایانی نام دامنه با جایگزینی پیشوند آن با نویسهٔ «+» نمایش
داده می‌شود. ردیف‌های بریده‌شدهٔ دامنهٔ والد به‌صورت «.+» به همراه ۱۶ بایت پایانی
نام دامنه نشان داده می‌شوند. اگر فضا باز هم برای نمایش نام دامنه و تمام
شمارنده‌ها بسیار کم باشد، از محدودیت terminal_width فراتر رفته خواهد شد.
.IP "\fB\-N \fIbatch_msg_count\fR"
هنگامی که دستگاه خروجی ترمینال باشد، نتایج میانی پس از پردازش هر
«batch_msg_count» پیام به نمایش درمی‌آیند. این ویژگی باعث می‌شود حتی در صورت
بزرگ بودن صف deferred، نتایج در زمانی معقول و قابل استفاده ارائه شوند. حالت
پیش‌فرض، نمایش نتایج میانی به ازای هر ۱۰۰۰ پیام است.
.IP "\fB\-n \fIbatch_top_domains\fR"
هنگام گزارش نتایج میانی یا نهایی در یک ترمینال، تنها برترین دامنه‌ها را
به تعداد «batch_top_domains» گزارش می‌کند. حد پیش‌فرض ۲۰ دامنه است.
.IP "\fB\-c \fIconfig_directory\fR"
فایل پیکربندی \fBmain.cf\fR به‌جای دایرکتوری پیش‌فرض، در دایرکتوری
مشخص‌شده قرار دارد.
.PP
آرگومان‌ها:
.IP \fIqueue_name\fR
به‌طور پیش‌فرض، \fBqshape\fR توزیع ترکیبی صف‌های incoming و active را نمایش
می‌دهد. برای نمایش مجموعه‌ای متفاوت از صف‌ها، کافی است نام دایرکتوری‌های
آن‌ها را در خط فرمان درج کنید. مسیرهای مطلق همان‌طور که هستند استفاده
می‌شوند، و سایر مسیرها نسبت به مقدار پارامتر \fBqueue_directory\fR در
\fBmain.cf\fR در نظر گرفته می‌شوند. اگرچه \fBmain.cf\fR از گسترش متغیرها
(\fI$variable\fR expansion) در تعریف پارامتر \fBqueue_directory\fR پشتیبانی می‌کند،
برنامهٔ \fBqshape\fR این قابلیت را ندارد. اگر ناچار به استفاده از متغیرها در تنظیمات
\fBqueue_directory\fR هستید، باید برای هر زیردایرکتوری صف یک مسیر مطلق و
صریح تعیین کنید، حتی اگر توزیع پیش‌فرض صف‌های incoming و active را بخواهید.
.SH "همچنین ببینید (SEE ALSO)"
.na
.nf
mailq(1), فهرست کردن تمامی پیام‌های موجود در صف.
QSHAPE_README مثال‌ها و توضیحات تکمیلی.
.SH "فایل‌ها (FILES)"
.na
.nf
$config_directory/main.cf, پارامترهای پیکربندی Postfix.
$queue_directory/maildrop/, دایرکتوری ارسال محلی پیام.
$queue_directory/incoming/, صف پیام‌های جدید.
$queue_directory/hold/, پیام‌های معلق در انتظار بررسی پشتیبانی فنی.
$queue_directory/active/, پیام‌های زمان‌بندی‌شده برای تحویل.
$queue_directory/deferred/, پیام‌های موکول‌شده به تحویل در زمان بعد.
.SH "مجوز (LICENSE)"
.na
.nf
.ad
.fi
مجوز Secure Mailer باید همراه با این نرم‌افزار توزیع شود.
.SH "نویسندگان (AUTHORS)"
.na
.nf
Victor Duchovni
Morgan Stanley