'\" t
.\"
.\" Copyright (c) 2006, Ken McDonell.  All Rights Reserved.
.\" Copyright (c) 2008, Aconex.  All Rights Reserved.
.\" Copyright (c) 2014-2016,2019, 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 PMCHART 1 "" "Performance Co-Pilot"
.SH "نام (NAME)"
\f3pmchart\f1 \- ابزار نمودار نواری برای Performance Co-Pilot
.SH "خلاصه دستور (SYNOPSIS)"
\f3pmchart\f1
[\f3\-CLVWz?\f1]
[\f3\-a\f1 \f2archive\f1]
[\f3\-A\f1 \f2align\f1]
[\fB\-\-archive\-folio\fP \fIfolio\fP]
[\f3\-c\f1 \f2configfile\f1]
[\f3\-D\f1 \f2debug\f1]
[\f3\-f\f1 \f2fontfamily\f1]
[\f3\-F\f1 \f2fontsize\f1]
[\f3\-g\f1 \f2geometry\f1]
[\f3\-h\f1 \f2host\f1]
[\f3\-n\f1 \f2pmnsfile\f1]
[\f3\-o\f1 \f2outfile\f1]
[\f3\-O\f1 \f2offset\f1]
[\f3\-p\f1 \f2port\f1]
[\f3\-s\f1 \f2samples\f1]
[\f3\-S\f1 \f2starttime\f1]
[\f3\-t\f1 \f2interval\f1]
[\f3\-T\f1 \f2endtime\f1]
[\f3\-v\f1 \f2visible\f1]
[\f3\-Z\f1 \f2timezone\f1]
[\f3\-geometry\f1 \f2geometry\f1]
[\f2sources\f1...]
.SH "توضیحات (DESCRIPTION)"
ابزار
.B pmchart
یک ابزار گرافیکی است که مقادیر معیارهای کارایی ارائه‌شده از طریق امکانات Performance Co-Pilot (PCP) را رسم می‌کند.
می‌توان چندین نمودار را به طور همزمان نمایش داد، چه به صورت تراز شده روی محور زمان یکپارچه (محور X)، و چه از طریق استفاده از چندین برگه رابط کاربری.
.PP
مقادیر معیارها را می‌توان از یک یا چند میزبان زنده (به طور همزمان) دریافت کرد.
همچنین، می‌توان یک یا چند مجموعه از آرشیوهای PCP را به عنوان منبع داده‌های تاریخی به کار برد.
برای بحث دقیق درباره قابلیت‌های چارچوب PCP که بسیاری از آن‌ها توسط
.B pmchart
استفاده می‌شوند، به
.BR PCPIntro (1)
مراجعه کنید.
.PP
بسیاری از جنبه‌های رفتاری
.B pmchart
از طریق رابط کاربری قابل سفارشی‌سازی هستند.
به ویژه، استفاده از «نماها» (به بخش تشریح نماها در ادامه این سند مراجعه کنید)
اجازه می‌دهد مجموعه‌های از پیش تعریف‌شده معیارها و پارامترهای نمودار مانند رنگ‌ها، مقیاس‌بندی، عناوین، راهنماها و غیره را برای استفاده‌های بعدی، یا استفاده با میزبان‌ها و مجموعه‌های آرشیو مختلف ذخیره کرد.
علاوه بر این، کادر محاوره‌ای تنظیمات (Preferences) امکان می‌دهد سفارشی‌سازی‌های سایر بخش‌های رابط کاربری
.B pmchart
ذخیره شده و بین اجراهای مختلف ابزار بازیابی شوند.
این امر امکان پیکربندی رنگ پس‌زمینه پیش‌فرض، رنگ برجسته‌سازی، محتویات و موقعیت نوار ابزار و بسیاری از جنبه‌های دیگر را فراهم می‌سازد.
.PP
ابزار
.B pmchart
استفاده گسترده‌ای از ابزار کمکی
.BR pmtime (1)
برای کنترل زمان به عمل می‌آورد؛ برای جزئیات بیشتر درباره نحوه عملکرد آن به صفحه راهنمای
.B pmtime
مراجعه کنید.
.SH "گزینه‌ها (OPTIONS)"
گزینه‌های موجود خط فرمان عبارتند از:
.TP 5
\fB\-a\fR \fIarchive\fR, \fB\-\-archive\fR=\fIarchive\fR
به صورت پیش‌فرض، مقادیر معیارهای کارایی از مجموعه آرشیوهای Performance Co-Pilot
(PCP) مشخص‌شده با این گزینه بازیابی می‌شوند.
آرگومان ورودی فهرستی از نام‌هاست که با کاما از هم جدا شده‌اند؛ هر یک می‌تواند نام پایه یک آرشیو یا نام پوشه‌ای حاوی یک یا چند آرشیو باشد.
مجموعه آرشیوهای حاصل، منبع معیارهای کارایی خواهند بود.
برگه اولیه ایجادشده یک برگه در حالت آرشیو خواهد بود.
می‌توان چندین گزینه
.B \-a
را مشخص کرد و فهرست حاصل از مجموعه‌های آرشیو برای دریافت مقادیر معیار استفاده می‌شود.
در صورت استفاده از این گزینه، هر یک از
.I sources
ذکرشده در خط فرمان به عنوان مجموعه‌ای از آرشیوها فرض می‌شوند.
.TP
\fB\-A\fR \fIalign\fR, \fB\-\-align\fR=\fIalign\fR
نمونه اولیه را مجبور می‌کند که روی مرز یک واحد زمانی طبیعی
.I align
تراز شود.
برای توضیح کامل ساختار
.IR align ،
به
.BR PCPIntro (1)
مراجعه کنید.
.TP
\fB\-\-archive\-folio\fR=\fIfolio\fR
آرشیوهای منبع معیار را از فولیوی آرشیو PCP به نام
.I folio
می‌خواند.
.TP
\fB\-c\fR \fIconfigfile\fR, \fB\-\-view\fR=\fIconfigfile\fR
فایل
.I configfile
یک نمای اولیه را برای بارگذاری با استفاده از منبع پیش‌فرض معیارها مشخص می‌کند.
می‌توان چندین نمای
.B \-c
را مشخص کرد و همه آن‌ها در برگه پیش‌فرض با منبع پیش‌فرض معیارها باز خواهند شد.
.TP
\fB\-C\fR, \fB\-\-check\fR
هنگامی که همراه با
.B \-c
استفاده شود، نما(ها) تجزیه شده، هرگونه خطایی گزارش می‌شود و ابزار خارج می‌گردد.
این گزینه در درجه اول برای اهداف آزمایشی در نظر گرفته شده است.
اگر گزینه دوم
.B \-C
ارائه شود،
.B pmchart
همچنین به
.BR pmcd (1)
متصل می‌شود تا معناشناسی معیارها را بررسی کند.
.TP
\fB\-f\fR \fIfamily\fR, \fB\-\-font-family\fR=\fIfamily\fR
خانواده قلم پیش‌فرض
.I family
را برای استفاده در چندین مؤلفه نمودار، مانند عنوان نمودار، راهنما و برچسب محور Y مشخص می‌کند.
مقدار پیش‌فرض "Sans Serif" است.
این تنظیم روی بقیه رابط کاربری تأثیری ندارد؛ در آن بخش‌ها مقدار از محیطی که
.B pmchart
در آن اجرا می‌شود به ارث می‌رسد و بر اساس ظاهر و حس هر پلتفرم متفاوت است.
.TP
\fB\-F\fR \fIpoint\fR, \fB\-\-font-size\fR=\fIpoint\fR
اندازه قلم پیش‌فرض
.I point
(بر حسب پوینت) را برای استفاده در چندین مؤلفه نمودار، مانند عنوان نمودار، راهنما و برچسب محور Y مشخص می‌کند.
مقدار پیش‌فرض وابسته به پلتفرم است، اما ۷، ۸ یا ۹ است.
این تنظیم بر بقیه رابط کاربری تأثیری ندارد.
.TP
\fB\-g\fR \fIgeometry\fR, \fB\-\-geometry\fR=\fIgeometry\fR
تصویری با ابعاد مشخص‌شده
.I geometry
(عرض و ارتفاع) تولید می‌کند.
این گزینه تنها زمانی مفید است که همراه با گزینه
.B \-o
برای تولید تصویر خروجی استفاده شود.
آرگومان
.I geometry
به شکل "WxH" (مانند 240x120) است.
هنگامی که از گزینه
.B \-o
استفاده نمی‌شود، برای تعیین ابعاد پنجره نمایش، از
.B \-geometry
.I geometry
استفاده کنید که در آن
.I geometry
عرض، ارتفاع و موقعیت اختیاری پنجره را تعیین می‌کند.
.TP
\fB\-h\fR \fIhost\fR, \fB\-\-host\fR=\fIhost\fR
به صورت پیش‌فرض، مقادیر جاری معیارهای کارایی از ماشین میزبان مشخص‌شده
.I host
بازیابی می‌شوند.
می‌توان چندین گزینه
.B \-h
ارائه داد و از فهرست میزبان‌ها برای دریافت مقادیر معیار استفاده می‌شود.
در صورت استفاده از این گزینه، هر یک از
.I sources
ذکرشده در خط فرمان به عنوان میزبان فرض می‌شوند.
.TP
\fB\-H\fR \fIpath\fR, \fB\-\-hostsfile\fR=\fIpath\fR
مسیر
.I path
به فایلی حاوی مجموعه‌ای از نام‌های میزبان که در آن‌ها
.BR pmcd (1)
در حال اجراست را به جای استفاده از localhost پیش‌فرض مشخص می‌کند.
.TP
\fB\-K\fR \fIspec\fR, \fB\-\-spec\-local\fR=\fIspec\fR
هنگام واکشی معیارها از یک بافت محلی (گزینه
.B \-L
را ببینید)، گزینه
.B \-K
می‌تواند برای کنترل PMDAهای DSO که باید در دسترس قرار گیرند استفاده شود.
آرگومان
.I spec
از نگارش شرح‌داده‌شده در
.BR pmSpecLocalPMDA (3)
پیروی می‌کند.
می‌توان بیش از یک گزینه
.B \-K
به کار برد.
.TP
\fB\-L\fR, \fB\-\-local\-PMDA\fR
از یک بافت محلی برای جمع‌آوری معیارها از PMDAهای DSO روی میزبان محلی بدون PMCD استفاده می‌کند.
همچنین ببینید
.BR \-K .
.TP
\fB\-n\fR \fIpmnsfile\fR, \fB\-\-namespace\fR=\fIpmnsfile\fR
یک فضای نام معیارهای کارایی جایگزین
.RB ( PMNS (5))
را از فایل
.I pmnsfile
بارگذاری می‌کند.
.TP
\fB\-o\fR \fIoutfile\fR, \fB\-\-output\fR=\fIoutfile\fR
یک فایل تصویری به نام
.I outfile
تولید کرده و سپس خارج می‌شود.
این گزینه بیشترین کاربرد را هنگام اجرا با مجموعه‌ای از آرشیوها و یک یا چند نما دارد.
تصویر تولیدشده در قالبی خواهد بود که با پسوند فایل مشخص شده است (به طور خودکار از روی
.I outfile
تشخیص داده می‌شود).
اگر هیچ پسوندی قابل تشخیص نباشد، قالب GIF استفاده می‌شود و فایل تولیدشده با این پسوند نام‌گذاری خواهد شد.
قالب‌های تصویری پشتیبانی‌شده عبارتند از: bmp، jpeg، jpg، png، ppm، tif، tiff، xbm و xpm.
.TP
\fB\-O\fR \fIorigin\fR, \fB\-\-origin\fR=\fIorigin\fR
هنگام گزارش معیارهای آرشیوشده، گزارش‌گیری را از مبدأ
.I origin
در پنجره زمانی آغاز می‌کند (گزینه‌های
.B \-S
و
.B \-T
را ببینید).
برای شرح کامل ساختار
.IR origin ،
به
.BR PCPIntro (1)
مراجعه کنید.
.TP
\fB\-p\fR \fIport\fR, \fB\-\-guiport\fR=\fIport\fR
شماره پورت
.I port
برای اتصال به یک فرآیند موجود کنترل زمان
.BR pmtime .
.TP
\fB\-s\fR \fIsamples\fR, \fB\-\-samples\fR=\fIsamples\fR
تعداد نمونه‌هایی (
.IR samples )
را مشخص می‌کند که قبل از دور ریختن داده‌های قدیمی نگهداری می‌شوند (و با مقادیر جدید در موقعیت زمانی جاری جایگزین می‌شوند).
این مقدار را می‌توان بعداً از طریق کادر محاوره‌ای ویرایش برگه (Edit Tab) تغییر داد.
.TP
\fB\-S\fR \fIstarttime\fR, \fB\-\-start\fR=\fIstarttime\fR
هنگام گزارش معیارهای آرشیوشده، گزارش به رکوردهایی محدود می‌شود که در یا بعد از
.I starttime
ثبت شده‌اند.
برای شرح کامل ساختار
.IR starttime ،
به
.BR PCPIntro (1)
مراجعه کنید.
.TP
\fB\-t\fR \fIinterval\fR, \fB\-\-interval\fR=\fIinterval\fR
بازه به‌روزرسانی اولیه
.I interval
را روی مقداری غیر از مقدار پیش‌فرض ۱ ثانیه تنظیم می‌کند.
آرگومان
.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 \fIsamples\fR, \fB\-\-visible\fR=\fIsamples\fR
تعداد نمونه‌های مرئی اولیه (
.IR samples )
که در تمام نمودارهای برگه پیش‌فرض نمایش داده خواهند شد را تعیین می‌کند.
این مقدار باید کمتر یا مساوی تعداد کل نمونه‌های نگهداری‌شده (مقدار گزینه
.BR \-s )
باشد.
.TP
\fB\-V\fR, \fB\-\-version\fR
شماره نسخه pmchart را نمایش می‌دهد و خارج می‌شود.
.TP
\fB\-W\fR, \fB\-\-white\fR
تصاویر را با پس‌زمینه کدر (سفید) صادر می‌کند.
.TP
\fB\-z\fR, \fB\-\-hostzone\fR
منطقه زمانی گزارش‌گیری را به منطقه زمانی محلی میزبانی تغییر می‌دهد که منبع معیارهای کارایی است، همان‌طور که از طریق گزینه‌های
.B \-h
یا
.B \-a
مشخص شده است.
.TP
\fB\-Z\fR \fItimezone\fR, \fB\-\-timezone\fR=\fItimezone\fR
به صورت پیش‌فرض،
.B pmtime
زمان روز را بر اساس منطقه زمانی محلی سیستمی که
.B pmchart
روی آن اجرا می‌شود گزارش می‌دهد.
گزینه
.B \-Z
منطقه زمانی را به
.I timezone
در قالب متغیر محیطی TZ همان‌طور که در
.BR environ (7)
شرح داده شده تغییر می‌دهد.
.TP
\fB\-?\fR, \fB\-\-help\fR
پیام راهنمای استفاده را نمایش می‌دهد و خارج می‌شود.
.SH "نماها (VIEWS)"
فایل پیکربندی اصلی
.B pmchart
همان «نما» (view) است که امکان می‌دهد فراداده‌های مرتبط با یک یا چند نمودار در سیستم فایل ذخیره شوند.
این فراداده تمام جنبه‌های نمودارها را توصیف می‌کند، از جمله اینکه کدام معیارها و نمونه‌های PCP باید استفاده شوند، کدام میزبان‌ها، چه رنگ‌هایی، عناوین نمودار، استفاده از راهنمای نمودار و موارد بسیار دیگر.
.PP
از یک دیدگاه مفهومی، دو دسته نما وجود دارد.
این نماها از یک قالب فایل پیکربندی یکسان استفاده می‌کنند \- برای شرح کامل این قالب به بخش‌های بعدی مراجعه کنید.
تفاوت آن‌ها در محل نصب و نحوه مدیریت آن‌ها نهفته است.
.PP
دسته اول، نمای «سیستمی» (system)، هر نمایی است که به عنوان بخشی از بسته
.B pmchart
نصب شده باشد.
این نماها در مسیر
.I $PCP_VAR_DIR/config/pmchart
ذخیره می‌شوند.
هنگامی که کادر محاوره‌ای
.I "File\(->Open View"
نمایش داده می‌شود، این نماها هستند که در ابتدا فهرست می‌گردند.
نماهای سیستمی توسط یک کاربر عادی قابل تغییر نیستند، و حتی نباید توسط کاربری با دسترسی‌های کافی نیز تغییر داده شوند، زیرا در طول ارتقای بسته بازنویسی خواهند شد.
.PP
دسته دوم نماها، نمای «کاربر» (user) است.
این نماها به صورت بلادرنگ با استفاده از کادر محاوره‌ای
.I "File\(->Save View"
ایجاد می‌شوند.
این مکانیزمی برای کاربران منفرد است تا نماهای پرکاربرد خود را ذخیره کنند.
دسترسی به این نماها همانند نماهای سیستمی از طریق کادر محاوره‌ای
.I "File\(->Open View"
انجام می‌شود.
پس از باز شدن کادر محاوره‌ای، فهرست نماها را می‌توان با کلیک روی دو دکمه ضامن در گوشه بالا سمت راست بین نماهای کاربر و سیستمی جابه‌جا کرد.
نماهای کاربر در مسیر
.I $HOME/.pcp/pmchart
ذخیره می‌شوند.
.SH "برگه‌ها (TABS)"
ابزار
.B pmchart
مفهوم رایج برگه (Tab) در رابط کاربری را ارائه می‌دهد که بیش از همه در مرورگرهای وب امروزی متداول است.
برگه‌ها به
.B pmchart
اجازه می‌دهند نمودارهای بسیار بیشتری را نسبت به فضای واقعی موجود در صفحه نمایش به‌روزرسانی کند؛ این کار با ارائه یک مکانیزم رابط کاربری برای روی هم چیدن (و جابه‌جایی میان) مجموعه‌های عمودی مختلف نمودارها میسر می‌شود.
جابه‌جایی بین برگه‌ها با کلیک روی برچسب‌های برگه انجام می‌شود که در بالای صفحه نمایش و زیر نوارهای منو و ابزار قرار دارند.
.PP
هر برگه یک حالت عملیاتی دارد (چه زنده یا آرشیو \-
.B pmchart
می‌تواند از هر دو حالت به طور همزمان پشتیبانی کند)، تعداد کل نمونه‌ها و نقاط در حال حاضر مرئی، و برچسبی برای توصیف برگه که در بالای پنجره
.B pmchart
نمایش داده می‌شود.
برگه‌های جدید را می‌توان با استفاده از کادر محاوره‌ای
.I "File\(->Add Tab"
ایجاد کرد.
.PP
به منظور صرفه‌جویی در فضای عمودی صفحه نمایش، توجه داشته باشید که عنصر رابط کاربری برای جابه‌جایی بین برگه‌های مختلف (و برچسب آن) تنها زمانی نمایش داده می‌شود که بیش از یک برگه وجود داشته باشد.
یک برگه را می‌توان با استفاده از منوی
.I "File\(->Close Tab"
بست، که برگه جاری و تمام نمودارهای موجود در آن را حذف می‌کند.
.SH "تصاویر و چاپ (IMAGES and PRINTING)"
یک نسخه ایستا از سری عمودی نمودارهای در حال نمایش را می‌توان به دو روش ثبت کرد.
.PP
هنگامی که دستگاه نمایش مورد نظر صفحه نمایش باشد، باید از گزینه منوی
.I "File\(->Export"
استفاده شود.
این کار اجازه می‌دهد نمودارها در قالب‌های تصویری گوناگونی از جمله PNG، JPEG، GIF و BMP صادر شوند.
اندازه تصویر را می‌توان در هر بُعدی بزرگ یا کوچک کرد.
.PP
از طرف دیگر، هنگامی که دستگاه نمایش مورد نظر کاغذ باشد، می‌توان از گزینه منوی
.I "File\(->Print"
استفاده کرد.
این گزینه از مجموعه معمول گزینه‌های چاپ (انتخاب چاپگر، سیاه‌وسفید/رنگی، افقی/عمودی، مقیاس‌بندی برای اندازه‌های مختلف کاغذ و غیره) پشتیبانی می‌کند،
و علاوه بر این امکان چاپ در قالب‌های واسط چاپگر مانند PostScript و Portable Document Format (PDF) را فراهم می‌سازد.
.SH "ضبط (RECORDING)"
امکان ضبط مجموعه‌ای از نمودارهای نمایش داده‌شده وجود دارد تا بعداً از طریق
.B pmchart
یا هر یک از ابزارهای دیگر Performance Co-Pilot بازپخش شوند.
قابلیت
.I "Record\(->Start"
به سادگی از طریق رابط کاربری پیکربندی می‌شود و امکان تنظیم دقیق فرآیند ضبط را فراهم می‌کند (از جمله بسامدهای ضبط متفاوت با بازه به‌روزرسانی
.BR pmchart ،
مسیرهای فایل جایگزین و غیره).
.PP
ابزار
.B pmchart
ضبط‌هایی تولید می‌کند که با سازوکار بازپخش
.BR pmafm (1)
در PCP سازگار است، تا بعداً از طریق نمونه جدیدی از
.B pmchart
پخش شوند.
علاوه بر این، هنگام ضبط از طریق
.B pmchart
می‌توان ضبط را بلافاصله نیز بازپخش کرد، زیرا در پایان ضبط (از طریق گزینه منوی
.IR "Record\(->Stop" )،
یک برگه در حالت آرشیو با نمای ثبت‌شده ایجاد خواهد شد.
.PP
به محض اینکه ضبط در یک برگه زنده فعال شود، دکمه وضعیت کنترل زمان در گوشه پایین سمت چپ پنجره
.B pmchart
با یک نقطه قرمز متمایز نمایش داده می‌شود.
در هر زمان طی یک نشست ضبط
.BR pmchart ،
میزان فضای مصرف‌شده در سیستم فایل توسط آن ضبط را می‌توان با استفاده از گزینه منوی
.I "Record\(->Query"
مشاهده کرد.
.PP
در نهایت، گزینه منوی
.I "Record\(->Detach"
مکانیزمی فراهم می‌کند که از طریق آن فرآیند ضبط می‌تواند کاملاً از فرآیند در حال اجرای
.B pmchart
جدا شده و پس از خروج
.B pmchart
نیز ادامه یابد.
کادر محاوره‌ای نمایش‌دهنده اندازه جاری و نرخ رشد تخمینی برای ضبط نمایش داده می‌شود.
از سوی دیگر، اگر
.B pmchart
در حین انجام ضبط متوقف شود، فرآیند ضبط از کاربر می‌خواهد توقف فوری ضبط یا ادامه مستقل آن را انتخاب کند.
.PP
تمامی خدمات حالت ضبط موجود در
.B pmchart
با کمک خدمات پایه‌ای ثبت وقایع (لاگین) Performance Co-Pilot پیاده‌سازی شده‌اند \- برای شرح گسترده قابلیت‌های این ابزارها به
.BR pmlogger (1)
و
.BR pmafm (1)
مراجعه کنید.
.SH "ساختار فایل پیکربندی (CONFIGURATION FILE SYNTAX)"
.de ES
.ft CR
.nf
.in +0.5i
..
.de EE
.ft R
.br
.in
.fi
..
ابزار
.B pmchart
پیکربندی‌های از پیش تعریف‌شده نمودار (یا «نماها») را از فایل‌های خارجی بارگذاری می‌کند که از قوانین زیر پیروی می‌کنند.
در توضیحات زیر، کلمات کلیدی (که به صورت \f(CBبولد\fP نشان داده شده‌اند) می‌توانند با حروف بزرگ، کوچک یا ترکیبی ظاهر شوند، مواردی که به صورت \f(CR[stuff]\fP نشان داده شده‌اند اختیاری هستند و موارد ارائه‌شده توسط کاربر به شکل \f(CR<other stuff>\fP نمایش داده می‌شوند.
علامت خط عمودی (|) در جایی استفاده می‌شود که عناصر نحوی جایگزین یکدیگر باشند.
از گیومه (") می‌توان برای محصور کردن عناصر واژگانی که ممکن است دارای فاصله خالی باشند، مانند عناوین، برچسب‌ها و نام‌های نمونه استفاده کرد.
.IP 1. 0.3i
سطر اول نوع فایل پیکربندی را مشخص می‌کند و باید به صورت زیر باشد:
.ES
\f(CB#kmchart\fP
.EE
اگرچه
.B pmchart
سازگاری عقروعلی با قالب‌های قدیمی‌تر نمای
.B pmchart
را با سطر اولیه زیر نیز فراهم می‌کند:
.ES
\f(CB#pmchart\fP
.EE
.IP 2. 0.3i
پس از سطر اول، سطرهایی که اولین نویسه غیرفاصله آن‌ها "#" باشد به عنوان کامنت در نظر گرفته شده و نادیده گرفته می‌شوند.
همچنین سطرهای خالی نادیده گرفته می‌شوند.
.IP 3. 0.3i
سطر بعدی باید به این صورت باشد:
.ES
\f(CBversion\fP <n> <host-clause>
.EE
که در آن \f(CR<n>\fP به نوع فایل پیکربندی بستگی دارد و برای \f(CBpmchart\fP برابر \f(CB1\fP است، در غیر این صورت برای \f(CBpmchart\fP برابر \f(CB1.1\fP، \f(CB1.2\fP یا \f(CB2.0\fP خواهد بود.
.RS
بخش \f(CR<host-clause>\fP برای فایل‌های پیکربندی \fBpmchart\fP اختیاری (و نادیده‌گرفته‌شده) است، اما برای فایل‌های پیکربندی \fBpmchart\fP الزامی بوده و به شکل زیر است:
.ES
\f(CBhost\fP \f(CBliteral\fP
.EE
یا
.ES
\f(CBhost\fP \f(CBdynamic\fP
.EE
.RE
.IP 4. 0.3i
یک پیکربندی شامل یک یا چند نمودار است که به شرح زیر تعریف می‌شوند:
.ES
\f(CBchart\fP [\f(CBtitle\fP <title>] \f(CBstyle\fP <style> <options>
.EE
در صورت تعیین، عنوان در مرکز و بالای ناحیه نمودار ظاهر می‌شود.
مقدار \f(CR<title>\fP معمولاً در گیومه (") قرار می‌گیرد و اگر شامل توالی "%h" باشد، با شکل کوتاه نام میزبان برای منبع پیش‌فرض معیارها در زمان بارگذاری این نمودار جایگزین می‌شود.
همچنین، "%H" را می‌توان برای درج نام کامل میزبان استفاده کرد.
اگر نام میزبان یک نشانی inet یا IPv6 باشد، هیچ تلاشی برای کوتاه‌سازی انجام نخواهد شد؛ در هر دو حالت جایگزینی، همان‌طور که هست استفاده می‌شود.
پس از بارگذاری نما، قابلیت مشاهده و تنظیم عنوان را می‌توان با استفاده از کادر متنی
.I "Chart Title"
در کادر محاوره‌ای
.I "Edit\(->Chart"
تغییر داد.
.RS
.PP
شناسه \f(CR<style>\fP سبک رسم اولیه نمودار را کنترل می‌کند و باید یکی از کلمات کلیدی \f(CBplot\fP (نمودار خطی)، \f(CBbar\fP، \f(CBstacking\fP (میله‌ای انباشته)، \f(CBarea\fP یا \f(CButilization\fP باشد.
پس از بارگذاری نما، سبک رسم را می‌توان با استفاده از فهرست کشویی Style در
.I "Edit\(->Chart"
تغییر داد.
.PP
گزینه‌های \f(CR<options>\fP صفر یا چند مورد از عناصر اختیاری زیر هستند:
.ES
[\f(CBscale\fP [from] <ymin> [to] <ymax>] [\f(CBlegend\fP <onoff>]
.EE
اگر \f(CBscale\fP مشخص شده باشد، مقیاس عمودی برای تمام رسم‌های نمودار روی محدوده y تعریف‌شده توسط \f(CR<ymin>\fP و \f(CR<ymax>\fP تنظیم می‌شود.
در غیر این صورت، محور عمودی بر اساس مقادیری که در حال حاضر رسم می‌شوند به صورت خودکار مقیاس‌بندی خواهد شد.
.PP
مقدار \f(CR<onoff>\fP یکی از کلمات کلیدی \f(CBon\fP یا \f(CBoff\fP است و عبارت \f(CBlegend\fP وجود یا عدم وجود راهنمای نمودار در زیر ناحیه نمودار را کنترل می‌کند.
حالت پیش‌فرض، نمایش راهنما است.
پس از بارگذاری نما، قابلیت مشاهده راهنما را می‌توان با استفاده از دکمه
.I "Show Legend"
در کادر محاوره‌ای
.I "Edit\(->Chart"
تغییر داد.
.RE
.IP 5. 0.3i
ابزار
.B pmchart
از یک عبارت \f(CBglobal\fP برای مشخص کردن ابعاد پنجره سطح بالا (با استفاده از کلمات کلیدی \f(CBwidth\fP و \f(CBheight\fP)، تعداد نقاط مرئی (کلمه کلیدی \f(CBpoints\fP) و موقعیت‌های شروع محورهای X و Y روی صفحه نمایش (کلمات کلیدی \f(CBxpos\fP و \f(CBypos\fP) پشتیبانی می‌کند.
هر یک از این ویژگی‌های \f(CBglobal\fP یک مقدار عدد صحیح را به عنوان تنها تعیین‌کننده می‌پذیرد.
.IP 6. 0.3i
هر \f(CBchart\fP دارای یک یا چند رسم مرتبط با خود است که توسط یکی از مشخصات زیر تعریف می‌شوند:
.ES
\f(CBplot\fP
    [\f(CBlegend\fP <title>] [\f(CBcolor\fP <colorspec>] [\f(CBhost\fP <hostspec>]
    \f(CBmetric\fP <metricname>
    [ \f(CBinstance\fP <inst> | \f(CBmatching\fP <pat> | \f(CBnot-matching\fP <pat> ]
.EE
.RS
.PP
کلمه کلیدی \f(CBplot\fP می‌تواند با کلمه کلیدی \f(CBoptional-plot\fP جایگزین شود، که در این صورت اگر منبع داده‌های کارایی شامل معیار کارایی یا نمونه مشخص‌شده نباشد، این رسم بدون خطا و در سکوت از نمودار حذف می‌شود.
.PP
در صورت تعیین، عنوان در راهنمای نمودار ظاهر خواهد شد.
مقدار \f(CR<title>\fP معمولاً در گیومه (") قرار می‌گیرد و می‌تواند شامل یک یا چند نویسه عام (wildcard) باشد که با استفاده از نام معیار، نام نمونه و نام میزبان برای آن رسم بسط می‌یابند.
نویسه‌های عام عبارتند از: "%i" (نام کوتاه و یکتای نمونه، تا اولین فاصله خالی)، "%I" (نام کامل نمونه)، "%h" (نام کوتاه میزبان، تا اولین نقطه)، %H (نام کامل میزبان)، "%m" (نام معیار کوتاه‌شده به دو مؤلفه نهایی PMNS) و "%M" (نام کامل معیار).
.PP
برای فایل‌های پیکربندی قدیمی‌تر
.BR pmchart ،
کلمه کلیدی \f(CBtitle\fP باید به جای \f(CBlegend\fP استفاده شود.
امروزه
.B pmchart
از هر دو کلمه کلیدی پشتیبانی می‌کند.
.PP
عبارت \f(CBcolor\fP برای فایل‌های پیکربندی جدیدتر
.B pmchart
اختیاری است، اما در قالب فایل پیکربندی اولیه
.B pmchart
اجباری بود.
شناسه \f(CR<colorspec>\fP می‌تواند یکی از موارد زیر باشد:
.ES
\f(CB#\-cycle\fP
\f(CBrgbi:\fPrr\f(CB:\fPgg\f(CB:\fPbb
\f(CB#\fPrgb
\f(CB#\fPrrggbb
\f(CB#\fPrrrgggbbb
\f(CB#\fPrrrrggggbbbb
<Xcolor>
.EE
که در آن هر یک از \f(CRr\fP، \f(CRg\fP و \f(CRb\fP ارقام هگزادسیمال (0-9 و A-F) هستند که به ترتیب مؤلفه‌های رنگ قرمز، سبز و آبی را نشان می‌دهند.
مقدار \f(CR<Xcolor>\fP یکی از نام‌های رنگ از پایگاه‌داده رنگ X است، مانند \f(CBred\fP یا \f(CBsteelblue\fP؛ همچنین خروجی
.BR showrgb (1)
را ببینید.
.PP
رنگ \f(CB#\-cycle\fP مشخص می‌کند که
.B pmchart
باید از رنگ بعدی در یک پالت رنگی استفاده کند که به صورت چرخشی برای هر نمودار به کار می‌برد.
اگر عبارت \f(CBcolor\fP حذف شود، این حالت پیش‌فرض است.
.PP
مقدار \f(CR<hostspec>\fP در عبارت \f(CBhost\fP می‌تواند یک نام میزبان، یک نشانی IP یا یک ستاره (*) باشد؛ ستاره به معنای منبع پیش‌فرض معیارهای کارایی استفاده می‌شود.
برای فایل‌های پیکربندی قدیمی‌تر
.BR pmchart ،
عبارت \f(CBhost\fP باید وجود داشته باشد؛ برای فایل‌های پیکربندی جدید
.B pmchart
اختیاری است و در صورت عدم وجود، از منبع پیش‌فرض معیارهای کارایی استفاده خواهد شد.
.PP
مشخصات اختیاری نمونه:
.IP (a) 0.3i
حذف می‌شود که در این صورت یک رسم برای هر نمونه از معیار \f(CR<metricname>\fP ایجاد خواهد شد
.IP (b) 0.3i
با \f(CBinstance\fP شروع می‌شود، که در این صورت تنها نمونه با نام \f(CR<inst>\fP رسم خواهد شد
.IP (c) 0.3i
با \f(CBmatching\fP شروع می‌شود، که در این صورت تمام نمونه‌هایی که نام آن‌ها با الگوی \f(CR<pat>\fP مطابقت دارد رسم خواهند شد؛ این الگو از نمادگذاری عبارات باقاعده گسترده به سبک
.BR egrep (1)
استفاده می‌کند (به عنوان مثال به نمای PMCD مراجعه کنید)
.IP (d) 0.3i
با \f(CBnot-matching\fP شروع می‌شود، که در این صورت تمام نمونه‌هایی که نام آن‌ها با الگوی \f(CR<pat>\fP مطابقت
.B ندارد
رسم خواهند شد؛ این الگو از نمادگذاری عبارات باقاعده گسترده به سبک
.BR egrep (1)
استفاده می‌کند (به عنوان مثال به نمای Netbytes مراجعه کنید)
.PP
ابزار
.B pmchart
از یک نمادگذاری نحوی نامعمول استفاده می‌کند که در آن \f(CR<inst>\fP و \f(CR<pat>\fP از اولین نویسه غیرفاصله تا انتهای سطر ورودی امتداد می‌یابند.
برای فایل‌های پیکربندی
.B pmchart
این عناصر با فاصله خالی از هم جدا می‌شوند، یا در گیومه (") محصور می‌گردند.
.RE
.IP 7. 0.3i
دستورالعمل اختیاری \f(CBtab\fP می‌تواند برای ایجاد نماهایی با چندین نمودار که در چندین برگه گسترده شده‌اند استفاده شود.
ساختار آن به صورت زیر است:
.ES
\f(CBtab\fP <label> [\f(CBhost\fP <host>] [\f(CBpoints\fP <points> [\f(CBsamples\fP <samples>]]
.EE
.RS
.ES
.PP
تمام مشخصات نمودار پس از این کلمه کلیدی، تا انتهای فایل پیکربندی یا تا زمانی که کلمه کلیدی \f(CBtab\fP دیگری یافت شود، روی برگه جدید ایجاد خواهند شد.
.SH "محیط PCP (PCP ENVIRONMENT)"
متغیرهای محیطی با پیشوند \fBPCP_\fP برای پارامتریک کردن نام فایل‌ها و پوشه‌های مورداستفاده PCP به کار می‌روند.
در هر نصب، فایل \fI/etc/pcp.conf\fP حاوی مقادیر محلی این متغیرها است.
متغیر \fB$PCP_CONF\fP می‌تواند برای مشخص کردن فایل پیکربندی جایگزین استفاده شود، همان‌طور که در \fBpcp.conf\fP(5) شرح داده شده است.
.PP
نکته قابل توجه این است که تنظیم
.B $PCP_XCONFIRM_PROG
به صراحت و بدون قید و شرط توسط
.B pmchart
بازنویسی می‌شود.
این متغیر روی ابزار
.BR pmconfirm (1)
تنظیم می‌شود، تا برخی از کادرهای محاوره‌ای بازشو (به‌ویژه در بخش ضبط) ظاهر و حس یکسانی با سایر بخش‌های برنامه
.B pmchart
داشته باشند.
.SH "گزینه‌های اشکال‌زدایی (DEBUGGING OPTIONS)"
گزینه
.B \-D
یا
.B \-\-debug
خروجی عیب‌یابی‌های اضافی را روی
.I stderr
فعال می‌کند تا به تفکیک و دسته‌بندی مشکلات کمک کند، اگرچه اطلاعات گاهی رمزی بوده و در درجه اول برای راهنمایی توسعه‌دهندگان است تا کاربران نهایی.
شناسه
.I debug
فهرستی از گزینه‌های اشکال‌زدایی است که با کاما از هم جدا شده‌اند؛ از
.BR pmdbg (1)
با گزینه
.B \-l
استفاده کنید تا فهرستی از گزینه‌های اشکال‌زدایی موجود و معانی آن‌ها را به دست آورید.
.PP
گزینه‌های اشکال‌زدایی ویژه
.B pmchart
عبارتند از:
.TS
box;
lf(B) | lf(B)
lf(B) | lf(R) .
Option	توضیحات
_
appl2	تجزیه و بارگذاری نما
_
appl3	اسکنر واژگانی از تجزیه نما
.TE
.SH "همچنین ببینید (SEE ALSO)"
.BR PCPIntro (1),
.BR pmafm (1),
.BR pmconfirm (1),
.BR pmdumptext (1),
.BR pminfo (1),
.BR pmrep (1),
.BR pmtime (1),
.BR pmval (1),
.BR pcp.conf (5)
و
.BR PMNS (5).

.\" control lines for scripts/man-spell
.\" +ok+ BMP Netbytes PNG PostScript Serif WxH Xcolor autoscaled bmp
.\" +ok+ rrggbb rrrgggbbb rrrrggggbbbb rr gg bb {from <colorspec>}
.\" +ok+ colorspec hostspec
.\" +ok+ inet jpeg jpg kmchart metricname onoff png ppm rgb rgbi
.\" +ok+ showrgb steelblue tif xbm xpm
.\" +ok+ xpos ymax ymin ypos