'\" t
.\"
.\" Copyright (c) 2014,2016 Red Hat.
.\"
.\" 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 PMDAMMV 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
\f3pmdammv\f1 \- عامل دامنه معیارهای کارایی برای مقادیر نگاشت‌شده در حافظه (PMDA)
.SH "خلاصه دستور (SYNOPSIS)"
\f3$PCP_PMDAS_DIR/mmv/pmdammv\f1
[\f3\-D\f1 \f2debug\f1]
[\f3\-d\f1 \f2domain\f1]
[\f3\-l\f1 \f2logfile\f1]
[\f3\-U\f1 \f2username\f1]
.SH "توضیحات (DESCRIPTION)"
.B pmdammv
یک عامل دامنه معیارهای کارایی (PMDA) است که معیارهای کارایی سطح برنامه را با استفاده از فایل‌های نگاشت‌شده در حافظه صادر می‌کند.
این ابزار امکان سنجش (instrumentation) بسیار کم‌سرباری را فراهم می‌آورد
که برای برنامه‌های طولانی‌اجرا و حیاتی که در آن‌ها فعال بودن دائمی معیارهای کارایی
و اطلاعات دسترسی‌پذیری نیاز است، بسیار مناسب است.
.PP
عامل
.B mmv
داده‌های سنجشی را که با استفاده از رابط‌های برنامه‌نویسی کاربردی (APIهای) MMV به برنامه افزوده شده‌اند صادر می‌کند (برای جزئیات بیشتر به
.BR mmv_stats_init (3)
و
.BR mmv (5)
مراجعه کنید).
این APIها از چندین زبان مختلف از جمله C، C++، Perl، Python، Java (از طریق کتابخانه کلاس مجزای «Parfait») و GoLang (از طریق کتابخانه مجزای «Speed») قابل فراخوانی هستند.
.PP
شرح مختصری از گزینه‌های خط فرمان
.B pmdammv
در ادامه آمده است:
.TP 5
.B \-d
بسیار حیاتی است که شماره
.I domain
(دامنه) معیارهای کارایی مشخص‌شده در اینجا یکتا و سازگار باشد.
یعنی
.I domain
باید برای هر PMDA روی یک میزبان متفاوت باشد، و شماره
.I domain
یکسان باید برای همان PMDA در تمام میزبان‌ها استفاده شود.
.TP
.B \-l
محل فایل وقایع (لاگ). به‌طور پیش‌فرض، زمانی که
.B pmdammv
راه‌اندازی می‌شود، یک فایل وقایع به نام
.I mmv.log
در دایرکتوری جاری
.BR pmcd (1)
نوشته می‌شود، یعنی
.BR $PCP_LOG_DIR/pmcd .
اگر فایل وقایع نتواند ایجاد شود یا قابل نوشتن نباشد، خروجی در خطای استاندارد نوشته می‌شود.
.TP
.B \-U
حساب کاربری که عامل تحت آن اجرا می‌شود.
پیش‌فرض در نسخه‌های فعلی PCP حساب غیرممتاز "pcp" است، اما در نسخه‌های قدیمی‌تر، حساب مدیر سیستم ("root") به‌طور پیش‌فرض استفاده می‌شد.
.SH "نصب (INSTALLATION)"
در وهله اول، باید یک مدل امنیتی برای ارتباط بین‌فرآیندی میان برنامه‌های سنجیده‌شده و
.B pmdammv
(که به عنوان یک کتابخانه اشتراکی درون
.BR pmcd
اجرا می‌شود) انتخاب و برقرار گردد.
.PP
این ارتباط از طریق فایل‌های نگاشت‌شده در حافظه در مکانی رخ می‌دهد که برای هر دو
.B pmdammv
و برنامه‌های سنجیده‌شده شناخته‌شده است.
آن مکان
.IR $PCP_TMP_DIR/mmv
است، اگرچه این مسیر اغلب در پشت APIهای برنامه‌نویسی مانند «Parfait» و
.BR mmv_stats_init (3)
پنهان شده است. مجوزهای تنظیم‌شده روی این دایرکتوری، مدل امنیتیِ در حال استفاده را مشخص می‌کنند.
.PP
روش امن‌تر، استفاده از یک گروه غیرممتاز موجود است که بین برنامه‌های سنجیده‌شده،
.B pmcd
و
.B pmdammv
به اشتراک گذاشته شده باشد، مانند گروه "pcp".
.PP
.ft CR
.nf
.in +0.5i
# . /etc/pcp.env
# mkdir -m 775 $PCP_TMP_DIR/mmv
# chgrp pcp $PCP_TMP_DIR/mmv
.in
.fi
.ft 1
.PP
از آنجا که این روش مستلزم استفاده برنامه‌های سنجیده‌شده از این گروه غیرپیش‌فرض است (نگاه کنید به
.BR newgrp (1)
و
.BR setgid (2))،
یک جایگزین رایج، استفاده از یک دایرکتوری
.I $PCP_TMP_DIR/mmv
با قابلیت نوشتن همگانی (world-writable) به همراه تنظیم بودن بیت چسبنده (sticky-bit) است (برای مثال، مشابه
.I /tmp
و
.IR /var/tmp ).
.PP
این کار به هر برنامه‌ای، در حال اجرا تحت هر حساب کاربری، اجازه می‌دهد تا با PMDA (که به‌طور پیش‌فرض تحت حساب "pcp" اجرا می‌شود) ارتباط برقرار کند.
این وضعیت ممکن است برای همه محیط‌ها مطلوب نباشد و باید پیامدهای امنیتی هرگونه راه‌اندازی دایرکتوری به این شکل را در نظر گرفت (دسته‌های مشابهی از مشکلات وجود دارند که دایرکتوری‌های موقت سیستم را نیز تحت تأثیر قرار می‌دهند).
.PP
.B pmdammv
به‌طور پیش‌فرض در تمام نصب‌های مدرن PCP فعال است، و از این رو نام‌ها، متن راهنما و مقادیر معیارهای کارایی mmv بدون نیاز به فرایند معمول ‎./Install‎ مربوط به PMDA در دسترس هستند.
.PP
اگر دایرکتوری
.I $PCP_TMP_DIR/mmv
وجود نداشته باشد، می‌توان از اسکریپت ./Install برای ایجاد یک دایرکتوری با دسترسی نوشتن همگانی و دارای بیت چسبنده (sticky-bit) جهت برقراری ارتباط استفاده کرد. این کار هم برای سازگاری با نسخه‌های قبلی و هم برای سهولت استفاده است \- برای استفاده از این سازوکار، مراحل زیر را با دسترسی root انجام دهید:
.PP
.ft CR
.nf
.in +0.5i
# rmdir $PCP_TMP_DIR/mmv
# cd $PCP_PMDAS_DIR/mmv
# ./Install
.in
.fi
.ft 1
.PP
این فرایند نصب هیچ دایرکتوری موجود
.I $PCP_TMP_DIR/mmv
را بازنویسی نخواهد کرد.
.PP
اگر می‌خواهید نصب را لغو کنید، دستورهای زیر را با کاربر root اجرا کنید:
.PP
.ft CR
.nf
.in +0.5i
# cd $PCP_PMDAS_DIR/mmv
# ./Remove
.in
.fi
.ft 1
.PP
.B pmdammv
توسط
.BR pmcd
راه‌اندازی می‌شود و هرگز نباید به‌طور مستقیم اجرا گردد.
اسکریپت‌های Install و Remove هنگامی که عامل نصب یا حذف می‌شود به
.BR pmcd
اطلاع می‌دهند.
.SH "فایل‌ها (FILES)"
.PD 0
.TP 10
.B $PCP_PMCDCONF_PATH
گزینه‌های خط فرمان مورد استفاده برای راه‌اندازی
.B pmdammv
.TP 10
.B $PCP_TMP_DIR/mmv
دایرکتوری نگه‌دارنده فایل‌های مقادیر نگاشت‌شده در حافظه
.TP 10
.B $PCP_PMDAS_DIR/mmv/help
فایل متنی راهنمای پیش‌فرض برای معیارهای mmv
.TP 10
.B $PCP_PMDAS_DIR/mmv/Install
اسکریپت نصب برای عامل
.B pmdammv
.TP 10
.B $PCP_PMDAS_DIR/mmv/Remove
اسکریپت لغو نصب برای عامل
.B pmdammv
.TP 10
.B $PCP_LOG_DIR/pmcd/mmv.log
فایل وقایع پیش‌فرض برای پیام‌های خطا و سایر اطلاعات از
.B pmdammv
.PD
.SH "محیط پی‌سی‌پی (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 pmdammv
به شرح زیر است:
.TS
box;
lf(B) | lf(B)
lf(B) | lf(R) .
گزینه	توضیحات
_
appl0	پیام‌های تشخیصی با جزئیات (verbose)
.TE
.SH "همچنین ببینید (SEE ALSO)"
.BR PCPIntro (1),
.BR pmcd (1),
.BR newgrp (1),
.BR setgid (2),
.BR mmv_stats_init (3),
.BR mmv (5),
.BR pcp.conf (5)
و
.BR pcp.env (5).

.\" control lines for scripts/man-spell
.\" +ok+ GoLang newgrp tmp