نام (NAME)

pmdasendmail - عامل دامنه معیارهای کارایی sendmail (PMDA)

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

$PCP_PMDAS_DIR/sendmail/pmdasendmail [-D debug] [-d domain] [-l logfile] [-U username]

توضیحات (DESCRIPTION)

pmdasendmail یک «عامل دامنه معیارهای کارایی» (PMDA) برای sendmail است که آمار ترافیک ایمیل جمع‌آوری‌شده توسط sendmail(1) را صادر می‌کند.

پیش از آنکه sendmail PMDA بتواند معیاری را صادر کند، باید جمع‌آوری آمار در sendmail(1) فعال شده باشد. این کار شامل بررسی نام فایل آمار، به همان صورتی که توسط خطوط کنترلی OS یا O StatusFile در /etc/sendmail.cf مشخص شده است، و سپس ایجاد این فایل در صورت عدم وجود آن می‌باشد. حذف این فایل موجب توقف جمع‌آوری آمار توسط sendmail(1) و در نتیجه sendmail PMDA خواهد شد.

شرح کوتاهی از گزینه‌های خط فرمان pmdasendmail در ادامه آمده است:

-d: بسیار حیاتی است که شماره domain معیارهای کارایی مشخص‌شده در اینجا یکتا و سازگار باشد. به این معنی که domain باید برای هر PMDA روی یک میزبان متفاوت باشد، و همان شماره domain باید برای همان PMDA روی تمام میزبان‌ها استفاده شود.
-l: محل فایل گزارش (log). به‌طور پیش‌فرض، هنگامی که pmdasendmail شروع به کار می‌کند، فایل گزارشی به نام sendmail.log در دایرکتوری جاری pmcd(1) نوشته می‌شود، یعنی $PCP_LOG_DIR/pmcd. اگر فایل گزارش نتواند ایجاد شود یا قابل نوشتن نباشد، خروجی در خطای استاندارد (stderr) نوشته می‌شود.
-U: حساب کاربری که عامل تحت آن اجرا می‌شود. پیش‌فرض در نسخه‌های کنونی PCP حساب بدون امتیاز "pcp" است، اما در نسخه‌های قدیمی‌تر، حساب مدیر سیستم ("root") به‌طور پیش‌فرض استفاده می‌شد.

هیچ گزینه ارتباطی وجود ندارد، زیرا اسکریپت Install اطمینان حاصل می‌کند که sendmail PMDA از طریق یک لوله (pipe) به PMCD متصل خواهد شد.

نصب (INSTALLATION)

اگر می‌خواهید به نام‌ها، متن راهنما و مقادیر معیارهای کارایی sendmail دسترسی داشته باشید، مراحل زیر را با دسترسی root انجام دهید:

# cd $PCP_PMDAS_DIR/sendmail
# ./Install

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

# cd $PCP_PMDAS_DIR/sendmail
# ./Remove

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

فایل‌ها (FILES)

$PCP_PMCDCONF_PATH: گزینه‌های خط فرمان مورد استفاده برای راه‌اندازی pmdasendmail
$PCP_PMDAS_DIR/sendmail/help: فایل متن راهنمای پیش‌فرض برای معیارهای sendmail
$PCP_PMDAS_DIR/sendmail/Install: اسکریپت نصب برای عامل pmdasendmail
$PCP_PMDAS_DIR/sendmail/Remove: اسکریپت لغو نصب برای عامل pmdasendmail
$PCP_LOG_DIR/pmcd/sendmail.log: فایل گزارش پیش‌فرض برای پیام‌های خطا و سایر اطلاعات از pmdasendmail
/etc/sendmail.cf: فایل پیکربندی sendmail برای شناسایی نام فایل آمار

محیط پی‌سی‌پی (PCP ENVIRONMENT)

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

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

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

گزینه‌های اشکال‌زدایی مخصوص pmdasendmail به شرح زیر است:

گزینه	توضیحات
appl0	اطلاعات تشخیصی پرجزئیات، به‌ویژه از map_stats()

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

PCPIntro(1)، pmcd(1) و sendmail(1).