'\"macro stdmacro
.\"
.\" Copyright (c) 2020-2021 Red Hat.
.\" Copyright (c) 2008 Aconex.  All Rights Reserved.
.\"
.\" 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 PMDAKVM 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
\f3pmdakvm\f1 \- کارگزار دامنه معیارهای کارایی مجازی‌سازی لینوکس (PMDA)
.ds ia kvm
.SH "خلاصه دستور (SYNOPSIS)"
\f3$PCP_PMDAS_DIR/\*(ia/pmda\*(ia\f1
[\f3\-D\f1 \f2debug\f1]
.SH "توضیحات (DESCRIPTION)"
\f3pmdakvm\f1 یک کارگزار دامنه معیارهای کارایی (\s-1PMDA\s0) است که
مقادیر معیارها را از زیرسیستم مجازی‌سازی KVM (Kernel Virtual Machine) لینوکس صادر می‌کند.
.PP
معیارهای ردیابی KVM به ازای هر پردازنده از رویدادهای هسته که در مسیر
.I /sys/kernel/debug/tracing/events/kvm
فهرست شده‌اند، می‌توانند به‌صورت ایستا با استفاده از فایل پیکربندی
.B pmdakvm
یعنی
.IR /etc/pcp/kvm/kvm.conf
پیکربندی شوند.
.SH "نصب (INSTALLATION)"
در صورت تمایل، نقاط ردیابی را در فایل پیکربندی تنظیم کرده،
سپس با استفاده از اسکریپت Install به‌عنوان کاربر ریشه (root)، کارگزار KVM PMDA را نصب کنید:
.sp 1
.RS +4
.ft B
.nf
# cd $PCP_PMDAS_DIR/kvm
# ./Install
.fi
.ft P
.RE
.sp 1
برای حذف نصب، کارهای زیر را به‌عنوان کاربر ریشه (root) انجام دهید:
.sp 1
.RS +4
.ft B
.nf
# cd $PCP_PMDAS_DIR/kvm
# ./Remove
.fi
.ft P
.RE
.sp 1
\fBpmdakvm\fR توسط \fIpmcd\fR(1) راه‌اندازی می‌شود و هرگز نباید مستقیماً
اجرا شود. اسکریپت‌های Install و Remove هنگامی که
کارگزار نصب یا حذف می‌شود، به \fIpmcd\fR(1) اطلاع می‌دهند.
.SH "هشدارها (CAVEATS)"
هنگامی که
.B pmdakvm
در حال اجرا است، ارجاعاتی به منابع هسته در درایور دستگاه KVM را نگه می‌دارد.
بنابراین، بارگیری مجدد یا تخلیهٔ ماژول درایور دستگاه در حین اجرای PMDA امکان‌پذیر نیست.
روال ایده‌آل برای بارگیری مجدد ماژول هسته، برعکس روندی است که در بخش «نصب (INSTALLATION)» در بالا توضیح داده شده است \-
یعنی ابتدا
.BR ./Remove
را اجرا کنید، سپس ماژول هسته را دوباره بارگیری نمایید،
و در نهایت
.BR ./Install
را اجرا کنید.
.SH "فایل‌ها (FILES)"
.IP "\fB$PCP_SYSCONF_DIR/kvm/kvm.conf\fR" 4
فایل پیکربندی برای کارگزار \fBpmdakvm\fR
.IP "\fB$PCP_PMDAS_DIR/kvm/Install\fR" 4
اسکریپت نصب برای کارگزار \fBpmdakvm\fR
.IP "\fB$PCP_PMDAS_DIR/kvm/Remove\fR" 4
اسکریپت حذف نصب برای کارگزار \fBpmdakvm\fR
.IP "\fB$PCP_LOG_DIR/pmcd/kvm.log\fR" 4
فایل لاگ پیش‌فرض برای پیام‌های خطای \fBpmdakvm\fR
.SH "محیط PCP (PCP ENVIRONMENT)"
متغیرهای محیطی با پیشوند \fBPCP_\fR برای پارامتریک‌سازی نام فایل‌ها و
دایرکتوری‌های مورد استفاده توسط \fBPCP\fR به کار می‌روند. در هر نصب،
فایل \fB/etc/pcp.conf\fR شامل مقادیر محلی برای این متغیرها است.
متغیر \fB$PCP_CONF\fR می‌تواند برای تعیین یک فایل پیکربندی جایگزین
استفاده شود، همان‌طور که در \fIpcp.conf\fR(5) شرح داده شده است.
.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 kvm (1).

.\" control lines for scripts/man-spell
.\" +ok+ pmdakvm KVM kvm sys