'\"macro stdmacro
.\"
.\" Copyright (C) 2021 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 PMDABCC 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
\f3pmdabpf\f1 \- عامل دامنه معیارهای عملکرد eBPF
.ds ia bpf
.SH "خلاصه دستور (SYNOPSIS)"
\f3$PCP_PMDAS_DIR/\*(ia/pmda\*(ia\f1
[\f3\-D\f1 \f2debug\f1]
.SH "توضیحات (DESCRIPTION)"
دستور \fBpmdabpf\fP یک عامل دامنه معیارهای عملکرد (PMDA) در Performance Co-Pilot (PCP) است که داده‌های زنده مربوط به کارایی را با بهره‌گیری از BPF CO-RE (شامل libbpf و BTF) از برنامه‌های eBPF استخراج می‌کند.
.PP
دستور \fBpmdabpf\fP هر تعداد از ماژول‌های مجزا و پیکربندی‌شدهٔ bpf PMDA را بارگذاری کرده و به عنوان یک پل ارتباطی برای آن‌ها عمل می‌کند. باید بتوان با صرف تلاشی معقول، ابزارهای موجود libbpf را به همراه ماژول‌های bpf PMDA به کار گرفت.
.PP
برای توضیحات تفصیلی، به مستندات eBPF، libbpf و BPF CO-RE مراجعه کنید.
.SH "پیکربندی (CONFIGURATION)"
دستور \fBpmdabpf\fP یک فایل پیکربندی الزامی در قالب ini را می‌خواند:
.IP
.PD 0
.IP
.I \f(CR$PCP_PMDAS_DIR\fP/bpf/bpf.conf
.PD
.PP
هر بخش از فایل به یک ماژول bpf PMDA اختصاص دارد.
گزینه‌های سراسری زیر برای هر ماژول در دسترس هستند
(مقادیر پیش‌فرض آن‌ها در پرانتز نشان داده شده است):
.TP 15
.B enabled \fR(unset)\fP
یک مقدار بولی برای تعیین این که آیا این ماژول bpf PMDA باید آغاز به کار کند یا خیر.
.PP
ماژول‌ها همچنین ممکن است از گزینه‌های پیکربندی اختصاصی ماژول نیز پشتیبانی کنند؛ برای اطلاع از گزینه‌های پشتیبانی‌شده به فایل پیکربندی پیش‌فرض مراجعه کنید.
.SH "نصب (INSTALLATION)"
برای نصب، دستورات زیر باید با دسترسی ریشه (root) انجام شوند:
.sp 1
.RS +4
.ft B
.nf
# cd $PCP_PMDAS_DIR/bpf
# ./Install
.fi
.ft P
.RE
.sp 1
برای حذف نصب، دستورات زیر باید با دسترسی ریشه (root) انجام شوند:
.sp 1
.RS +4
.ft B
.nf
# cd $PCP_PMDAS_DIR/bpf
# ./Remove
.fi
.ft P
.RE
.sp 1
عامل \fBpmdabpf\fP توسط \fBpmcd\fP(1) راه‌اندازی می‌شود و هرگز نباید مستقیماً اجرا گردد.
اسکریپت‌های \fBInstall\fP و \fBRemove\fP هنگام نصب یا حذف عامل، به \fBpmcd\fP(1) اطلاع می‌دهند.
.PP
برخی ماژول‌ها تنها پس از جمع‌آوری داده‌ها از فعالیت‌های مربوطه در سیستم، شروع به ارائه مقادیر می‌کنند.
.SH "فایل‌ها (FILES)"
.TP 5
.I \f(CR$PCP_PMDAS_DIR\fP/bpf/bpf.conf
فایل پیکربندی برای عامل \fBpmdabpf\fP
.TP
.I \f(CR$PCP_PMDAS_DIR\fP/bpf/modules/*.{o,so}
ماژول‌های bpf PMDA در دسترس برای عامل \fBpmdabpf\fP
.TP
.I \f(CR$PCP_PMDAS_DIR\fP/bpf/Install
اسکریپت نصب برای عامل \fBpmdabpf\fP
.TP
.I \f(CR$PCP_PMDAS_DIR\fP/bpf/Remove\fP
اسکریپت لغو نصب برای عامل \fBpmdabpf\fP
.TP
.I \f(CR$PCP_LOG_DIR\fP/pmcd/bpf.log
فایل لاگ پیش‌فرض برای پیام‌های ارسالی از سوی عامل \fBpmdabpf\fP
.PP
توجه داشته باشید که مقدار معمول/پیش‌فرض برای \fB$PCP_PMDAS_DIR\fP مسیر
.B /var/lib/pcp/pmdas
و مقدار پیش‌فرض برای \fB$PCP_LOG_DIR\fP مسیر
.B /var/log/pcp
می‌باشد، اما این تنظیمات به پلتفرم وابسته هستند.
.SH "محیط PCP (PCP ENVIRONMENT)"
متغیرهای محیطی با پیشوند \fBPCP_\fP برای تعیین نام فایل‌ها و دایرکتوری‌های مورد استفاده PCP به صورت پارامتری به کار می‌روند.
در هر نصب، فایل \fI/etc/pcp.conf\fP حاوی مقادیر محلی برای این متغیرها است.
می‌توان از متغیر \fB$PCP_CONF\fP برای مشخص کردن یک فایل پیکربندی جایگزین استفاده کرد، همان‌طور که در \fBpcp.conf\fP(5) شرح داده شده است.
.SH "گزینه‌های اشکال‌زدایی (DEBUGGING OPTIONS)"
گزینه
.B \-D
یا
.B \-\-debug
خروجی پیام‌های عیب‌یابی تکمیلی را در
.I stderr
برای کمک به تفکیک و ریشه‌یابی مشکلات فعال می‌کند، اگرچه این اطلاعات گاهی مبهم است و در اصل به منظور راهنمایی توسعه‌دهندگان طراحی شده نه کاربران نهایی.
.I debug
فهرستی از گزینه‌های اشکال‌زدایی است که با کاما از هم جدا شده‌اند؛ از دستور
.BR pmdbg (1)
همراه با گزینه
.B \-l
برای دریافت فهرستی از گزینه‌های اشکال‌زدایی موجود و معانی آن‌ها استفاده کنید.
.SH "همچنین ببینید (SEE ALSO)"
.BR PCPIntro (1)،
.BR bpf (1)
و
.BR pmcd (1).

.\" control lines for scripts/man-spell
.\" +ok+ libbpf eBPF BPF BTF bpf CO {from CO-RE}