نام (NAME)

pmdaamdgpu - عامل دامنه معیارهای پردازنده گرافیکی AMD (PMDA)

خلاصه دستور (SYNOPSIS)

$PCP_PMDAS_DIR/amdgpu/pmdaamdgpu [-D debug] [-d domain] [-l logfile] [-t interval]

توضیحات (DESCRIPTION)

pmdaamdgpu یک عامل دامنه معیارهای کارایی (PMDA) است که معیارهای کارایی مربوط به کارت‌های گرافیک AMD را از طریق کتابخانه DRM استخراج می‌کند.

عامل amdgpu PMDA معیارهایی را ارائه می‌دهد که فعالیت پردازنده گرافیکی، استفاده از حافظه، دما و غیره را در پردازنده‌های گرافیکی AMD با معماری GCN 1.2+ اندازه‌گیری می‌کنند.

توضیح مختصری از گزینه‌های خط فرمان pmdaamdgpu در ادامه آمده است:

-d: بسیار حیاتی است که شماره دامنه معیارهای کارایی ( domain) تعیین‌شده در اینجا یکتا و سازگار باشد. به این معنی که domain باید برای هر PMDA در یک میزبان متفاوت باشد، و همان شماره domain باید برای همان PMDA در تمام میزبان‌ها استفاده شود.
-l: محل فایل گزارش (لاگ). به‌طور پیش‌فرض، فایل گزارشی به نام amdgpu.log در دایرکتوری جاری pmcd(1) هنگام راه‌اندازی pmdaamdgpu نوشته می‌شود، یعنی $PCP_LOG_DIR/pmcd. اگر فایل گزارش ایجاد نشود یا قابل نوشتن نباشد، خروجی در خطای استاندارد نوشته می‌شود.
-t: یک بازه زمانی نمونه‌برداری ( interval) را برای نوسازی خودکار مقادیر معیار فعال و تنظیم می‌کند. این قابلیت به‌طور پیش‌فرض غیرفعال است، اما این گزینه امکان تعیین یک بازه زمانی برای نمونه‌برداری از تمام مقادیر را فراهم می‌سازد - این کار با هدف کمک به ابزارهای کلاینت مانند pcp-atop(1) و pmlogger(1) برای مشاهده تغییرات وضعیت پردازنده گرافیکی و فرایند در بازه‌های زمانی کوتاه‌تر از بازه نمونه‌برداری، معیارهای انباشتی را مداوم به‌روزرسانی می‌کند. به‌طور معمول این ابزارها بازه‌های نمونه‌برداری طولانی‌تری دارند و بنابراین ممکن است فعالیت‌های رخ‌داده در طول بازه نمونه‌برداری خود را از دست بدهند.

نصب (INSTALLATION)

عامل amdgpu PMDA به‌طور پیش‌فرض نصب نشده و در دسترس نیست. اگر می‌خواهید نصب را لغو کنید، دستورهای زیر را با کاربر ارشد (root) اجرا کنید:

# cd $PCP_PMDAS_DIR/amdgpu
# ./Remove

اگر می‌خواهید پس از حذف، دوباره دسترسی به نام‌ها، متن راهنما و مقادیر معیارهای کارایی پردازنده گرافیکی AMD را برقرار کنید، دستورهای زیر را با کاربر ارشد (root) اجرا کنید:

# cd $PCP_PMDAS_DIR/amdgpu
# ./Install

pmdaamdgpu توسط pmcd(1) راه‌اندازی می‌شود و هرگز نباید به‌صورت مستقیم اجرا گردد. اسکریپت‌های Install و Remove هنگام نصب یا حذف عامل، این موضوع را به pmcd(1) اطلاع می‌دهند.

فایل‌ها (FILES)

$PCP_PMCDCONF_PATH: گزینه‌های خط فرمان استفاده‌شده برای راه‌اندازی pmdaamdgpu
$PCP_PMDAS_DIR/amdgpu/help: فایل متنی راهنمای پیش‌فرض برای معیارهای amdgpu
$PCP_PMDAS_DIR/amdgpu/Install: اسکریپت نصب برای عامل pmdaamdgpu
$PCP_PMDAS_DIR/amdgpu/Remove: اسکریپت لغو نصب برای عامل pmdaamdgpu
$PCP_LOG_DIR/pmcd/amdgpu.log: فایل گزارش پیش‌فرض برای پیام‌های خطا و سایر اطلاعات از pmdaamdgpu

محیط PCP (PCP ENVIRONMENT)

متغیرهای محیطی با پیشوند PCP_ برای پیکربندی نام فایل‌ها و دایرکتوری‌های مورد استفاده توسط PCP به کار می‌روند. در هر نصب، فایل /etc/pcp.conf حاوی مقادیر محلی برای این متغیرها است. متغیر $PCP_CONF می‌تواند برای تعیین یک فایل پیکربندی جایگزین استفاده شود، همان‌طور که در pcp.conf(5) شرح داده شده است.

گزینه‌های اشکال‌زدایی (DEBUGGING OPTIONS)

گزینه -D یا --debug چاپ خروجی‌های عیب‌یابی اضافی را در stderr فعال می‌کند تا به تفکیک و دسته‌بندی مشکلات کمک کند، اگرچه این اطلاعات گاهی مبهم بوده و در درجه اول برای راهنمایی توسعه‌دهندگان در نظر گرفته شده است تا کاربران نهایی. debug فهرستی از گزینه‌های اشکال‌زدایی است که با کاما از هم جدا شده‌اند؛ از pmdbg(1) همراه با گزینه -l برای دریافت فهرستی از گزینه‌های اشکال‌زدایی موجود و معانی آن‌ها استفاده کنید.

گزینه‌های اشکال‌زدایی مختص به pmdaamdgpu به شرح زیر است:

Option	توضیحات
appl0	تعامل با pmcd(1)
appl2	ردیابی فراخوانی‌های select(2)

همچنین ببینید (SEE ALSO)

PCPIntro(1)، pcp-atop(1)، pmcd(1)، pmlogger(1)، pcp.conf(5) و pcp.env(5).