'\"macro stdmacro
.\"
.\" Copyright (c) 2014-2016,2025 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 PCP 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
\f3pcp\f1,
\f3pcp-summary\f1 \- اجرای یک دستور یا خلاصه‌سازی وضعیت نصب
.SH "خلاصه دستور (SYNOPSIS)"
\f3pcp\f1
[pcp options...]
\f2pcp-command\f1
[command options...]
.br
\f3pcp\f1
[\f3\-LPV?\f1]
[\f3\-a\f1 \f2archive\f1]
[\f3\-D\f1 \f2debug\f1]
[\f3\-h\f1 \f2host\f1]
[\f3\-O\f1 \f2origin\f1]
[\f3\-n\f1 \f2pmnsfile\f1]
.SH "توضیحات (DESCRIPTION)"
دستور
.B pcp
در یکی از دو حالت استفاده می‌شود.
به‌طور پیش‌فرض، خلاصه‌ای از وضعیت نصب Performance Co-Pilot (PCP) را روی میزبان محلی ارائه می‌دهد.
این حالت همچنین می‌تواند برای خلاصه‌سازی وضعیت نصب از یک
.IR host
راه دور، یا یک نصب تاریخی از مجموعه‌ای از
.IR archive ‌های
PCP به کار رود.
این حالت در صورت عدم درخواست هر دستور دیگری، به‌طور غیرمستقیم
.I دستور
.B pcp-summary
را فراخوانی می‌کند.
.PP
در حالت دیگر، می‌توان یک
.I command
(دستور) را به
.B pcp
ارسال کرد تا اجرا شود؛ این اجرا نیز ممکن است در زمینه یک
.I host
راه دور یا مجموعه‌ای از
.IR archive ‌های
تاریخی صورت گیرد.
.SH "حالت دستور (COMMAND MODE)"
هنگامی که
.B pcp
همراه با دستوری برای اجرا فراخوانی شود، به دنبال
.IR command
نام‌برده‌شده در
.B $PCP_BINADM_DIR
و همچنین
.B $HOME/.pcp/bin
می‌گردد (این‌ها معمولاً اسکریپت هستند و با پیشوند «\-pcp» نصب می‌شوند).
این حالت عملیاتی اجازه می‌دهد تا ابزارهای کارایی سیستم با استفاده از خدمات
.BR PMAPI (3)
پیاده‌سازی شوند، در حالی که تمام گزینه‌های معمول خط فرمان آن‌ها حفظ می‌شود.
بدین ترتیب، این گزینه‌ها (به‌طور غیرمستقیم) با مجموعه گزینه‌های استاندارد PCP که در
.BR PCPIntro (1)
شرح داده شده، ارتقا می‌یابند.
.PP
این سازوکار روشی مناسب برای دستیابی به قابلیت‌های پایش گذشته‌نگر یا از راه دور فراهم می‌کند، در حالی که رفتار ابزارهای سیستم دست‌نخورده باقی می‌ماند.
.PP
برای نمونه، ابزار
.BR pcp-free (1)
را می‌توان برای داده‌های ثبت‌شده از میزبان
.IR munch
به صورت زیر فراخوانی کرد:
.PP
.nf
.ft CR
$ pcp \-a $PCP_LOG_DIR/pmlogger/\fImunch\fP/20140317 \-O 11:35:50am \fBfree \-m\fP
             total       used       free     shared    buffers     cached
Mem:         23960      14554       9406          0        176       2137
-/+ buffers/cache:      12240      11720
Swap         12047          0      12047
.ft R
.fi
.PP
فهرست کاملی از ابزارهای موجود و نصب‌شده همراه با پیام راهنمای نحوه استفاده از
.BR pcp (1)
ارائه شده است، اما چند نمونه از آن‌ها عبارتند از:
.BR pcp-free (1)،
.BR pcp-uptime (1)
و
.BR pcp-numastat (1).
.SH "حالت خلاصه (SUMMARY MODE)"
گزارش خلاصه شامل موارد زیر است: نسخه سیستم‌عامل، خلاصه‌ای از موجودی سخت‌افزار، منطقه زمانی محلی، نسخه نرم‌افزار PCP، وضعیت فرایند
.BR pmcd (1)
و عامل‌های دامنه معیارهای کارایی (PMDA) مرتبط، و همچنین اطلاعاتی درباره هر بایگان محلی PCP (\c
.BR pmlogger (1))،
بایگان‌های راه دور PCP (\c
.BR pmproxy (1))
و موتورهای استنتاج PCP (\c
.BR pmie (1))
که در حال اجرا هستند.
.PP
تمامی مقادیر نمایش‌داده‌شده، مقادیر
.I metric
(معیار) کارایی هستند و اطلاعات بیشتر برای هر یک را می‌توان با استفاده از دستور زیر به دست آورد:
.in 1.0i
.ft CR
.nf

$ pminfo \-dtT \f2metric\f1

.fi
.ft R
.in
مجموعه کامل
.IR metric ‌ها
که برای تولید خروجی
.B pcp
مورد نیاز است، در
.B $PCP_VAR_DIR/config/pmlogconf/tools/pcp-summary
قرار دارد.
.SH "گزینه‌های حالت خلاصه (SUMMARY MODE OPTIONS)"
بدون هیچ آرگومانی،
.B pcp
وضعیت میزبان محلی را گزارش می‌کند؛ با این حال، گزینه‌های زیر پذیرفته می‌شوند:
.TP 5
\fB\-a\fR \fIarchive\fR, \fB\-\-archive\fR=\fIarchive\fR
گزارش پیکربندی PCP همان‌گونه که در مجموعه آرشیوهای PCP، یعنی
.IR archive ،
شرح داده شده است؛ که یک فهرست جداشده با کاما از نام‌ها است و هر یک از آن‌ها می‌تواند نام پایه یک آرشیو یا نام دایرکتوری شامل یک یا چند آرشیو باشد.
.TP
\fB\-h\fR \fIhost\fR, \fB\-\-host\fR=\fIhost\fR
گزارش پیکربندی PCP روی
.I host
به‌جای میزبان محلی.
.TP
\fB\-L\fR, \fB\-\-local\-PMDA\fR
استفاده از یک زمینه محلی برای جمع‌آوری معیارها از PMDAهای DSO روی میزبان محلی بدون نیاز به PMCD.
.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
درون پنجره زمانی.
.TP
\fB\-P\fR, \fB\-\-pmie\fR
نمایش اطلاعات کارایی
.BR pmie (1)
\- شمارش قواعدی که به «درست» (true)، «نادرست» (false) یا «نامعین» (indeterminate) ارزیابی شده‌اند، به همراه نرخ مورد انتظار برای محاسبه قواعد، به ازای هر فرایند
.B pmie
در حال اجرا روی میزبان پیش‌فرض.
برای جزئیات کامل در مورد این مقادیر، به متن راهنمای هر یک از معیارها مراجعه کنید.
.TP
\fB\-V\fR, \fB\-\-version\fR
نمایش شماره نسخه و خروج.
.TP
\fB\-?\fR, \fB\-\-help\fR
نمایش پیام راهنما و خروج.
.SH "خطاها (DIAGNOSTICS)"
.B pcp
در صورتی که
.B pmcd
روی میزبان هدف در دسترس نباشد یا مجموعه آرشیوها قابل باز شدن نباشد با وضعیت خروج
.B 1
و برای هر خطای دیگر با
.B 2
به کار خود پایان می‌دهد.
.SH "فایل‌ها (FILES)"
.TP 5
.I $HOME/.pcp/bin
مکان مختص هر کاربر برای اسکریپت‌های
.IR command .
.TP
.I $PCP_BINADM_DIR
مکان سیستمی برای اسکریپت‌های
.IR command
نصب‌شده.
.TP
.I $PCP_VAR_DIR/config/pmlogconf/tools/pcp-summary
فایل پیکربندی
.BR pmlogconf (1)
برای جمع‌آوری تمام معیارهای مورد نیاز توسط
.BR 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 pcp-free (1),
.BR pcp-numastat (1),
.BR pcp-python (1),
.BR pcp-uptime (1),
.BR pcp-verify (1),
.BR pmcd (1),
.BR pmie (1),
.BR pmlogconf (1),
.BR pmlogger (1),
.BR pmproxy (1),
.BR pcp.conf (5),
.BR pcp.env (5)
و
.BR PMNS (5).

.\" control lines for scripts/man-spell
.\" +ok+ Mem dtT {from pminfo -dtT} numastat {from pcp-numstat}