'\"macro stdmacro
.\"
.\" Copyright (c) 2016,2019 Red Hat.
.\" Copyright (c) 2000 Silicon Graphics, Inc.  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 PMCLIENT 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
\f3pmclient\f1,
\f3pmclient_fg\f1 \- یک کلاینت ساده برای معیارهای کارایی
.SH "خلاصه دستور (SYNOPSIS)"
\f3pmclient\f1
[\f3\-PVz?\f1]
[\f3\-a\f1 \f2archive\f1]
[\f3\-A\f1 \f2align\f1]
[\f3\-D\f1 \f2debug\f1]
[\f3\-h\f1 \f2host\f1]
[\f3\-n\f1 \f2pmnsfile\f1]
[\f3\-O\f1 \f2origin\f1]
[\f3\-s\f1 \f2samples\f1]
[\f3\-S\f1 \f2starttime\f1]
[\f3\-t\f1 \f2interval\f1]
[\f3\-T\f1 \f2endtime\f1]
[\f3\-Z\f1 \f2timezone\f1]
.sp
\f3pmclient_fg\f1
\&...
.SH "توضیحات (DESCRIPTION)"
برنامه‌های
.B pmclient
و
.B pmclient_fg
کلاینت‌های ساده‌ای هستند که از رابط برنامه‌نویسی نرم‌افزار معیارهای کارایی (PMAPI) برای گزارش برخی از معیارهای سطح بالای کارایی سیستم استفاده می‌کنند.
.PP
ارزش واقعی این ابزارها به عنوان کلاینت‌های نمونه‌ای است که از رابط‌های
.BR PMAPI (3)
استفاده می‌کنند؛ به همین منظور کد منبع آن‌ها در بستهٔ Performance Co-Pilot (PCP) گنجانده شده است (ببینید
.BR PCPIntro (1))
و معمولاً در مسیر
.IR /usr/share/pcp/demos/pmclient
نصب می‌شود.
.PP
تفاوت برنامهٔ
.B pmclient_fg
با
.B pmclient
در این است که از افزونهٔ fetchgroup API برای PMAPI استفاده می‌کند؛ ببینید
.BR pmFetchGroup (3).
.PP
در حالت عادی،
.B pmclient
روی فضای نام توزیع‌شدهٔ معیارهای کارایی (PMNS) کار می‌کند؛ با این حال، اگر گزینهٔ
.B \-n
مشخص شود، یک PMNS محلی جایگزین از فایل
.I pmnsfile
بارگذاری می‌شود.
.PP
مگر در مواردی که با گزینهٔ
.B \-h
به یک میزبان دیگر هدایت شود، یا با گزینهٔ
.B \-a
به یک بایگانی،
.B pmclient
برای دریافت اطلاعات مورد نیاز با دیمن جمع‌آوری معیارهای کارایی (PMCD) روی میزبان محلی ارتباط برقرار می‌کند.
آرگومان گزینهٔ
.B \-a
فهرستی از نام‌ها با جداکنندهٔ ویرگول است که هر کدام می‌تواند نام پایهٔ یک بایگانی یا نام دایرکتوری حاوی یک یا چند بایگانی باشد.
گزینه‌های
.B \-a
و
.B \-h
مانعة‌الجمع هستند.
.PP
به‌طور پیش‌فرض،
.B pmclient
زمان روز را بر اساس منطقهٔ زمانی محلی روی سیستمی که
.B pmclient
در آن اجرا می‌شود گزارش می‌کند.
گزینهٔ
.B \-Z
منطقهٔ زمانی را به
.I timezone
در قالب متغیر محیطی
.B TZ
مطابق با آنچه در
.BR environ (7)
شرح داده شده است، تغییر می‌دهد.
گزینهٔ
.B \-z
منطقهٔ زمانی را به منطقهٔ زمانی محلی در میزبانی که منبع معیارهای کارایی است (مشخص‌شده با گزینهٔ
.B \-h
یا
.BR \-a )
تغییر می‌دهد.
.PP
خروجی
.B pmclient
به خروجی استاندارد هدایت می‌شود و موارد زیر را فهرست می‌کند:
.IP + 3
مجموع استفاده از CPU، در محدودهٔ ۰ تا ۱.
.IP +
اگر سیستم بیش از ۱ پردازنده داشته باشد، شماره ترتیبی شلوغ‌ترین پردازنده، در محدودهٔ ۰ تا ...
.IP +
اگر سیستم بیش از ۱ پردازنده داشته باشد، میزان استفاده از پردازنده برای شلوغ‌ترین پردازنده.
.IP +
حافظهٔ آزاد واقعی به مگابایت.
.IP +
مجموع عملیات ورودی/خروجی دیسک فیزیکی در ثانیه (IOPS).
.IP +
میانگین بار سیستم (load average) در ۱ دقیقهٔ گذشته و در ۱۵ دقیقهٔ گذشته.
.SH "گزینه‌ها (OPTIONS)"
گزینه‌های خط فرمان موجود عبارتند از:
.TP 5
\fB\-a\fR \fIarchive\fR, \fB\-\-archive\fR=\fIarchive\fR
مقادیر معیارهای کارایی از مجموعه فایل‌های بایگانی Performance Co-Pilot (PCP) که با آرگومان
.I archive
مشخص شده‌اند بازیابی می‌شوند؛ این آرگومان فهرستی از نام‌ها با جداکنندهٔ ویرگول است که هر کدام می‌تواند نام پایهٔ یک بایگانی یا نام دایرکتوری شامل یک یا چند بایگانی باشد.
.TP
\fB\-A\fR \fIalign\fR, \fB\-\-align\fR=\fIalign\fR
نمونه‌گیری اولیه را وادار می‌کند تا بر مرز یک واحد زمانی طبیعی
.I align
تنظیم (تراز) شود. برای شرح کامل نحو
.IR align ،
به
.BR PCPIntro (1)
مراجعه کنید.
.TP
\fB\-h\fR \fIhost\fR, \fB\-\-host\fR=\fIhost\fR
دریافت معیارهای کارایی از
.BR pmcd (1)
روی
.IR host ،
به جای localhost پیش‌فرض.
.TP
\fB\-n\fR \fIpmnsfile\fR, \fB\-\-namespace\fR=\fIpmnsfile\fR
بارگذاری یک فضای نام جایگزین برای معیارهای کارایی
.RB ( PMNS (5))
از فایل
.IR pmnsfile .
.TP
\fB\-O\fR \fIorigin\fR, \fB\-\-origin\fR=\fIorigin\fR
هنگام گزارش معیارهای بایگانی‌شده، گزارش‌دهی را از
.I origin
درون پنجرهٔ زمانی شروع می‌کند (ببینید
.B \-S
و
.BR \-T ).
برای شرح کامل نحو
.IR origin ،
به
.BR PCPIntro (1)
مراجعه کنید.
.TP
.B \-P\fR, \fB\-\-pause\fP
رفتار پیش‌فرض برای بازپخش مجموعه‌ای از بایگانی‌ها، بازپخش با حداکثر سرعت است.
گزینهٔ
.B \-P
می‌تواند همراه با مجموعه‌ای از بایگانی‌ها استفاده شود تا درخواست شود که تأخیر زمان‌واقعی حاکم بین نمونه‌ها اعمال شود (ببینید
.BR \-t )
تا یک مکث ایجاد شود.
.TP
\fB\-s\fR \fIsamples\fR, \fB\-\-samples\fR=\fIsamples\fR
آرگومان
.I samples
تعداد نمونه‌هایی را که باید دریافت و گزارش شوند مشخص می‌کند.
اگر
.I samples
برابر ۰ باشد یا
.B \-s
مشخص نشود،
.B pmclient
به‌صورت پیوسته (در حالت زمان‌واقعی) یا تا انتهای مجموعهٔ بایگانی‌های PCP (در حالت بایگانی) نمونه‌گیری و گزارش خواهد کرد.
.TP
.B \-S\fR \fIstarttime\fR, \fB\-\-start\fR=\fIstarttime\fP
گزینهٔ
.B \-S
می‌تواند همراه با مجموعه‌ای از بایگانی‌ها به کار رود تا درخواست شود نمایش از
.I starttime
نسبت به آغاز بایگانی(ها) شروع شود.
برای شرح کامل نحو
.IR starttime ،
به
.BR PCPIntro (1)
مراجعه کنید.
.TP
.B \-t\fR \fIinterval\fR, \fB\-\-interval\fR=\fIinterval\fP
بازهٔ گزارش‌دهی
.I interval\f1
را به مقداری غیر از مقدار پیش‌فرض ۵ ثانیه تنظیم می‌کند.
آرگومان
.I interval
از نحو شرح داده شده در
.BR PCPIntro (1)
پیروی می‌کند و در ساده‌ترین شکل می‌تواند یک عدد صحیح بدون علامت باشد (واحد ضمنی در این حالت ثانیه است).
.TP
\fB\-T\fR \fIendtime\fR, \fB\-\-finish\fR=\fIendtime\fR
هنگام گزارش معیارهای بایگانی‌شده، گزارش به رکوردهایی محدود خواهد شد که قبل از یا در
.I endtime
ثبت شده‌اند.
برای شرح کامل نحو
.IR endtime ،
به
.BR PCPIntro (1)
مراجعه کنید.
.TP
\fB\-V\fR, \fB\-\-version\fR
نمایش شمارهٔ نسخه و خروج.
.TP
\fB\-z\fR, \fB\-\-hostzone\fR
استفاده از منطقهٔ زمانی محلی میزبانی که منبع معیارهای کارایی است، همان‌طور که با گزینهٔ
.B \-h
یا
.B \-a
مشخص شده است.
حالت پیش‌فرض استفاده از منطقهٔ زمانی میزبان محلی است.
.TP
\fB\-Z\fR \fItimezone\fR, \fB\-\-timezone\fR=\fItimezone\fR
استفاده از
.I timezone
برای تاریخ و زمان.
.I timezone
در قالب متغیر محیطی
.B TZ
است، همان‌گونه که در
.BR environ (7)
شرح داده شده است.
.TP
\fB\-?\fR, \fB\-\-help\fR
نمایش پیام راهنما و خروج.
.SH "فایل‌ها (FILES)"
.TP 5
.I $PCP_DEMOS_DIR/pmclient
کد منبع، مستندات، فایل‌های پیکربندی و Makefile هنگامی که بستهٔ توسعهٔ PCP نصب شده باشد
.SH "محیط PCP (PCP ENVIRONMENT)"
متغیرهای محیطی با پیشوند \fBPCP_\fP برای پارامتریک‌سازی نام فایل‌ها و دایرکتوری‌های مورد استفاده توسط PCP به کار می‌روند.
در هر نصب، فایل \fI/etc/pcp.conf\fP حاوی مقادیر محلی برای این متغیرها است.
متغیر \fB$PCP_CONF\fP می‌تواند برای مشخص کردن یک فایل پیکربندی جایگزین استفاده شود، همان‌طور که در \fBpcp.conf\fP(5) شرح داده شده است.
.PP
برای متغیرهای محیطی اثرگذار بر ابزارهای PCP، به \fBpmGetOptions\fP(3) مراجعه کنید.
.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 pmchart (1),
.BR pmdumptext (1),
.BR pmgenmap (1),
.BR pminfo (1),
.BR pmrep (1),
.BR pmstat (1),
.BR pmval (1),
.BR PMAPI (3),
.BR pmFetchGroup (3),
.BR pcp.conf (5),
.BR pcp.env (5)
و
.BR PMNS (5).

.\" control lines for scripts/man-spell
.\" +ok+ IOPS