'\" t
.\"
.\" Copyright (c) 2021-2025 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 PMDADENKI 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
pmdadenki \- معیارهای مربوط به مصرف برق سیستم
.SH "خلاصه دستور (SYNOPSIS)"
\f3$PCP_PMDAS_DIR/denki/pmdadenki\f1
[\f3\-D\f1 \f2debug\f1]
[\f3\-d\f1 \f2domain\f1]
[\f3\-l\f1 \f2logfile\f1]
.SH "توضیحات (DESCRIPTION)"
.B pmdadenki
یک عامل دامنه معیارهای عملکرد (PMDA) است که
معیارهای عملکرد مربوط به مصرف برق را استخراج می‌کند.
.PP
در حال حاضر، در صورت پشتیبانی سخت‌افزار، معیارهای مربوط به ویژگی
Running Average Power Limit (RAPL)
پردازنده‌های اینتل و مقادیر شارژ باتری در دسترس هستند.
.PP
.B \-l
محل فایل گزارش (log).
به‌طور پیش‌فرض، یک فایل گزارش با نام
.I denki.log
هنگام راه‌اندازی
.B pmdadenki
در دایرکتوری جاری
.BR pmcd (1)
نوشته می‌شود، یعنی
.BR $PCP_LOG_DIR/pmcd .
اگر فایل گزارش نتواند ایجاد شود یا قابل نوشتن نباشد، خروجی به‌جای آن
به خطای استاندارد ارسال می‌شود.
.SH "نصب (INSTALLATION)"
عامل
.B denki
PMDA به‌طور پیش‌فرض روی لینوکس نصب شده و در دسترس است.
اگر می‌خواهید نصب را لغو کنید، دستورات زیر را با دسترسی root انجام دهید:
.PP
.ft CR
.nf
.in +0.5i
# cd $PCP_PMDAS_DIR/denki
# ./Remove
.in
.fi
.ft 1
.PP
اگر می‌خواهید پس از حذف، مجدداً به نام‌ها، متن راهنما و مقادیر معیارهای
denki دسترسی داشته باشید، دستورات زیر را با دسترسی root انجام دهید:
.PP
.ft CR
.nf
.in +0.5i
# cd $PCP_PMDAS_DIR/denki
# ./Install
.in
.fi
.ft 1
.PP
.B pmdadenki
توسط
.BR pmcd (1)
راه‌اندازی می‌شود و هرگز نباید مستقیماً اجرا شود.
اسکریپت‌های Install و Remove هنگام نصب یا حذف عامل به
.BR pmcd (1)
اطلاع‌رسانی می‌کنند.
.SH "فایل‌ها (FILES)"
.PD 0
.TP 10
.B $PCP_PMCDCONF_PATH
گزینه‌های خط فرمان مورد استفاده برای راه‌اندازی
.B pmdadenki
.TP 10
.B $PCP_PMDAS_DIR/denki/help
فایل متنی راهنمای پیش‌فرض برای معیارهای denki
.TP 10
.B $PCP_PMDAS_DIR/denki/Install
اسکریپت نصب برای عامل
.B pmdadenki
.TP 10
.B $PCP_PMDAS_DIR/denki/Remove
اسکریپت لغو نصب برای عامل
.B pmdadenki
.TP 10
.B $PCP_LOG_DIR/pmcd/denki.log
فایل گزارش پیش‌فرض برای پیام‌های خطا و سایر اطلاعات از
.B pmdadenki
.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 pmdadenki
به شرح زیر است:
.TS
box;
lf(B) | lf(B)
lf(B) | lf(R) .
Option	توضیحات
_
appl0	پیام‌های تشخیصی با جزئیات کامل
.TE
.SH "همچنین ببینید (SEE ALSO)"
.BR PCPIntro (1),
.BR pmcd (1),
فایل
.BR denki/README ,
.BR pcp.conf (5)
و
.BR pcp.env (5).

.\" control lines for scripts/man-spell
.\" +ok+ pmdadenki denki RAPL CPUs