'\"macro stdmacro
.TH PMDASUMMARY 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
pmdasummary \- عامل دامنه معیارهای کارایی خلاصه (PMDA)
.SH "خلاصه دستور (SYNOPSIS)"
\f3$PCP_PMDAS_DIR/summary/pmdasummary\f1
[\f3\-D\f1 \f2debug\f1]
[\f3\-d\f1 \f2domain\f1]
[\f3\-h\f1 \f2helpfile\f1]
[\f3\-l\f1 \f2logfile\f1]
[\f3\-U\f1 \f2username\f1]
\f2pmie-command-line\f1
.SH "توضیحات (DESCRIPTION)"
.B pmdasummary
یک عامل دامنه معیارهای کارایی (PMDA) است که مقادیر معیارهای کارایی را از مقادیر ارائه‌شده توسط سایر PMDAها استخراج می‌کند.
.B pmdasummary
از دو فرایند تشکیل شده است:
.TP
.B فرایند pmie
موتور استنتاج مقادیر کارایی،
.BR pmie (1)
برای نمونه‌برداری دوره‌ای از مقادیر معیارهای پایه و محاسبه مقادیر مشتق‌شده استفاده می‌شود.
این فرایند با آرگومان‌های داده‌شده در \f2pmie-command-line\f1 توسط فرایند اصلی (که در ادامه شرح داده شده است) اجرا می‌شود.
.TP
.B فرایند اصلی
فرایند اصلی، مقادیر محاسبه‌شده توسط
.BR pmie (1)
را خوانده و بافر می‌کند و آن‌ها را در دسترس دیمن جمع‌آوری معیارهای کارایی،
.BR pmcd (1)
قرار می‌دهد.
.PP
توضیح مختصری از گزینه‌های خط فرمان
.B pmdasummary
در ادامه آمده است:
.TP 5
.B \-d
بسیار حیاتی است که شماره دامنه (
.IR domain
) معیارهای کارایی مشخص‌شده در اینجا یکتا و سازگار باشد.
به این معنا که
.I domain
باید برای هر PMDA روی یک میزبان متفاوت باشد، و همان شماره
.I domain
باید برای همان PMDA روی تمام میزبان‌ها استفاده شود.
.TP 5
.B \-h
این گزینه یک فایل متنی راهنمای جایگزین به نام
.I helpfile
را برای توصیف معیارهایی که
.B pmdasummary
ارائه می‌دهد مشخص می‌کند.
.TP 5
.B \-l
محل فایل گزارش (لاگ). به‌طور پیش‌فرض، هنگامی که
.B pmdasummary
آغاز به کار می‌کند، یک فایل گزارش به نام
.I summary.log
در دایرکتوری جاریِ
.BR pmcd (1)
یعنی
.BR $PCP_LOG_DIR/pmcd
نوشته می‌شود. اگر فایل گزارش نتواند ایجاد شود یا قابل نوشتن نباشد، خروجی به جای آن در خطای استاندارد نوشته می‌شود.
.TP 5
.B \-U
حساب کاربری که عامل تحت آن اجرا می‌شود.
پیش‌فرض در نسخه‌های کنونی PCP حساب بدون امتیاز "pcp" است،
اما در نسخه‌های قدیمی‌تر، حساب مدیر سیستم ("root") به‌طور پیش‌فرض استفاده می‌شد.
.SH "نصب (INSTALLATION)"
اگر می‌خواهید به نام‌ها، متن راهنما و مقادیر معیارهای کارایی خلاصه دسترسی داشته باشید، مراحل زیر را به عنوان کاربر ریشه (root) انجام دهید:
.PP
.ft CR
.nf
.in +0.5i
# cd $PCP_PMDAS_DIR/summary
# ./Install
.in
.fi
.ft 1
.PP
اگر می‌خواهید نصب را لغو کنید، مراحل زیر را به عنوان کاربر ریشه (root) انجام دهید:
.PP
.ft CR
.nf
.in +0.5i
# cd $PCP_PMDAS_DIR/summary
# ./Remove
.in
.fi
.ft 1
.PP
.B pmdasummary
توسط
.BR pmcd (1)
راه‌اندازی می‌شود و هرگز نباید مستقیماً اجرا شود.
اسکریپت‌های Install و Remove به
.BR pmcd (1)
هنگام نصب یا حذف عامل اطلاع‌رسانی می‌کنند.
.SH "فایل‌ها (FILES)"
.PD 0
.TP 10
.B $PCP_PMCDCONF_PATH
گزینه‌های خط فرمان مورد استفاده برای راه‌اندازی
.B pmdasummary
.TP 10
.B $PCP_PMDAS_DIR/summary/expr.pmie
عبارت‌های پیش‌فرض
.BR pmie (1)
که معیارهای خلاصه را تعریف می‌کنند
.TP 10
.B $PCP_PMDAS_DIR/summary/help
متن راهنمای پیش‌فرض برای معیارهای خلاصه
.TP 10
.B $PCP_PMDAS_DIR/summary/Install
اسکریپت نصب برای عامل
.B pmdasummary
.TP 10
.B $PCP_PMDAS_DIR/summary/Remove
اسکریپت لغو نصب برای عامل
.B pmdasummary
.TP 10
.B $PCP_LOG_DIR/pmcd/summary.log
فایل گزارش پیش‌فرض برای پیام‌های خطا و سایر اطلاعات از
.B pmdasummary
.PD
.SH "محیط PCP (PCP ENVIRONMENT)"
متغیرهای محیطی با پیشوند
.B PCP_
برای پارامتربندی نام فایل‌ها و دایرکتوری‌های مورد استفاده توسط PCP به کار می‌روند.
در هر نصب، فایل
.B /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 pmie (1).