'\" t
.\"
.\" 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 PMINFO 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
\f3pminfo\f1 \- نمایش اطلاعات مربوط به معیارهای کارایی
.SH "خلاصه دستور (SYNOPSIS)"
\fBpminfo\fR
[\fB\-defFIlLmMstTvVxz1?\fR]
[\fB\-a\fR \fIarchive\fR]
[\fB\-b\fR \fIbatchsize\fR]
[\fB\-c\fR \fIdmfile\fR]
[\fB\-\-container\fR \fIname\fR]
[\f3\-D\f1 \f2debug\f1]
[\fB\-h\fR \fIhostname\fR]
[\fB\-K\fR \fIspec\fR]
[\fB\-\fR[\fBn\fR|\fBN\fR] \fIpmnsfile\fR]
[\fB\-O\fR \fItime\fR]
[\fB\-r\fR \fIdmname\fR=\fIexpr\fR]
[\fB\-Z\fR \fItimezone\fR]
[\fImetricname\fR | \fIpmid\fR | \fIindom\fR]...
.SH "توضیحات (DESCRIPTION)"
دستور
.B pminfo
انواع مختلفی از اطلاعات را درباره معیارهای کارایی که از طریق امکانات Performance Co-Pilot (PCP) در دسترس هستند، نمایش می‌دهد.
.PP
معیارهای مورد نظر در آرگومان‌های
.I metricname
مشخص می‌شوند.
اگر
.I metricname
یک گره غیربرگ در PMNS باشد،
.B pminfo
به صورت بازگشتی در PMNS پیمایش کرده و تمام گره‌های برگ را گزارش می‌دهد.
اگر هیچ آرگومان
.I metricname
ارائه نشود، از ریشه PMNS استفاده می‌شود.
.PP
اگر آرگومان
.I metricname
در قالب نمادگذاری عددی نقطه‌دار باشد، یا به عنوان یک
.I pmid
سه-نقطه‌ای (شناسه معیار \- شماره‌های دامنه، خوشه و قلم) یا یک
.I indom
دو-نقطه‌ای (شناسه دامنه نمونه \- دامنه، شماره سریال) تفسیر می‌شود.
در حالت
.IR pmid ،
یک جستجوی معکوس PMID-به-نام انجام می‌شود و در حالت
.IR indom ،
دامنه نمونه به صورت مستقیم گزارش می‌شود.
از این حالت اخیر می‌توان برای گزارش خلاصه‌های متن راهنمای دامنه نمونه به شکل «یک‌خطی» یا قالب کامل استفاده کرد.
.PP
مگر اینکه توسط گزینه \fB\-h\fR به یک میزبان دیگر هدایت شود، به‌طور پیش‌فرض
.B pminfo
با دیمن جمع‌آورنده معیارهای کارایی (PMCD) در میزبان محلی ارتباط برقرار می‌کند.
اتصال به یک PMCD تنها زمانی لازم است که
.B pminfo
به اطلاعات توزیع‌شده PMNS، و/یا فراداده‌های توصیف‌کننده معیارها، و/یا مقادیر معیار، و/یا متن راهنما نیاز داشته باشد.
.PP
گزینه \fB\-a\fR باعث می‌شود
.B pminfo
به جای اتصال به یک PMCD، از مجموعه آرشیوهای مشخص‌شده استفاده کند.
.PP
گزینه \fB\-L\fR باعث می‌شود
.B pminfo
از یک بافت محلی برای جمع‌آوری معیارها از PMDAها روی میزبان محلی بدون نیاز به PMCD استفاده کند.
تنها برخی از معیارها در این حالت در دسترس هستند.
.PP
گزینه‌های \fB\-a\fR، \fB\-h\fR و \fB\-L\fR با یکدیگر مانعة‌الجمع هستند.
.SH "گزینه‌ها (OPTIONS)"
گزینه‌های خط فرمان موجود عبارتند از:
.TP 5
\fB\-a\fR \fIarchive\fR, \fB\-\-archive\fR=\fIarchive\fR
مقادیر معیارهای کارایی از مجموعه فایل‌های آرشیو Performance Co-Pilot (PCP) مشخص‌شده توسط آرگومان
.I archive
بازیابی می‌شوند؛ این آرگومان فهرستی از نام‌ها است که با کاما از هم جدا شده‌اند و هر کدام می‌تواند نام پایه یک آرشیو یا نام پوشه‌ای حاوی یک یا چند آرشیو باشد.
.TP
\fB\-b\fR, \fB\-\-batch\fR
این گزینه می‌تواند برای تعیین حداکثر تعداد معیارهای قابل دریافت در یک درخواست منفرد برای گزینه‌های \fB\-f\fR و \fB\-v\fR استفاده شود.
مقدار پیش‌فرض برای
.I batchsize
برابر ۱۲۸ است.
.TP
\fB\-c\fR \fIdmfile\fR, \fB\-\-derived\fR=\fIdmfile\fR
آرگومان
.I dmfile
فایلی را مشخص می‌کند که شامل تعاریف معیارهای مشتق‌شده در قالبی است که برای
.BR pmLoadDerivedConfig (3)
توضیح داده شده است.
گزینه \fB\-c\fR روشی را برای بارگذاری تعاریف سراسری معیارهای مشتق‌شده فراهم می‌کند که جایگزینی برای استفاده عمومی‌تر از متغیر محیطی
.B PCP_DERIVED_CONFIG
(همان‌طور که در
.BR PCPIntro (1)
شرح داده شده) محسوب می‌شود.
استفاده هم‌زمان از گزینه \fB\-c\fR و متغیر محیطی
.B PCP_DERIVED_CONFIG
برای مشخص کردن پیکربندی
.B یکسان
ایده مناسبی نیست، بنابراین یکی از این دو روش را انتخاب کنید.
همچنین گزینه
.B \-r
در زیر را ببینید.
.TP
\fB\-\-container\fR=\fIcontainer\fR
مشخص کردن یک
.I container
خاص برای پرس‌وجو.
.TP
\fB\-d\fR, \fB\-\-desc\fR
توضیحات معیارها شامل جزئیات مربوط به PMID، نوع داده، معناشناسی داده، واحدها، مقیاس و دامنه نمونه مرتبط.
.TP
\fB\-1\fR, \fB\-\-desc-oneline\fR
مشابه
.B \-d
است، با این تفاوت که توضیحات معیار به صورت یک خط به ازای هر معیار و با فیلدهایی که با تب (\et) جدا شده‌اند
(بدون متن نام فیلد)
قالب‌بندی می‌شوند.
این قالب برای اسکریپت‌هایی مناسب است که از خروجی
.BR pminfo
استفاده می‌کنند.
.TP
\fB\-e\fR, \fB\-\-metadata-errors\fR
مشابه
.B \-v
است، اما معیارهایی را که هیچ مقداری برنمی‌گردانند گزارش نمی‌کند؛ بنابراین هر معیاری که گزارش شود دارای خطاهای پایدار یا فراداده‌های ناسازگار است.
.TP
\fB\-f\fR, \fB\-\-fetch\fR
دریافت و چاپ مقادیر برای تمام نمونه‌ها.
هنگام دریافت اطلاعات از مجموعه‌ای از آرشیوها، تنها آن نمونه‌هایی که در نخستین رکورد آرشیو برای یک معیار وجود دارند نمایش داده می‌شوند؛
همچنین گزینه \fB\-O\fR را ببینید، در غیر این صورت از
.BR pmlogdump (1)
استفاده کنید که ممکن است ابزار مناسب‌تری برای بررسی آرشیوها باشد.
.TP
\fB\-F\fR, \fB\-\-fetchall\fR
مشابه
.B \-f
است، اما تلاش بیشتری برای دریافت نمونه‌ها در معیارهایی که دامنه‌های نمونه غیرقابل شمارش دارند (مانند معیارهای موجود در زیردرخت «proc» از PMNS پیش‌فرض در برخی سیستم‌ها) انجام می‌دهد.
.TP
\fB\-h\fR \fIhost\fR, \fB\-\-host\fR=\fIhost\fR
دریافت معیارهای کارایی از
.BR pmcd (1)
روی
.IR host ،
به جای localhost پیش‌فرض.
.TP
\fB\-I\fR, \fB\-\-fullindom\fR
چاپ InDom در حالت پرحرف (verbose).
.TP
\fB\-K\fR \fIspec\fR, \fB\-\-spec\-local\fR=\fIspec\fR
هنگام استفاده از گزینه \fB\-L\fR برای دریافت معیارها از یک بافت محلی، این گزینه DSO PMDAهایی را که باید در دسترس قرار گیرند کنترل می‌کند.
آرگومان
.I spec
از نحوی که در
.BR pmSpecLocalPMDA (3)
شرح داده شده، پیروی می‌کند.
می‌توان از بیش از یک گزینه \fB\-K\fR استفاده کرد.
.TP
\fB\-l\fR, \fB\-\-labels\fR
چاپ مجموعه‌های برچسب مرتبط با معیارها و نمونه‌ها.
برچسب‌ها فراداده‌های اختیاری معیار هستند که جزئیات آن‌ها در
.BR pmLookupLabels (3)
توضیح داده شده است.
.TP
\fB\-L\fR, \fB\-\-local\-PMDA\fR
استفاده از یک بافت محلی برای جمع‌آوری معیارها از DSO PMDAها روی میزبان محلی بدون نیاز به PMCD.
همچنین ببینید:
.BR \-K .
.TP
\fB\-m\fR, \fB\-\-pmid\fR
چاپ PMID در حالت مختصر (terse).
.TP
\fB\-M\fR, \fB\-\-fullpmid\fR
چاپ PMID در حالت پرحرف (verbose)..TP
\fB\-n\fR \fIpmnsfile\fR, \fB\-\-namespace\fR=\fIpmnsfile\fR
به‌طور معمول
.B pminfo
روی فضای نام معیارهای کارایی (PMNS) توزیع‌شده عمل می‌کند، اما اگر گزینهٔ \fB\-n\fR مشخص شود، یک PMNS محلی جایگزین از فایل
.I pmnsfile
بارگذاری می‌شود.
.TP
\fB\-N\fR \fIpmnsfile\fR, \fB\-\-uniqnames\fR=\fIpmnsfile\fR
گزینهٔ \fB\-N\fR عملکردی مشابه با \fB\-n\fR دارد، به جز در نحوهٔ مدیریت نام‌های تکراری برای یک شناسه معیار کارایی (PMID) یکسان در
.I pmnsfile
\- نام‌های تکراری با \fB\-n\fR مجاز هستند، اما با \fB\-N\fR مجاز نمی‌باشند.
.TP
\fB\-O\fR \fItime\fR, \fB\-\-origin\fR=\fItime\fR
هنگامی که در ترکیب با یک منبع آرشیو از معیارها و گزینه‌های \fB\-f/\fR استفاده شود، آرگومان
.I time
یک مبدأ زمانی را مشخص می‌کند که در آن معیارها باید از مجموعهٔ آرشیوها واکشی شوند.
برای توضیحات کامل دربارهٔ این گزینه و ساختار نحوی آرگومان
.IR time ،
به
.BR PCPIntro (1)
مراجعه کنید.
.TP
\fB\-r\fR \fIdmname\fR=\fIexpr\fR, \fB\-\-register\fR=\fIdmname\fR=\fIexpr\fR
ثبت یک معیار اشتقاقی به‌ازای زمینه با استفاده از
.BR pmAddDerivedMetric (3).
.I dmname
نام معیار اشتقاقی جدید است و
.I expr
عبارت مربوط به معیار اشتقاقی است که از ساختار نحوی شرح داده شده در
.BR pmRegisterDerived (3)
پیروی می‌کند.
استفاده از چندین گزینهٔ
.B \-r
مجاز است.
همچنین گزینهٔ
.B \-c
در بالا را ببینید.
.TP
\fB\-s\fR, \fB\-\-series\fR
شناسه‌های سری زمانی مرتبط با معیارها، نمونه‌ها و منابع را چاپ می‌کند.
این شناسه‌های یکتا بر اساس برچسب‌های ذاتی (غیر اختیاری) و سایر فراداده‌های معیار مرتبط با هر زمینهٔ PMAPI (منابع)، معیارها و نمونه‌ها محاسبه می‌شوند.
اتصالات آرشیو، زمینهٔ محلی یا
.BR pmcd (1)
برای یک میزبان یکسان همگی شناسهٔ منبع یکسانی را تولید می‌کنند.
همچنین
.BR pmLookupLabels (3)
و گزینهٔ \fB\-l\fR را ببینید.
.TP
\fB\-t\fR, \fB\-\-oneline\fR
چاپ خلاصهٔ راهنمای «یک‌خطی»، در صورت موجود بودن.
.TP
\fB\-T\fR, \fB\-\-helptext\fR
چاپ متن راهنما، در صورت موجود بودن.
.TP
\fB\-v\fR, \fB\-\-verify\fR
حالت راستی‌آزمایی که در آن شرح‌ها و مقادیر بازیابی می‌شوند، اما فقط شرایط خطا گزارش می‌گردد.
این گزینه در سکوت هرگونه خروجی از گزینه‌های
\fB\-f\fR/\fB\-\-fetch\fR،
\fB\-l\fR/\fB\-\-labels\fR،
\fB\-I\fR/\fB\-\-fullindom\fR،
\fB\-M\fR/\fB\-\-fullpmid\fR،
\fB\-m\fR/\fB\-\-pmid\fR،
\fB\-t\fR/\fB\-\-oneline\fR
و
\fB\-T\fR/\fB\-\-helptext\fR
را غیرفعال می‌کند.
.TP
\fB\-V\fR, \fB\-\-version\fR
نمایش شمارهٔ نسخه و خروج.
.TP
\fB\-x\fR, \fB\-\-events\fR
مانند گزینهٔ \fB\-f\fR/\fB\-\-fetch\fR، اما با این قابلیت اضافی که اگر مقداری پردازش شود که از نوع PM_TYPE_EVENT یا PM_TYPE_HIGHRES_EVENT باشد، رکوردهای رویداد بازگشایی شده و جزئیات هر رکورد رویداد گزارش خواهد شد.
.TP
\fB\-z\fR, \fB\-\-hostzone\fR
تغییر منطقهٔ زمانی گزارش به منطقهٔ زمانی محلی میزبانی که منبع معیارهای کارایی است، همان‌طور که از طریق گزینه‌های
.B \-h
یا
.B \-a
شناسایی شده است.
.TP
\fB\-Z\fR \fItimezone\fR, \fB\-\-timezone\fR=\fItimezone\fR
به‌طور پیش‌فرض،
.B pminfo
زمان روز را مطابق با منطقهٔ زمانی محلی سامانه‌ای که
.B pminfo
روی آن اجرا می‌شود گزارش می‌دهد.
گزینهٔ
.B \-Z
منطقهٔ زمانی را به
.I timezone
در قالب متغیر محیطی TZ همان‌گونه که در
.BR environ (7)
شرح داده شده تغییر می‌دهد.
.TP
\fB\-?\fR, \fB\-\-help\fR
نمایش پیام نحوهٔ استفاده و خروج.
.SH "فایل‌ها (FILES)"
.TP 5
.I $PCP_VAR_DIR/pmns/*
فایل‌های مشخصات محلی پیش‌فرض PMNS
.SH "محیط پی‌سی‌پی (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
برای به‌دست آوردن فهرستی از گزینه‌های اشکال‌زدایی موجود و مفهوم آن‌ها استفاده کنید.
.PP
گزینه‌های اشکال‌زدایی مخصوص
.B pminfo
به شرح زیر است:
.TS
box;
lf(B) | lf(B)
lf(B) | lxf(R) .
گزینه	توضیحات
_
appl4	T{
گزارش کوچک‌سازی دسته در صورتی که \fIbatchsize\fP از حداکثر اندازهٔ PDU تجاوز کند
T}
_
appl5	تخلیهٔ آمار PDU در پایان، اگر context یک میزبان باشد
.TE
.SH "همچنین ببینید (SEE ALSO)"
.BR PCPIntro (1),
.BR pmcd (1),
.BR pmchart (1),
.BR pmlogdump (1),
.BR pmprobe (1),
.BR pmrep (1),
.BR pmval (1),
.BR PMAPI (3),
.BR pmAddDerivedMetric (3),
.BR pmGetOptions (3),
.BR pmLoadDerivedConfig (3),
.BR pmLookupLabels (3),
.BR pmRegisterDerived (3),
.BR pmSpecLocalPMDA (3),
.BR PMNS (5),
.BR pcp.conf (5)
و
.BR pcp.env (5).