'\"macro stdmacro
.\"
.\" Copyright (c) 2012 Red Hat.
.\" Copyright (c) 2000 Silicon Graphics, Inc.  All Rights Reserved.
.\"
.\" This program is free software; you can redistribute it and/or modify it
.\" under the terms of the GNU General Public License as published by the
.\" Free Software Foundation; either version 2 of the License, or (at your
.\" option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful, but
.\" WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
.\" or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
.\" for more details.
.\"
.\"
.TH PMDAMAILQ 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
pmdamailq \- عامل دامنه معیارهای کارایی صف ایمیل (PMDA)
.SH "خلاصه دستور (SYNOPSIS)"
\f3$PCP_PMDAS_DIR/mailq/pmdamailq\f1
[\f3\-b\f1 \f2binlist\f1]
[\f3\-D\f1 \f2debug\f1]
[\f3\-d\f1 \f2domain\f1]
[\f3\-l\f1 \f2logfile\f1]
[\f3\-r\f1 \f2regex\f1]
[\f3\-U\f1 \f2username\f1]
[\f2queuedir\f1]
.SH "توضیحات (DESCRIPTION)"
.B pmdamailq
یک عامل دامنه معیارهای کارایی (PMDA) است که معیارهای کارایی نشان‌دهنده وضعیت صف‌های ایمیل مدیریت‌شده توسط
.BR sendmail (1)
و سایر عامل‌های انتقال ایمیل (MTA) را استخراج می‌کند.
.PP
عامل
.B mailq
معیارهایی را صادر می‌کند که تعداد کل ورودی‌های موجود در صف ایمیل، و جمع‌های جزئی مربوط به ورودی‌هایی را که برای بازه‌های زمانی گوناگون در صف مانده‌اند اندازه‌گیری می‌کند.
.PP
شرح مختصری از گزینه‌های خط فرمان
.B pmdamailq
در ادامه آمده است:
.TP 5
.B \-b
آرگومان
.I binlist
فهرستی از آستانه‌های تاخیر را مشخص می‌کند که برای دسته‌بندی ورودی‌های صف در قالب یک هیستوگرام بر اساس مدت‌زمانی که ورودی در صف ایمیل بوده است استفاده می‌شود.
آستانه‌های پیش‌فرض عبارتند از:
۱ ساعت، ۴ ساعت، ۸ ساعت، ۱ روز، ۳ روز و ۷ روز.
ورودی‌ها در
.I binlist
بازه‌های زمانی جداشده با کاما هستند که از نحو توصیف‌شده در
.BR PCPIntro (1)
برای بازه به‌روزرسانی یا گزارش‌دهی استفاده می‌کنند، برای نمونه فهرست پیش‌فرض را می‌توان با مقدار
.BR "1hr,4hrs,8hrs,1day,3days,7days"
مشخص کرد.
.RS
.PP
فرض می‌شود مقادیر در
.I binlist
به ترتیب صعودی باشند، و موارد ایمیل موجود در صف که کمتر از نخستین آستانه در صف مانده‌اند در یک دسته ویژه با برچسب «recent» قرار می‌گیرند.
.RE
.TP
.B \-d
بسیار حیاتی است که شماره
.I domain
(دامنه) معیارهای کارایی مشخص‌شده در اینجا یکتا و سازگار باشد.
به این معنا که
.I domain
باید برای هر PMDA روی یک میزبان متفاوت باشد، و همان شماره
.I domain
باید برای همان PMDA روی تمام میزبان‌ها به کار رود.
.TP
.B \-l
محل فایل گزارش (لاگ). به صورت پیش‌فرض، یک فایل گزارش به نام
.I mailq.log
در دایرکتوری جاری
.BR pmcd (1)
هنگام شروع به کار
.B pmdamailq
نوشته می‌شود، یعنی
.B $PCP_LOG_DIR/pmcd .
اگر فایل گزارش نتواند ایجاد شود یا قابل نوشتن نباشد، خروجی به جای آن در خطای استاندارد نوشته می‌شود.
.TP
.B \-r
استفاده از یک عبارت باقاعده گسترده (ERE) برای تطبیق نام فایل‌ها در دایرکتوری صف ایمیل، به جای اینکه فرض شود تمام فایل‌های دارای پیشوند "df" در دایرکتوری فایل‌های ایمیل هستند (پیشوند "df" قرارداد
.B sendmail
است، اما این قرارداد توسط سایر دیمن‌های ایمیل دنبال نمی‌شود).
الگوی
.I regex
مشخص‌شده باید با فرمت POSIX توصیف‌شده در
.BR regex (3)
مطابقت داشته باشد، و نام فایل‌هایی را توصیف می‌کند که باید به عنوان ایمیل در نظر گرفته شوند.
.TP 5
.B \-U
حساب کاربری که عامل تحت آن اجرا می‌شود.
پیش‌فرض در نسخه‌های کنونی PCP حساب کاربری غیرممتاز "pcp" است، اما در نسخه‌های قدیمی‌تر، حساب مدیر سیستم ("root") به صورت پیش‌فرض استفاده می‌شد.
.PP
آرگومان اختیاری
.I queuedir
دایرکتوری‌ای را تعریف می‌کند که
.B pmdamailq
انتظار دارد صف ایمیل را در آن بیابد.
پیش‌فرض
.BR /var/spool/mqueue
است.
.SH "نصب (INSTALLATION)"
اگر دسترسی به نام‌ها، متن راهنما و مقادیر معیارهای کارایی mailq را می‌خواهید، دستورات زیر را با دسترسی ریشه (root) انجام دهید:
.PP
.ft CR
.nf
.in +0.5i
# cd $PCP_PMDAS_DIR/mailq
# ./Install
.in
.fi
.ft 1
.PP
اگر می‌خواهید فرآیند نصب را لغو (حذف) کنید، دستورات زیر را با دسترسی ریشه (root) انجام دهید:
.PP
.ft CR
.nf
.in +0.5i
# cd $PCP_PMDAS_DIR/mailq
# ./Remove
.in
.fi
.ft 1
.PP
.B pmdamailq
توسط
.BR pmcd (1)
راه‌اندازی می‌شود و هرگز نباید به صورت مستقیم اجرا گردد.
اسکریپت‌های Install و Remove هنگام نصب یا حذف عامل، به
.BR pmcd (1)
اطلاع‌رسانی می‌کنند.
.SH "فایل‌ها (FILES)"
.PD 0
.TP 10
.B $PCP_PMCDCONF_PATH
گزینه‌های خط فرمان مورد استفاده برای راه‌اندازی
.B pmdamailq
.TP 10
.B $PCP_PMDAS_DIR/mailq/help
فایل متنی راهنمای پیش‌فرض برای معیارهای mailq
.TP 10
.B $PCP_PMDAS_DIR/mailq/Install
اسکریپت نصب برای عامل
.B pmdamailq
.TP 10
.B $PCP_PMDAS_DIR/mailq/Remove
اسکریپت لغو نصب برای عامل
.B pmdamailq
.TP 10
.B $PCP_LOG_DIR/pmcd/mailq.log
فایل گزارش پیش‌فرض برای پیام‌های خطا و سایر اطلاعات حاصل از
.B pmdamailq
.PD
.SH "محیط PCP (PCP ENVIRONMENT)"
متغیرهای محیطی با پیشوند
.B PCP_
برای پارامتریزه کردن نام فایل‌ها و دایرکتوری‌های مورد استفاده توسط PCP به کار می‌روند.
در هر نصب، فایل
.I /etc/pcp.conf
شامل مقادیر محلی برای این متغیرها است.
متغیر
.B $PCP_CONF
ممکن است برای مشخص کردن یک فایل پیکربندی جایگزین استفاده شود، همان‌طور که در
.BR pcp.conf (5)
شرح داده شده است.
.SH "گزینه‌های اشکال‌زدایی (DEBUGGING OPTIONS)"
گزینه
.B \-D
یا
.B \-\-debug
خروجی اطلاعات تشخیصی اضافی را در
.I stderr
فعال می‌کند تا به عیب‌یابی مشکلات کمک کند، اگرچه این اطلاعات گاهی مبهم است و
عمدتاً برای راهنمایی توسعه‌دهندگان در نظر گرفته شده است تا کاربران نهایی.
.I debug
یک فهرست جداشده با کاما از گزینه‌های اشکال‌زدایی است؛ از
.BR pmdbg (1)
همراه با گزینه
.B \-l
برای دریافت فهرستی از گزینه‌های اشکال‌زدایی در دسترس و معانی آن‌ها استفاده کنید.
.SH "همچنین ببینید (SEE ALSO)"
.BR PCPIntro (1),
.BR pmcd (1),
.BR pcp.conf (5)
و
.BR pcp.env (5).

.\" control lines for scripts/man-spell
.\" +ok+ df {from sendmail filename prefix} mailq mqueue