نام (NAME)

pmdamailq - عامل دامنه معیارهای کارایی صف ایمیل (PMDA)

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

$PCP_PMDAS_DIR/mailq/pmdamailq [-b binlist] [-D debug] [-d domain] [-l logfile] [-r regex] [-U username] [queuedir]

توضیحات (DESCRIPTION)

pmdamailq یک عامل دامنه معیارهای کارایی (PMDA) است که معیارهای کارایی نشان‌دهنده وضعیت صف‌های ایمیل مدیریت‌شده توسط sendmail(1) و سایر عامل‌های انتقال ایمیل (MTA) را استخراج می‌کند.

عامل mailq معیارهایی را صادر می‌کند که تعداد کل ورودی‌های موجود در صف ایمیل، و جمع‌های جزئی مربوط به ورودی‌هایی را که برای بازه‌های زمانی گوناگون در صف مانده‌اند اندازه‌گیری می‌کند.

شرح مختصری از گزینه‌های خط فرمان pmdamailq در ادامه آمده است:

-b

آرگومان binlist فهرستی از آستانه‌های تاخیر را مشخص می‌کند که برای دسته‌بندی ورودی‌های صف در قالب یک هیستوگرام بر اساس مدت‌زمانی که ورودی در صف ایمیل بوده است استفاده می‌شود. آستانه‌های پیش‌فرض عبارتند از: ۱ ساعت، ۴ ساعت، ۸ ساعت، ۱ روز، ۳ روز و ۷ روز. ورودی‌ها در binlist بازه‌های زمانی جداشده با کاما هستند که از نحو توصیف‌شده در PCPIntro(1) برای بازه به‌روزرسانی یا گزارش‌دهی استفاده می‌کنند، برای نمونه فهرست پیش‌فرض را می‌توان با مقدار 1hr,4hrs,8hrs,1day,3days,7days مشخص کرد.

-d

بسیار حیاتی است که شماره domain (دامنه) معیارهای کارایی مشخص‌شده در اینجا یکتا و سازگار باشد. به این معنا که domain باید برای هر PMDA روی یک میزبان متفاوت باشد، و همان شماره domain باید برای همان PMDA روی تمام میزبان‌ها به کار رود.

-l

محل فایل گزارش (لاگ). به صورت پیش‌فرض، یک فایل گزارش به نام mailq.log در دایرکتوری جاری pmcd(1) هنگام شروع به کار pmdamailq نوشته می‌شود، یعنی $PCP_LOG_DIR/pmcd . اگر فایل گزارش نتواند ایجاد شود یا قابل نوشتن نباشد، خروجی به جای آن در خطای استاندارد نوشته می‌شود.

-r

استفاده از یک عبارت باقاعده گسترده (ERE) برای تطبیق نام فایل‌ها در دایرکتوری صف ایمیل، به جای اینکه فرض شود تمام فایل‌های دارای پیشوند "df" در دایرکتوری فایل‌های ایمیل هستند (پیشوند "df" قرارداد sendmail است، اما این قرارداد توسط سایر دیمن‌های ایمیل دنبال نمی‌شود). الگوی regex مشخص‌شده باید با فرمت POSIX توصیف‌شده در regex(3) مطابقت داشته باشد، و نام فایل‌هایی را توصیف می‌کند که باید به عنوان ایمیل در نظر گرفته شوند.

-U

حساب کاربری که عامل تحت آن اجرا می‌شود. پیش‌فرض در نسخه‌های کنونی PCP حساب کاربری غیرممتاز "pcp" است، اما در نسخه‌های قدیمی‌تر، حساب مدیر سیستم ("root") به صورت پیش‌فرض استفاده می‌شد.

آرگومان اختیاری queuedir دایرکتوری‌ای را تعریف می‌کند که pmdamailq انتظار دارد صف ایمیل را در آن بیابد. پیش‌فرض /var/spool/mqueue است.

نصب (INSTALLATION)

اگر دسترسی به نام‌ها، متن راهنما و مقادیر معیارهای کارایی mailq را می‌خواهید، دستورات زیر را با دسترسی ریشه (root) انجام دهید:

# cd $PCP_PMDAS_DIR/mailq
# ./Install

اگر می‌خواهید فرآیند نصب را لغو (حذف) کنید، دستورات زیر را با دسترسی ریشه (root) انجام دهید:

# cd $PCP_PMDAS_DIR/mailq
# ./Remove

pmdamailq توسط pmcd(1) راه‌اندازی می‌شود و هرگز نباید به صورت مستقیم اجرا گردد. اسکریپت‌های Install و Remove هنگام نصب یا حذف عامل، به pmcd(1) اطلاع‌رسانی می‌کنند.

فایل‌ها (FILES)

$PCP_PMCDCONF_PATH

گزینه‌های خط فرمان مورد استفاده برای راه‌اندازی pmdamailq

$PCP_PMDAS_DIR/mailq/help

فایل متنی راهنمای پیش‌فرض برای معیارهای mailq

$PCP_PMDAS_DIR/mailq/Install

اسکریپت نصب برای عامل pmdamailq

$PCP_PMDAS_DIR/mailq/Remove

اسکریپت لغو نصب برای عامل pmdamailq

$PCP_LOG_DIR/pmcd/mailq.log

فایل گزارش پیش‌فرض برای پیام‌های خطا و سایر اطلاعات حاصل از pmdamailq

محیط PCP (PCP ENVIRONMENT)

متغیرهای محیطی با پیشوند PCP_ برای پارامتریزه کردن نام فایل‌ها و دایرکتوری‌های مورد استفاده توسط PCP به کار می‌روند. در هر نصب، فایل /etc/pcp.conf شامل مقادیر محلی برای این متغیرها است. متغیر $PCP_CONF ممکن است برای مشخص کردن یک فایل پیکربندی جایگزین استفاده شود، همان‌طور که در pcp.conf(5) شرح داده شده است.

گزینه‌های اشکال‌زدایی (DEBUGGING OPTIONS)

گزینه -D یا --debug خروجی اطلاعات تشخیصی اضافی را در stderr فعال می‌کند تا به عیب‌یابی مشکلات کمک کند، اگرچه این اطلاعات گاهی مبهم است و عمدتاً برای راهنمایی توسعه‌دهندگان در نظر گرفته شده است تا کاربران نهایی. debug یک فهرست جداشده با کاما از گزینه‌های اشکال‌زدایی است؛ از pmdbg(1) همراه با گزینه -l برای دریافت فهرستی از گزینه‌های اشکال‌زدایی در دسترس و معانی آن‌ها استفاده کنید.

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

PCPIntro(1), pmcd(1), pcp.conf(5) و pcp.env(5).