'\" t
.\"
.\" Copyright (c) 2022 Ken McDonell.
.\"
.\" 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 PMDAOVERHEAD 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
\f3pmdaoverhead\f1 \- عامل دامنه معیارهای کارایی (PMDA) برای ارائه معیارهای مصرف منابع گروه‌هایی از فرآیندها
.SH "خلاصه دستور (SYNOPSIS)"
\f3$PCP_PMDAS_DIR/overhead/pmdaoverhead\f1
[\f3\-C\f1]
[\f3\-c\f1 \f2config\f1]
[\f3\-D\f1 \f2debug\f1]
[\f3\-d\f1 \f2domain\f1]
[\f3\-l\f1 \f2logfile\f1]
[\f3\-R\f1 \f2interval\f1]
.SH "توضیحات (DESCRIPTION)"
دستور
.B pmdaoverhead
یک عامل دامنه معیارهای کارایی (PMDA) قابل‌پیکربندی برای ارائه و استخراج میزان مصرف منابع برای گروه‌هایی از فرآیندهای مرتبط است.
.PP
گزینه‌های خط فرمان
.B pmdaoverhead
عبارتند از:
.TP 4
.B \-C
تجزیه فایل(های) پیکربندی و خروج پس از گزارش هرگونه خطا.
.TP
.B \-c
فایل(های) پیکربندی؛
.I config
می‌تواند یک فایل یا یک دایرکتوری باشد؛ در حالت دوم، فرض می‌شود تمام فایل‌های درون
.I config
فایل‌های پیکربندی برای
.B pmdaoverhead
هستند و همگی پردازش خواهند شد.
.RS 4
.PP
هر فایل پیکربندی با استفاده از نحو شرح‌داده‌شده در بخش «CONFIGURATION» در زیر، یک یا چند «گروه» از فرآیندهای مورد نظر را تعریف می‌کند.
.PP
به‌طور پیش‌فرض، تمام فایل‌های پیکربندی درون دایرکتوری
.I $PCP_SYSCONF_DIR/overhead/conf.d/
استفاده می‌شوند.
.RE
.TP
.B \-d
بسیار حیاتی است که شماره دامنه (
.IR domain )
معیارهای کارایی مشخص‌شده در اینجا یکتا و سازگار باشد.
بدین معنا که
.I domain
باید برای هر PMDA روی یک میزبان متفاوت باشد، و همان شماره
.I domain
باید برای همان PMDA روی تمام میزبان‌ها استفاده شود.
.TP
.B \-l
محل فایل گزارش (log). به‌طور پیش‌فرض، فایلی به نام
.I overhead.log
هنگام راه‌اندازی
.B pmdaoverhead
در دایرکتوری جاری
.BR pmcd (1)
نوشته می‌شود، یعنی
.BR $PCP_LOG_DIR/pmcd .
اگر فایل گزارش نتواند ایجاد شود یا قابل نوشتن نباشد، خروجی به‌جای آن در خطای استاندارد (standard error) نوشته می‌شود.
.TP
.B \-R
این PMDA از یک رشته (thread) جداگانه برای پویش دوره‌ای تمام فرآیندها استفاده می‌کند تا مشخص کند کدام فرآیندها در هر گروه «مورد نظر» تلقی می‌شوند، و مصرف منابع را برای آن فرآیندها استخراج کند.
آرگومان
.I interval
(بر حسب ثانیه) مشخص می‌کند که این پویش و محاسبه منابع هر چند وقت یک‌بار انجام شود؛ مقدار پیش‌فرض ۶۰ (ثانیه) است..SH "پیکربندی (CONFIGURATION)"
هر فایل پیکربندی یک یا چند «گروه» (group) از فرآیندها را تعریف می‌کند.
قالب فایل ساده است و از قواعد زیر پیروی می‌کند:
.TP 4
1.
خطوطی که با هش «#» آغاز می‌شوند به عنوان کامنت در نظر گرفته می‌شوند.
به طور کلی‌تر، به جز بند
.B pattern:
که در زیر شرح داده شده است، تمام متن بین یک هش و انتهای خط به عنوان کامنت در نظر گرفته می‌شود.
.TP
2.
فاصله‌های خالی (فاصله‌ها، تب‌ها یا خطوط جدید) برای جدا کردن اجزای واژگانی لازم هستند. در غیر این صورت، فاصله‌ها و تب‌ها نادیده گرفته می‌شوند.
به جز پایان دادن به کامنت‌ها و
.I regex
در یک بند
.BR pattern: ،
خطوط جدید نیز نادیده گرفته می‌شوند.
.TP
3.
هر گروه با یک بند
.B group
معرفی می‌شود که ساختار زیر را دارد:
.br
.ti +8n
\fBgroup\fR \fIname\fR \fB{\fR \fIparameters\fR \fB}\fR
.br
که در آن
.I name
یک نام یکتا برای گروه در میان تمام گروه‌های موجود در فایل‌های پیکربندی
.B pmdaoverhead
است.
از آن‌جا که
.I name
در فضای نام معیارهای عملکرد (PMNS) قرار می‌گیرد، باید از قوانین مربوط به اجزای نام معیار همان‌طور که در
.BR PMNS (5)
شرح داده شده است پیروی کند؛ یعنی با یک نویسه الفبایی آغاز شود و به دنبال آن صفر یا چند نویسه متشکل از حروف الفبا، اعداد و نویسه زیرخط «_» بیاید.
.TP
4.
مولفه
.I parameters
باید شامل یک بند
.B id:
و یک بند
.B pattern:
باشد.
.TP
5.
یک بند
.B id:
ساختار زیر را دارد:
.br
.ti +8n
\fBid:\fR \fIident\fR
.br
که در آن
.I ident
یک شماره شناسه یکتا برای گروه در میان تمام گروه‌های فایل‌های پیکربندی
.B pmdaoverhead
است.
مقادیر معتبر برای
.I ident
در بازه 0 تا 4094 (شامل هر دو) هستند.
.TP
6.
یک بند
.B pattern:
ساختار زیر را دارد:
.br
.ti +8n
\fBpattern:\fR \fIregex\fR
.br
که در آن
.I regex
یک ساختار عبارت باقاعده گسترش‌یافته به سبک
.BR egrep (1)
است.
مقدار
.I regex
از نخستین نویسه غیرفاصله پس از
.B pattern:
آغاز شده و تا خط جدید بعدی امتداد می‌یابد.
.RS 4
.PP
فرآیندهایی که به عنوان اعضای گروه در نظر گرفته می‌شوند مواردی هستند که نام دستور آن‌ها، همان‌طور که توسط
.br
.ti +8n
.ft CR
$ pminfo -f proc.psinfo.cmd
.br
.ft
گزارش می‌شود، با
.I regex
تطبیق داشته باشد،
.B به‌علاوه
تمام نوادگان آن فرآیندها.
بنابراین برای مثال، مقدار
.I regex
به صورت
.B ^pmcd$
با
.BR pmcd (1)
و تمام فرآیندهای PMDA اجرا شده توسط
.BR pmcd (1)
و هر یک از فرزندان آن‌ها و غیره مطابقت خواهد داشت.
.RE.SH "نصب (INSTALLATION)"
اگر می‌خواهید به نام‌ها، متن راهنما و مقادیر معیارهای کارایی overhead دسترسی داشته باشید، دستورات زیر را به عنوان ریشه (root) انجام دهید:
.PP
.ft CR
.nf
.in +0.5i
# cd $PCP_PMDAS_DIR/overhead
# ./Install
.in
.fi
.ft 1
.PP
اگر می‌خواهید نصب را لغو کنید، دستورات زیر را به عنوان ریشه انجام دهید:
.PP
.ft CR
.nf
.in +0.5i
# cd $PCP_PMDAS_DIR/overhead
# ./Remove
.in
.fi
.ft 1
.PP
برنامهٔ
.B pmdaoverhead
توسط
.B pmcd
راه‌اندازی می‌شود و هرگز نباید به‌طور مستقیم اجرا گردد.
اسکریپت‌های Install و Remove هنگامی که عامل نصب یا حذف می‌شود، به
.B pmcd
اطلاع می‌دهند.
.SH "فایل‌ها (FILES)"
.PD 0
.TP 10
.B $PCP_PMCDCONF_PATH
گزینه‌های خط فرمان مورد استفاده برای راه‌اندازی
.B pmdaoverhead
.TP 10
.B $PCP_PMDAS_DIR/overhead/Install
اسکریپت نصب برای عامل
.B pmdaoverhead
.TP 10
.B $PCP_PMDAS_DIR/overhead/Remove
اسکریپت حذف نصب برای عامل
.B pmdaoverhead
.TP 10
.B $PCP_LOG_DIR/pmcd/overhead.log
فایل گزارش (log) پیش‌فرض برای پیام‌های خطا و سایر اطلاعات از سوی
.B pmdaoverhead
.TP 10
.B $PCP_SYSCONF_DIR/overhead/conf.d
دایرکتوری حاوی فایل‌های پیکربندی برای معیارهای overhead
.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
برای دریافت فهرستی از گزینه‌های اشکال‌زدایی موجود و معانی آن‌ها استفاده کنید.
.PP
گزینه‌های اشکال‌زدایی مختص به
.B pmdaoverhead
عبارتند از:
.TS
box;
lf(B) | lf(B)
lf(B) | lf(R) .
گزینه	توضیحات
_
appl0	تجزیهٔ \fIconfigfile\fP
_
appl1	برچسب‌های زمانی شروع\-پایان ()refresh
_
appl2	انتخاب /proc در ()refresh
.TE.SH "همچنین ببینید (SEE ALSO)"
.BR PCPIntro (1)،
.BR pmcd (1)،
.BR pmdaproc (1)،
.BR pcp.conf (5)،
.BR pcp.env (5)
و
.BR PMNS (5).

.\" control lines for scripts/man-spell
.\" +ok+ cmd ident psinfo