'\"macro stdmacro
.\"
.\" Copyright (c) 1997 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 MPVIS 1 "" "Performance Co-Pilot"
.SH "نام (NAME)"
\f3mpvis\f1 \- بصری‌سازی میزان بهره‌وری و کارایی پردازنده (CPU)
.\" literals use .B or \f3
.\" arguments use .I or \f2
.SH "خلاصه دستور (SYNOPSIS)"
\f3mpvis\f1
[\f3\-biV\f1]
[\f3\-r\f1 \f2rowlength\f1]
[\f3\-R\f1 \f2rowlength\f1]
[\f2گزینه‌های pmview\f1]
[\f2cpuid ...\f1]
.SH "توضیحات (DESCRIPTION)"
ابزار
.B mpvis
یک نمودار میله‌ای سه‌بعدی از میزان مصرف پردازنده (CPU utilization) را نمایش می‌دهد.
این نمایشگر با مقادیر جدید دریافت شده از
.I host
یا
.I archive
هدف در هر
.I interval
ثانیه (پیش‌فرض ۲ ثانیه است) به‌روزرسانی می‌شود.
.PP
ارتفاع میله‌ها متناسب با میزان مصرف پردازنده در هر یک از حالت‌های زیر است:
.B idle
(بدون I/O در انتظار)،
.B wait
(بیکار، اما در انتظار I/O \- تنها در IRIX قابل مشاهده است)،
.B intr
(پردازش وقفه \- تنها در IRIX قابل مشاهده است)،
.B nice
(وضعیت nice \- تنها در لینوکس قابل مشاهده است)،
.B sys
(در هسته سیستم‌عامل) و
.BR user .
.PP
تعداد پردازنده‌ها در هر ردیف از صحنه توسط حداکثر طول پیش‌فرض ردیف و گزینه‌های
\f3\-b\f1،
\f3\-r\f1
و
\f3\-R\f1
تعیین می‌شود. اگر هیچ‌یک از این فلگ‌ها مشخص نشده باشند،
\f3mpvis\f1
از حداکثر طول پیش‌فرض ردیف برای محاسبه تعداد واقعی ردیف‌ها و ستون‌ها در نما استفاده می‌کند، طبق فرمول:

.nf
	nrows = (ncpus + maxrowlen - 1) / maxrowlen
	ncols = (ncpus + nrows - 1) / nrows.
.fi

گزینه
\f3\-r\f1
از الگوریتم فوق استفاده می‌کند، اما به کاربر اجازه می‌دهد حداکثر طول ردیف را لغو کرده و مقدار دلخواه را تعیین نماید.
.PP
پردازنده‌ها به ترتیب صعودی مرتب می‌شوند. آن‌ها از چپ به راست و از جلو به عقب (در صورتی که بیش از یک ردیف پردازنده وجود داشته باشد) نمایش داده می‌شوند.
.PP
کاربر می‌تواند فهرستی از پردازنده‌ها را به‌عنوان آرگومان‌های
\f2cpuid\f1
با استفاده از طرح نام‌گذاری گزارش‌شده توسط دستور زیر مشخص کند:
.sp 0.5v
.ft CR
.ti 1i
$ pminfo -f kernel.percpu.cpu.user
.sp 0.5v
.ft R
یعنی
\c
.BI cpu N
یا
.BI cpu A : B
بسته به نسخه سیستم‌عامل و پلتفرم.
همچنین اگر آرگومان
.I cpuid
شامل یکی از نویسه‌های
.B ^
یا
.B .
یا
.B [
باشد، آن‌گاه
.I cpuid
به‌عنوان یک عبارت باقاعده (regular expression) به سبک
.BR egrep (1)
در نظر گرفته می‌شود و مجموعه منطبق از نام‌های پردازنده‌ها به‌جای
.IR cpuid
استفاده خواهد شد.
.PP
اگر یک یا چند آرگومان
.I cpuid
مشخص شده باشد، تنها پردازنده‌های موجود در این فهرست در نما نمایش داده می‌شوند. فهرست پردازنده‌ها به ترتیب صعودی شماره پردازنده مرتب شده و از چپ به راست و از جلو به عقب (در صورتی که بیش از یک ردیف پردازنده باشد) نمایش داده می‌شوند.
.PP
ابزار
.B mpvis
یک فایل پیکربندی برای
.BR pmview (1)
تولید می‌کند و اکثر گزینه‌های خط فرمان را به
.BR pmview (1)
ارسال می‌نماید. بنابراین، گزینه‌های خط فرمان
.BR \-A ،
.BR \-a ،
.BR \-C ،
.BR \-h ،
.BR \-n ،
.BR \-O ،
.BR \-p ،
.BR \-S ،
.BR \-t ،
.BR \-T ،
.BR \-Z
و
.BR \-z ،
و همچنین رابط کاربری در صفحه راهنمای
.BR pmview (1)
شرح داده شده‌اند.
.SH "گزینه‌های خط فرمان (COMMAND LINE OPTIONS)"
گزینه‌های اختصاصی
.B mpvis
عبارتند از:
.IP \f3\-b\f1 4n
استفاده از نسبت ۱:۸ برای ردیف:ستون. این گزینه برای تعداد زیاد پردازنده‌ها بهترین کارایی را دارد. اگر طول ردیف مضربی از تعداد پردازنده‌ها نباشد، آخرین ردیف کوتاه‌تر از سایر ردیف‌ها خواهد بود. این گزینه حداکثر طول ردیف را نادیده می‌گیرد.
.IP \f3\-i\f1
برچسب‌گذاری هر ستون پردازنده با شماره CPU.
.IP \f3\-r\f1
تقسیم نما به تعدادی ردیف، که هر ردیف حداکثر طولی برابر با \f2n\f1 پردازنده داشته باشد. این یک محدودیت نرم (soft limit) است. طول واقعی ردیف توسط الگوریتمی (توضیحات بالا را ببینید) محاسبه می‌شود که یک نمای متعادل با حداکثر \f2n\f1 پردازنده در هر ردیف ایجاد می‌کند.
.IP \f3\-R\f1
تقسیم نما به تعدادی ردیف، که هر ردیف طولی دقیقاً برابر با \f2n\f1 پردازنده داشته باشد. این یک محدودیت سخت (hard limit) است. اگر طول ردیف مضربی از تعداد پردازنده‌ها نباشد، آخرین ردیف کوتاه‌تر از سایر ردیف‌ها خواهد بود.
.IP \f3\-V\f1
حالت با جزئیات (Verbose) \- خروجی فایل پیکربندی تولیدشده برای
.BR pmview (1).
.SH "راه‌اندازی (LAUNCH)"
رفتار
.BR pmchart (1)
هنگامی که از
.B mpvis
راه‌اندازی می‌شود، وابسته به تعداد پردازنده‌ها در هر ردیف است. اگر بیش از ۶ پردازنده در یک ردیف وجود داشته باشد، هر نمودار حاوی یک متریک مجزا خواهد بود؛ در غیر این صورت هر نمودار حاوی یک نمونه مجزای CPU خواهد بود.
.SH "فایل‌ها (FILES)"
.PD 0
.TP 10
.BI $PCP_VAR_DIR/config/pmlogger/config.mpvis
یک فایل پیکربندی
.BR pmlogger (1)
برای متریک‌های
.B mpvis.
.TP
.B $PCP_SHARE_DIR/lib/pmview-args
رویه‌های شل برای تجزیه گزینه‌های خط فرمان
.BR pmview (1).
.PD
.SH "محیط PCP (PCP ENVIRONMENT)"
متغیرهای محیطی با پیشوند
.B PCP_
برای پارامتریک کردن نام فایل‌ها و دایرکتوری‌های مورد استفاده PCP به کار می‌روند.
در هر نصب، فایل
.I /etc/pcp.conf
حاوی مقادیر محلی برای این متغیرها است.
متغیر
.B $PCP_CONF
می‌تواند برای تعیین یک فایل پیکربندی جایگزین استفاده شود، همان‌گونه که در
.BR pcp.conf (4)
توصیف شده است.
.SH "همچنین ببینید (SEE ALSO)"
.BR dkvis (1),
.BR nfsvis (1),
.BR pmcd (1),
.BR pmchart (1),
.BR pmlogger (1)
و
.BR pmview (1).
.P
نمای
.B CPU
برای
.BR pmchart (1).