'\" t
.\"
.\" Copyright (c) 2014-2017 Red Hat.
.\" Copyright (c) 2015 Martins Innus.  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 PMDAPROC 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
\f3pmdaproc\f1 \- عامل دامنهٔ معیارهای کارایی فرایند (PMDA)
.SH "خلاصه دستور (SYNOPSIS)"
\f3$PCP_PMDAS_DIR/proc/pmdaproc\f1
[\f3\-AL\f1]
[\f3\-D\f1 \f2debug\f1]
[\f3\-d\f1 \f2domain\f1]
[\f3\-l\f1 \f2logfile\f1]
[\f3\-r\f1 \f2cgroup\f1]
[\f3\-U\f1 \f2username\f1]
.SH "توضیحات (DESCRIPTION)"
دستور
.B pmdaproc
یک «عامل دامنهٔ معیارهای کارایی» (PMDA) است که معیارهای عملکردیِ توصیف‌کنندهٔ وضعیت تک‌تک فرایندهای در حال اجرا روی یک سیستم لینوکس را استخراج می‌کند.
.PP
عامل
.B proc
PMDA معیارهایی را ارائه می‌دهد که میزان مصرف حافظه، پردازنده و سایر منابع هر فرایند را به همراه اطلاعات خلاصه‌ای از تمام فرایندهای در حال اجرا اندازه‌گیری می‌کنند.
این موارد شامل خلاصه‌های جانمایی NUMA برای هر فرایند از
.I /proc/<pid>/numa_maps
از طریق معیارهای
.BR proc.numa_maps.*\  است.
این PMDA از مشخصات هویتی (credentials) ارسال‌شده از سوی ابزار نظارتی
.BR PMAPI (3)
که مشخص‌کنندهٔ کاربر درخواست‌کنندهٔ اطلاعات است استفاده می‌کند تا اطمینان حاصل شود تنها مقادیری که کاربر مجاز به دسترسی به آن‌ها است بازگردانده می‌شوند.
این فرایند مستلزم آن است که PMDA در طول مدت رسیدگی به درخواست‌ها برای نمونه‌ها (instances) و مقادیر، شناسه‌های کاربر و گروه مؤثر (effective UID/GID) خود را به‌طور موقت تغییر دهد.
به عبارت دیگر، فراخوان‌های سیستمی برای استخراج اطلاعات، از جانب همان کاربری که درخواست را ایجاد کرده انجام می‌شوند و نه به عنوان یک کاربر ممتاز.
سازوکارهای موجود برای انتقال مشخصات هویتی کاربر در صفحهٔ
.BR PCPIntro (1)
بیشتر توضیح داده شده‌اند.
.PP
شرح مختصری از گزینه‌های خط فرمان
.B pmdaproc
در ادامه آمده است:
.TP 5
.B \-A
استفاده از مشخصات هویتی ارائه‌شده توسط ابزارهای کلاینت
.B PMAPI
را غیرفعال کرده و صرفاً همه‌چیز را تحت حساب «root» اجرا می‌کند.
برای کنترل دقیق‌تر هنگام استفاده از
.BR pmcd (1)
همراه با احراز هویت کلاینت‌های راه دور، به بخش ACCESS CONFIGURATION در ادامه مراجعه کنید.
تنها زمانی این گزینه را فعال کنید که خطرات مربوطه را درک کرده باشید و مطمئن باشید که تمامی دسترسی‌های راه دور از سوی کاربران مطمئن انجام می‌گیرد.
در صورت فعال بودن، کلاینت‌های راه دورِ احراز هویت‌نشدهٔ
.B PMAPI
قادر خواهند بود به مقادیر معیارهای کارایی بالقوه حساسی دسترسی یابند که معمولاً یک کلاینت احراز هویت‌نشدهٔ
.B PMAPI
اجازهٔ دسترسی به آن‌ها را ندارد.
برای جزئیات بیشتر به CVE-2011-2495 و CVE-2012-3419 مراجعه کنید.
.TP
.B \-L
دامنهٔ نمونه‌های (instance domain) مربوط به هر فرایند را که توسط اکثر معیارهای
.B pmdaproc
استفاده می‌شود، به‌گونه‌ای تغییر می‌دهد که رشته‌ها (threads) را نیز شامل شود.
.TP
.B \-d
بسیار حیاتی است که شمارهٔ
.I domain
(دامنه) معیارهای کاراییِ مشخص‌شده در اینجا، یکتا و سازگار باشد.
بدین معنا که
.I domain
باید برای هر PMDA در یک میزبان متفاوت باشد، و از همان شمارهٔ
.I domain
باید برای همان PMDA در تمامی میزبان‌ها استفاده شود.
.TP
.B \-l
محل فایل گزارش (log file). به‌طور پیش‌فرض، هنگامی که
.B pmdaproc
راه‌اندازی می‌شود، یک فایل گزارش به نام
.I proc.log
در دایرکتوری جاریِ
.BR pmcd (1)
نوشته می‌شود، یعنی
.BR $PCP_LOG_DIR/pmcd .
اگر ایجاد فایل گزارش ممکن نباشد یا قابل نوشتن نباشد، خروجی در خروجی خطای استاندارد نوشته می‌شود.
.TP
.B \-r
مجموعه فرایندهای ارائه‌شده در دامنهٔ نمونه‌های هر فرایند را تنها به فرایندهایی محدود می‌کند که در ظرف منبع
.IR cgroup
مشخص‌شده قرار دارند.
این گزینه دقت نظارت اختیاری دقیق‌تری فراهم می‌کند و همچنین می‌تواند برای کاهش منابع مصرفی توسط
.I pmdaproc
در حین درخواست‌ها برای نمونه‌ها و مقادیر به کار رود.
.TP
.B \-U
حساب کاربری که عامل باید تحت آن اجرا شود.
پیش‌فرض، حساب کاربری ممتاز «root» است که با جابه‌جایی‌های
seteuid (2)
و
setegid (2)
برای دسترسی به بیشتر اطلاعات همراه است..SH "نمای کلی HOTPROC (HOTPROC OVERVIEW)"
عامل دامنه معیارهای کارایی (PMDA) با نام
.B pmdaproc
شامل مجموعه‌ای اضافی از معیارهای به ازای هر فرایند است که دامنه نمونه‌های آن به مجموعه‌ای از فرایندهای «مورد توجه» یا «داغ» (hot) محدود شده است.
برخلاف معیارهای پیش‌فرض ارائه‌شده توسط
.B proc
PMDA، که دامنه نمونه‌ای برابر با تمام فرایندهای جاری دارند، معیارهای
.B hot
دارای دامنه نمونه‌ای هستند که زیرمجموعه‌ای از این مجموعه است.
این دامنه نمونه‌های
.B hotproc
توسط یک گزاره (predicate) قابل‌پیکربندی تعیین می‌شود که در طول فواصل زمانی تازه‌سازی ارزیابی می‌گردد.
.P
علاوه بر معیارهای معادل به ازای هر فرایند در
.BR proc ،
ابزار
.B hotproc
یک معیار \f3cpuburn\f1 ارائه می‌دهد که میزان استفاده فرایند از پردازنده را در طول بازه زمانی تازه‌سازی مشخص می‌کند، معیارهای \f3total\f1 که نشان می‌دهند فرایندهای «مورد توجه» چه مقدار از زمان در دسترس پردازنده را به خود اختصاص داده‌اند، معیارهای \f3predicate\f1 که مقادیر متغیرهای رزروشده (به زیر مراجعه کنید) را که در گزاره hotproc استفاده می‌شوند نشان می‌دهند، و معیارهای \f3control\f1 برای کنترل عامل.
.SH "پیکربندی HOTPROC (HOTPROC CONFIGURATION)"
فایل پیکربندی شامل یک گزاره است که برای تعیین قرارگیری یا عدم قرارگیری یک فرایند در مجموعه فرایندهای مورد توجه استفاده می‌شود.
.PP
یک فایل پیکربندی نمونه را می‌توان در
.B $PCP_PMDAS_DIR/proc/samplehotproc.conf
یافت.
.PP
این فایل می‌تواند پس از اعمال هرگونه تغییرات به
.B $PCP_PMDAS_DIR/proc/hotproc.conf
کپی شود تا معیارهای
.B hot
را پیکربندی کند. رابط‌های
.BR pmstore (1)
و
.BR pmStore (3)
نیز می‌توانند استفاده شوند (در زیر شرح داده شده است).
.PP
این گزاره با استفاده از زبان مشخص‌شده در زیر توصیف می‌شود. نمادها بر اساس موارد مورد استفاده در زبان‌های
.BR C (1)
و
.BR awk (1)
هستند.
.TP
عملگرهای پیوند بولی (Boolean Connectives)
.B &&
(و / and)،
.B ||
(یا / or)،
.B !
(نقیض / not)،
.B ()
(تغییر حق تقدم)
.TP
عملگرهای مقایسه اعداد (Number comparators)
.B <
,
.B <=
,
.B >
,
.B >=
,
.B ==
,
.B !=
.TP
عملگرهای مقایسه رشته‌ها (String comparators)
.B ==
,
.B !=
.TP
عملگرهای مقایسه رشته/الگو (String/Pattern comparators)
.B ~
(رشته با الگو تطابق دارد)
,
.B !~
(رشته با الگو تطابق ندارد)
.TP
متغیرهای رزروشده (Reserved variables)
.B uid
(شناسه کاربر؛ نوع عدد صحیح)
.B uname
(نام کاربر؛ نوع رشته)،
.B gid
(شناسه گروه؛ نوع عدد صحیح)
.B gname
(نام گروه؛ نوع رشته)،
.B fname
(نام فایل فرایند؛ نوع رشته)،
.B psargs
(نام فایل فرایند به همراه آرگومان‌ها؛ نوع رشته)،
.B cpuburn
(میزان مصرف پردازنده؛ نوع اعشاری float)،
.B iodemand
(تقاضای ورودی/خروجی \- کیلوبایت خوانده/نوشته‌شده در هر ثانیه؛ نوع اعشاری float)،
.B ctxswitch
(تعداد تعویض زمینه در ثانیه؛ نوع اعشاری float)،
.B syscalls
(تعداد فراخوانی‌های سیستمی در ثانیه؛ نوع اعشاری float)،
.B virtualsize
(اندازه حافظه مجازی بر حسب کیلوبایت؛ نوع اعشاری float)،
.B residentsize
(اندازه حافظه مقیم بر حسب کیلوبایت؛ نوع اعشاری float)،
.B iowait
(انتظار مسدودشده و خام برای ورودی/خروجی بر حسب ثانیه/ثانیه؛ نوع اعشاری float)،
.B schedwait
(مدت زمان انتظار در صف زمان‌بندی اجرا بر حسب ثانیه/ثانیه؛ نوع اعشاری float).
.TP
مقادیر صریح (Literal values)
.B 1234
(عدد صحیح مثبت)،
.B 0.35
(اعشاری مثبت)،
\f3"foobar"\f1
(رشته؛ محصور در \f3"\f1)،
.B /[fF](o)+bar/
(الگو؛ محصور در \f3/\f1)،
.B true
(بولی)،
.B false
(بولی)
.TP
توضیحات (Comments)
.B #this is a comment
(از \f3#\f1 تا پایان سطر).
.TP
مثال‌ها (Examples)
  cpuburn > 0.2 # cpu utilization of more than 20%
  cpuburn > 0.2 && uname == "root"
  cpuburn > 0.2 && (uname == "root" || uname == "hot")
  psargs ~ /pmda/ && cpuburn > 0.4

.PP
معیارهای \f3hotproc.predicate\f1 می‌توانند برای مشاهده مقادیر متغیرهای رزروشده‌ای استفاده شوند که در آخرین تازه‌سازی توسط گزاره استفاده شده‌اند.
آن‌ها متغیرهای رزروشده‌ای را که از پیش در جای دیگری صادر شده‌اند پوشش نمی‌دهند. اگر به متغیری در گزاره پیکربندی ارجاع داده نشده باشد، معیار \f3hotproc.predicate\f1 ممکن است مقداری نداشته باشد..SH "پیکربندی پویا (DYNAMIC CONFIGURATION)"
معیارهای فرآیند
.B hot
را می‌توان در زمان اجرا از طریق رابط
.BR pmstore (1)
(و به‌طور ضمنی، از طریق رابط برنامه‌نویسی
.BR pmStore (3))
نیز پیکربندی کرد.
.TP
مثال‌ها
  pmstore hotproc.control.config 'fname == "mingetty"'
  pmstore hotproc.control.config 'uid == 0'
.TP
برای بارگذاری مجدد اجباری فایل پیکربندی:
  pmstore hotproc.control.reload_config "1"
.SH "پیکربندی دسترسی (ACCESS CONFIGURATION)"
دسترسی به معیارهای تفکیک‌شده به‌ازای‌فرآیند توسط چندین عامل کنترل می‌شود.
.PP
هنگام استفاده از اتصالات محلی با اصالت‌سنجی خودکار، مانند اتصالات در بافت به سبک \(lqunix:\(rq یا \(lqlocal:\(rq، ابزارهای کلاینت به این معیارها دسترسی کامل خواهند داشت؛ گویی که نمونه‌برداری از معیارها مستقیماً توسط کاربری انجام می‌شود که ابزار کلاینت را اجرا کرده است.
.PP
هنگام استفاده از
.B pmcd
با کلاینت‌های راه‌دور اصالت‌سنجی‌شده، می‌توان مجموعه‌ای از نام‌های کاربری را مشخص کرد که مجاز به دسترسی به معیارهای فرآیند هستند.
.PP
می‌توان از یک فایل پیکربندی به نشانی
.B $PCP_SYSCONF_DIR/proc/access.conf
برای تنظیم دقیق این رفتار استفاده کرد؛ این فایل از دو کلیدواژه پشتیبانی می‌کند:
.TP
.B allowed
فهرستی از نام‌های کاربری اصالت‌سنجی‌شده که با کاما از یکدیگر جدا شده‌اند و مجاز به دسترسی به معیارهای به‌ازای‌فرآیند خواهند بود.
نمونه‌برداری با هویت کاربر ریشه (root) انجام می‌شود.
.TP
.B mapped
یک مقدار بولی است؛ در صورت درستی (true)، نشان می‌دهد نام‌های کاربری اصالت‌سنجی‌شده به نام‌های حساب‌های کاربری سیستم محلی نگاشت خواهند شد (این امر مستلزم نگاشت یک‌به‌یک نام کاربری بین حساب کاربری و نام کاربری اصالت‌سنجی‌شده مبتنی بر SASL است که توسط
.BR pmcd (1)
اعمال می‌شود).
نمونه‌برداری با هویت آن کاربر محلی انجام می‌شود.
.SH "نصب (INSTALLATION)"
عامل
.B proc
PMDA به‌طور پیش‌فرض نصب شده و در دسترس است.
اگر می‌خواهید نصب آن را لغو کنید، دستورهای زیر را با هویت ریشه (root) اجرا کنید:
.PP
.ft CR
.nf
.in +0.5i
# cd $PCP_PMDAS_DIR/proc
# ./Remove
.in
.fi
.ft 1
.PP
اگر می‌خواهید پس از حذف، دوباره دسترسی به نام‌ها، متن راهنما و مقادیر معیارهای کارایی proc را برقرار کنید، دستورهای زیر را با هویت ریشه (root) اجرا کنید:
.PP
.ft CR
.nf
.in +0.5i
# cd $PCP_PMDAS_DIR/proc
# ./Install
.in
.fi
.ft 1
.PP
برنامهٔ
.B pmdaproc
توسط
.BR pmcd (1)
راه‌اندازی می‌شود و هرگز نباید مستقیماً اجرا گردد.
اسکریپت‌های Install و Remove در هنگام نصب یا حذف عامل، موضوع را به
.BR pmcd (1)
اطلاع‌رسانی می‌کنند.
.SH "فایل‌ها (FILES)"
.PD 0
.TP 10
.B $PCP_PMCDCONF_PATH
گزینه‌های خط فرمان مورد استفاده برای راه‌اندازی
.B pmdaproc
.TP 10
.B $PCP_PMDAS_DIR/proc/help
فایل پیش‌فرض متن راهنما برای معیارهای proc
.TP 10
.B $PCP_PMDAS_DIR/proc/Install
اسکریپت نصب برای عامل
.B pmdaproc
.TP 10
.B $PCP_PMDAS_DIR/proc/Remove
اسکریپت لغو نصب برای عامل
.B pmdaproc
.TP 10
.B $PCP_LOG_DIR/pmcd/proc.log
فایل گزارش (log) پیش‌فرض برای پیام‌های خطا و سایر اطلاعات از
.B pmdaproc
.TP 10
.B $PCP_PMDAS_DIR/proc/samplehotproc.conf
نمونه سادهٔ پیکربندی hotproc
.TP 10
.B $PCP_PMDAS_DIR/proc/hotproc.conf
فایل پیکربندی پیش‌فرض hotproc
.TP 10
.B $PCP_SYSCONF_DIR/proc/access.conf
فایل پیش‌فرض پیکربندی کنترل دسترسی
.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 pmdaproc
به شرح زیر هستند:
.TS
box;
lf(B) | lf(B)
lf(B) | lf(R) .
گزینه	توضیحات
_
appl0	مدیریت cgroup
_
appl1	پردازش تازه‌سازی، شامل معیارهای hotproc
_
appl2	عملیات‌های PMNS
_
appl3	معیارهای process accounting
.TE
.SH "همچنین ببینید (SEE ALSO)"
.BR PCPIntro (1)،
.BR pmcd (1)،
.BR pmstore (1)،
.BR seteuid (2)،
.BR setegid (2)،
.BR PMAPI (3)،
.BR pcp.conf (5)
و
.BR pcp.env (5).

.\" control lines for scripts/man-spell
.\" +ok+ samplehotproc {from $PCP_PMDAS_DIR/proc/samplehotproc.conf}
.\" +ok+ reload_config residentsize virtualsize schedwait SASL
.\" +ok+ ctxswitch mingetty iodemand syscalls HOTPROC setegid seteuid hotproc
.\" +ok+ cpuburn foobar iowait psargs fname gname uname args CVE
.\" +ok+ fF {from regex}