'\" t
.\"
.\" Copyright (c) 2014,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 PMDANVIDIA 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
pmdanvidia \- عامل دامنه معیارهای پردازنده گرافیکی انویدیا (PMDA)
.SH "خلاصه دستور (SYNOPSIS)"
\f3$PCP_PMDAS_DIR/nvidia/pmdanvidia\f1
[\f3\-D\f1 \f2debug\f1]
[\f3\-d\f1 \f2domain\f1]
[\f3\-l\f1 \f2logfile\f1]
[\f3\-t\f1 \f2interval\f1]
.SH "توضیحات (DESCRIPTION)"
.B pmdanvidia
یک عامل دامنه معیارهای کارایی (PMDA) است که معیارهای کارایی مربوط به کارت‌های گرافیک
NVIDIA
را از طریق کتابخانه NVML استخراج می‌کند.
.PP
عامل
.B nvidia
PMDA معیارهایی را ارائه می‌دهد که فعالیت پردازنده گرافیکی، استفاده از حافظه، سرعت فن و غیره را در کارت‌های NVIDIA Tesla و Quadro اندازه‌گیری می‌کنند. بعید است این معیارها برای کارت‌های رده مصرف‌کننده در دسترس باشند.
.PP
توضیح مختصری از گزینه‌های خط فرمان
.B pmdanvidia
در ادامه آمده است:
.TP 5
.B \-d
بسیار حیاتی است که شماره دامنه معیارهای کارایی (
.IR domain )
تعیین‌شده در اینجا یکتا و سازگار باشد.
به این معنی که
.I domain
باید برای هر PMDA در یک میزبان متفاوت باشد، و همان شماره
.I domain
باید برای همان PMDA در تمام میزبان‌ها استفاده شود.
.TP
.B \-l
محل فایل گزارش (لاگ). به‌طور پیش‌فرض، فایل گزارشی به نام
.I nvidia.log
در دایرکتوری جاری
.BR pmcd (1)
هنگام راه‌اندازی
.B pmdanvidia
نوشته می‌شود، یعنی
.BR $PCP_LOG_DIR/pmcd .
اگر فایل گزارش ایجاد نشود یا قابل نوشتن نباشد، خروجی در خطای استاندارد نوشته می‌شود.
.TP
.B \-t
یک بازه زمانی نمونه‌برداری (
.IR interval )
را برای نوسازی خودکار مقادیر معیار فعال و تنظیم می‌کند.
این قابلیت به‌طور پیش‌فرض غیرفعال است، اما این گزینه امکان تعیین یک بازه زمانی برای نمونه‌برداری از تمام مقادیر را فراهم می‌سازد \- این کار با هدف کمک به ابزارهای کلاینت مانند
.BR pcp-atop (1)
و
.BR pmlogger (1)
برای مشاهده تغییرات وضعیت پردازنده گرافیکی و فرایند در بازه‌های زمانی کوتاه‌تر از بازه نمونه‌برداری، معیارهای انباشتی را مداوم به‌روزرسانی می‌کند.
به‌طور معمول این ابزارها بازه‌های نمونه‌برداری طولانی‌تری دارند و بنابراین ممکن است فعالیت‌های رخ‌داده در طول بازه نمونه‌برداری خود را از دست بدهند.
.SH "نصب (INSTALLATION)"
عامل
.B nvidia
PMDA به‌طور پیش‌فرض نصب نشده و در دسترس نیست.
اگر می‌خواهید نصب را لغو کنید، دستورهای زیر را با کاربر ارشد (root) اجرا کنید:
.PP
.ft CR
.nf
.in +0.5i
# cd $PCP_PMDAS_DIR/nvidia
# ./Remove
.in
.fi
.ft 1
.PP
اگر می‌خواهید پس از حذف، دوباره دسترسی به نام‌ها، متن راهنما و مقادیر معیارهای کارایی nvidia را برقرار کنید، دستورهای زیر را با کاربر ارشد (root) اجرا کنید:
.PP
.ft CR
.nf
.in +0.5i
# cd $PCP_PMDAS_DIR/nvidia
# ./Install
.in
.fi
.ft 1
.PP
.B pmdanvidia
توسط
.BR pmcd (1)
راه‌اندازی می‌شود و هرگز نباید به‌صورت مستقیم اجرا گردد.
اسکریپت‌های Install و Remove هنگام نصب یا حذف عامل، این موضوع را به
.BR pmcd (1)
اطلاع می‌دهند.
.SH "فایل‌ها (FILES)"
.PD 0
.TP 10
.B $PCP_PMCDCONF_PATH
گزینه‌های خط فرمان استفاده‌شده برای راه‌اندازی
.B pmdanvidia
.TP 10
.B $PCP_PMDAS_DIR/nvidia/help
فایل متنی راهنمای پیش‌فرض برای معیارهای nvidia
.TP 10
.B $PCP_PMDAS_DIR/nvidia/Install
اسکریپت نصب برای عامل
.B pmdanvidia
.TP 10
.B $PCP_PMDAS_DIR/nvidia/Remove
اسکریپت لغو نصب برای عامل
.B pmdanvidia
.TP 10
.B $PCP_LOG_DIR/pmcd/nvidia.log
فایل گزارش پیش‌فرض برای پیام‌های خطا و سایر اطلاعات از
.B pmdanvidia
.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 pmdanvidia
به شرح زیر است:
.TS
box;
lf(B) | lf(B)
lf(B) | lxf(R) .
Option	توضیحات
_
appl0	تعامل با \fBpmcd\fP(1)
_
appl1	بارگذاری DSO مربوط به \fIlibnvidia-ml\fP
_
appl2	ردیابی فراخوانی‌های \fBselect\fP(2)
.TE
.SH "همچنین ببینید (SEE ALSO)"
.BR PCPIntro (1)،
.BR pcp-atop (1)،
.BR pmcd (1)،
.BR pmlogger (1)،
.BR pcp.conf (5)
و
.BR pcp.env (5).

.\" control lines for scripts/man-spell
.\" +ok+ NVML Quadro gpu nvidia