'\"macro stdmacro
.\"
.\" Copyright (c) 2017, 2023 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.
.\"
.\"
.ds ia resctrl
.ds IA RESCTRL
.ds Ia Resctrl
.TH PMDARESCTRL 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
\f3pmdaresctrl\f1 \- عامل دامنه معیارهای کارایی (PMDA) برای \*(ia
.SH "خلاصه دستور (SYNOPSIS)"
\f3$PCP_PMDAS_DIR/pmda\*(ia\f1
[\f3\-D\f1 \f2debug\f1]
[\f3\-d\f1 \f2domain\f1]
[\f3\-l\f1 \f2logfile\f1]
.SH "توضیحات (DESCRIPTION)"
.B pmda\*(ia
یک عامل دامنه معیارهای کارایی (PMDA) برای \*(ia است که مقادیر معیارهای کارایی را از رابط /sys/fs/resctrl استخراج کرده تا اطلاعاتی درباره حافظه نهان سطح آخر (last level cache) ارائه دهد.

.in
.PP
جزئیات بیشتر درباره پشتیبانی لینوکس از معیارهای حافظه نهان سطح آخر را می‌توان در نشانی زیر یافت:
.BR https://github.com/torvalds/linux/tree/master/Documentation/arch/x86/resctrl.rst .
.SH "نصب (INSTALLATION)"
اگر به نام‌ها، متن راهنما و مقادیر معیارهای کارایی \*(ia نیاز دارید، دستورات زیر را با دسترسی ریشه (root) انجام دهید:
.PP
.ft CR
.nf
.in +0.5i
# cd $PCP_PMDAS_DIR/\*(ia
# ./Install
.in
.fi
.ft 1
.PP
اگر می‌خواهید نصب را لغو کنید (و هر دو PMDA را حذف نمایید)، دستورات زیر را با دسترسی ریشه (root) انجام دهید:
.PP
.ft CR
.nf
.in +0.5i
# cd $PCP_PMDAS_DIR/\*(ia
# ./Remove
.in
.fi
.ft 1
.PP
.B pmda\*(ia
توسط
.BR pmcd (1)
راه‌اندازی می‌شود و هرگز نباید به‌طور مستقیم اجرا گردد. اسکریپت‌های Install و Remove هنگام نصب یا حذف عامل، به
.BR pmcd (1)
اطلاع می‌دهند.
.SH "فایل‌ها (FILES)"
.PD 0
.TP 10
.B $PCP_PMCDCONF_PATH
گزینه‌های خط فرمان مورد استفاده برای راه‌اندازی
.B pmda\*(ia
.TP 10
.B $PCP_PMDAS_DIR/\*(ia/help
فایل متن راهنمای پیش‌فرض برای معیارهای \*(ia
.TP 10
.B $PCP_PMDAS_DIR/\*(ia/Install
اسکریپت نصب برای عامل
.B pmda\*(ia
.TP 10
.B $PCP_PMDAS_DIR/\*(ia/Remove
اسکریپت لغو نصب برای عامل
.B pmda\*(ia
.PD
.SH "محیط PCP (PCP ENVIRONMENT)"
متغیرهای محیطی با پیشوند
.B PCP_
برای پارامتربندی نام فایل‌ها و دایرکتوری‌های مورد استفاده توسط PCP به کار می‌روند. در هر نصب، فایل
.B /etc/pcp.conf
شامل مقادیر محلی برای این متغیرها است. متغیر
.B $PCP_CONF
ممکن است برای مشخص کردن یک فایل پیکربندی جایگزین استفاده شود، همان‌طور که در
.BR pcp.conf (5)
توضیح داده شده است. به‌ویژه، متغیر
.B $PCP_RESCTRL_DIR
می‌تواند برای تغییر دایرکتوری پیش‌فرض از
.BR /sys/fs/resctrl
تنظیم شود.
.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 pcp.conf (5)،
.BR pcp.env (5)
و
.BR resctrl (1).

.\" control lines for scripts/man-spell
.\" +ok+ PCP_RESCTRL_DIR pmdaresctrl torvalds RESCTRL Resctrl resctrl github
.\" +ok+ linux rst sys fs {from /sys/fs/resctrl}