'\" t
.\"
.\" Copyright (c) 2014-2015 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 "PMDAROOT" 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
pmdaroot \- عامل دامنه معیارهای کارایی و دستیار ممتاز برای PMCD
.SH "خلاصه دستور (SYNOPSIS)"
\f3$PCP_PMDAS_DIR/root/pmdaroot\f1
[\f3\-D\f1 \f2debug\f1]
[\f3\-d\f1 \f2domain\f1]
[\f3\-l\f1 \f2logfile\f1]
[\f3\-s\f1 \f2sockname\f1]
.SH "توضیحات (DESCRIPTION)"
دستور
.B pmdaroot
یک عامل دامنه معیارهای کارایی (PMDA) ویژه است که همکاری نزدیکی با
.BR pmcd (1)
و دیگر PMDAها دارد تا خدمات ممتاز محدودی را به این فرآیندهای فاقد دسترسی ارشد ارائه دهد.
.PP
در این نقش، برای شناسایی کانتینرهای سیستم‌عامل در حال اجرا روی میزبان محلی به کار می‌رود. همچنین این ابزار دسترسی به داده‌های کارایی را از درون آن کانتینرها برای سایر PMDAهای در حال اجرا روی میزبان فیزیکی، با استفاده از
.BR pmdaRootConnect (3)
و رابط‌های فضای‌نام (namespace) مرتبط امکان‌پذیر می‌سازد.
.PP
مانند سایر PMDAها، این عامل نیز معیارهای کارایی را از دامنه‌ای که کنترل می‌کند صادر می‌نماید. در حال حاضر، این مورد محدود به اطلاعات کانتینرهای موجود در سیستم محلی است؛ اکنون کانتینرهای Docker و LXC قابل شناسایی هستند.
.PP
اگر یک نام والد غیرپیش‌فرض cgroup برای Docker استفاده می‌شود، این مقدار را می‌توان با افزودن متغیر
.B $PCP_SYSTEMD_CGROUP
در
.IR /etc/pcp.conf
به
.B pmdaroot
اعلام کرد.
.TP 5
.B \-d
بسیار حیاتی است که شماره
.I domain
(دامنه) معیارهای کارایی که در اینجا مشخص می‌شود، یکتا و سازگار باشد. یعنی
.I domain
باید برای هر PMDA روی یک میزبان متفاوت باشد، و همان شماره
.I domain
باید برای همان PMDA در تمام میزبان‌ها استفاده شود.
.TP
.B \-l
مسیر فایل لاگ. به‌طور پیش‌فرض، هنگامی که
.B pmdaroot
راه‌اندازی می‌شود، یک فایل لاگ با نام
.I root.log
در دایرکتوری جاری
.BR pmcd (1)
یعنی
.BR $PCP_LOG_DIR/pmcd
نوشته می‌شود. اگر فایل لاگ نتواند ایجاد شود یا قابل نوشتن نباشد، خروجی به‌جای آن در خطای استاندارد (stderr) نوشته خواهد شد.
.TP
.B \-s
مسیر سوکت دامنه
.BR unix (7)
برای ارتباط با کلاینت‌هایی که درخواست عملیات با دسترسی ممتاز دارند. به‌طور پیش‌فرض، از یک فایل سوکت با نام
.BR $PCP_TMP_DIR/pmcd/root.socket
استفاده می‌شود.
.SH "نصب (INSTALLATION)"
دسترسی به نام‌ها، متن راهنما و مقادیر معیارهای کارایی هسته به‌طور پیش‌فرض در دسترس است \- برخلاف بیشتر عامل‌های دیگر، هیچ اقدامی برای فعال‌سازی آن‌ها لازم نیست و نباید حذف شوند.
.SH "فایل‌ها (FILES)"
.PD 0
.TP 10
.B $PCP_PMDAS_DIR/root/help
فایل متنی راهنمای پیش‌فرض برای معیارهای صادرشده توسط PMDA ریشه.
.TP 10
.B $PCP_LOG_DIR/pmcd/root.log
فایل لاگ پیش‌فرض برای پیام‌های خطا و سایر اطلاعات از PMDA ریشه.
.TP 10
.B $PCP_VAR_DIR/pmcd/root.socket
فایل سوکت پیش‌فرض برای ارتباط با کلاینت‌های PMDA ریشه.
.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 pmdaroot
به شرح زیر هستند:
.TS
box;
lf(B) | lf(B)
lf(B) | lf(R) .
گزینه	توضیحات
_
appl0	تعاملات با \fBpmcd\fP(1)
_
appl1	پردازش راه‌اندازی PMDA
.TE
.SH "همچنین ببینید (SEE ALSO)"
.BR PCPIntro (1)،
.BR pmcd (1)،
.BR PMDA (3)،
.BR pmdaRootConnect (3)،
.BR pcp.conf (5)
و
.BR unix (7).

.\" control lines for scripts/man-spell
.\" +ok+ LXC cgroup