'\"macro stdmacro
.\"
.\" Copyright (c) 1995-2001 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 OSVIS 1 "" "Performance Co-Pilot"
.SH "نام (NAME)"
\f3osvis\f1 \- مصورسازی فعالیت‌های سطح بالای سیستم
.SH "خلاصه دستور (SYNOPSIS)"
\f3osvis\f1
[\f3\-V\f1]
[\f3\-b\f1 \f2bytes\f1]
[\f3\-d\f1 \f2activity\f1]
[\f3\-i\f1 \f2ops\f1]
[\f3\-m\f1 \f2packets\f1]
[\f2pmview options\f1]
[\f2interface\f1 ...]
.SH "توضیحات (DESCRIPTION)"
دستور
.B osvis
یک نمای کلی سطح بالا از آمار کارایی جمع‌آوری‌شده از زیرساخت
Performance Co-Pilot
.RB ( PCP (1))
را نمایش می‌دهد. این نمایش بر اساس مقادیر معیارهای کارایی دریافت‌شده از
.I host
هدف (که
.BR pmcd (1)
را اجرا می‌کند) یا از گزارش بایگانی PCP که توسط
.I archive
مشخص شده است، تنظیم می‌گردد. این نمایش هر
.I interval
ثانیه یک‌بار (پیش‌فرض ۲ ثانیه) به‌روزرسانی می‌شود.
.PP
همانند تمامی صحنه‌های
.BR pmview (1)،
هنگامی که موشواره روی یکی از میله‌ها حرکت داده شود، مقدار فعلی و اطلاعات معیار مربوط به آن میله در کادر متنی نزدیک بالای صفحه نمایش داده خواهد شد. ارتفاع و/یا رنگ میله‌ها متناسب با مقادیر معیارهای کارایی نسبت به بیشینه فعالیت مورد انتظار است، که توسط گزینه‌های
.BR \-d ،
.B \-i
و
.B \-m
کنترل می‌شود (پایین را ببینید).
.PP
میله‌ها در صحنه
.B osvis
نمایانگر اطلاعات زیر هستند:
.TP 4
.B "CPU"
این ستون بهره‌برداری از CPU را به‌صورت تجمیع‌شده روی تمامی CPUها نشان می‌دهد.
.TP 4
.B Disk
پشته اول نرخ عملیات خواندن و نوشتن دیسک را به‌صورت تجمیع‌شده روی تمامی دیسک‌ها نشان می‌دهد. میله دوم میانگین زمانی است که دیسک‌ها مشغول بوده‌اند، که تخمینی از میانگین بهره‌برداری زمانی از تمامی دیسک‌ها است.
.TP 4
.B Disk Controllers
میانگین زمانی که دیسک‌ها روی هر کنترل‌کننده مشغول بوده‌اند، که تخمینی از میانگین بهره‌برداری زمانی از تمامی دیسک‌ها روی هر کنترل‌کننده است.
.TP 4
.B Load
این سه میله میانگین بار کاری (load average) را برای ۱، ۵ و ۱۵ دقیقه گذشته نشان می‌دهند. این مقدار با دو برابر تعداد CPUهای موجود در سامانه نرمال‌سازی می‌شود.
.TP 4
.B Mem
این پشته بهره‌برداری از حافظه را با تفکیک حافظه واقعی به کاربردهای هسته، سیستم‌فایل و کاربر نشان می‌دهد. معیارهای بهره‌برداری از حافظه
.RI ( mem.util )
ممکن است روی همه میزبان‌ها در دسترس نباشند، بنابراین
.B Mem
ممکن است در برخی میزبان‌ها تنها مقدار حافظه آزاد را به‌صورت یک تک‌میله نشان دهد.
.TP 4
.B "Network Input"
دو ردیف میله، نرخ بایت ورودی و نرخ بسته ورودی را برای هر رابط شبکه، به‌جز رابط‌های loopback و slip نشان می‌دهند.
.TP 4
.B "Network Output"
دو ردیف میله، نرخ بایت خروجی و نرخ بسته خروجی را برای هر رابط شبکه، به‌جز رابط‌های loopback و slip نشان می‌دهند.
.SH "گزینه‌ها (OPTIONS)"
اگر هر یک از آرگومان‌های اختیاری
.I interface
در خط فرمان مشخص شوند، تنها رابط‌های شبکه‌ای که با آرگومان‌های
.I interface
مطابقت دارند در بخش‌های
.B "Network Input"
و
.B "Network Output"
نمایش داده خواهند شد. به‌طور پیش‌فرض، از تمام رابط‌ها استفاده می‌شود. آرگومان‌های
.I interface
به‌عنوان الگوهایی برای تطبیق
.BR egrep (1)
با نام رابط‌ها به کار می‌روند، به‌طوری که
.B ec
تمامی رابط‌های اترنت خارجی را برای یک Challenge S انتخاب می‌کند.
.PP
دستور
.B osvis
از
.BR pmview (1)
استفاده می‌کند، و از این رو رابط کاربری آن از موارد شرح‌داده‌شده برای
.BR pmview (1)
پیروی می‌کند، که به نوبه خود صحنه را در یک نمایشگر Inventor examiner نمایش می‌دهد.
.PP
دستور
.B osvis
بیشتر گزینه‌های خط فرمان را به
.BR pmview (1)
منتقل می‌کند. بنابراین، گزینه‌های خط فرمان
.BR \-A ،
.BR \-a ،
.BR \-C ،
.BR \-h ،
.BR \-n ،
.BR \-O ،
.BR \-p ،
.BR \-S ،
.BR \-t ،
.BR \-T ،
.BR \-x ،
.BR \-Z
و
.BR \-z ،
و همچنین رابط کاربری در صفحه راهنمای
.BR pmview (1)
شرح داده شده‌اند.
.PP
گزینه‌های مخصوص
.B osvis
عبارتند از:
.IP \f3\-b\f1
بیشینه توان عملیاتی مورد انتظار شبکه را بر حسب بایت کنترل می‌کند. مقدار پیش‌فرض ۶۵۵۳۶ بایت است.
.IP \f3\-d\f1
بیشینه بهره‌برداری مورد انتظار دیسک را به‌صورت درصد کنترل می‌کند. مقدار پیش‌فرض ۳۰٪ است.
.IP \f3\-i\f1
بیشینه مقدار (نرمال‌سازی) را برای نرخ خواندن و نوشتن دیسک کنترل می‌کند. مقدار پیش‌فرض ۱۰۰ عملیات در ثانیه است.
.IP \f3\-m\f1
بیشینه مقدار (نرمال‌سازی) را برای نرخ ورودی و خروجی بسته‌ها کنترل می‌کند. مقدار پیش‌فرض ۷۵۰ بسته در ثانیه است.
.IP \f3\-V\f1
فایل پیکربندی مشتق‌شده برای
.BR pmview (1)
روی خروجی استاندارد نوشته می‌شود. چنانچه کاربر مایل به سفارشی‌سازی نمایش یا تغییر برخی از پارامترهای نرمال‌سازی باشد، این خروجی می‌تواند ذخیره شده و مستقیماً با
.B pmview
استفاده گردد.
.SH "فایل‌ها (FILES)"
.PD 0
.TP 10
.BI $PCP_VAR_DIR/pmns/ *
فایل‌های پیش‌فرض مشخصات PMNS
.TP
.B $PCP_VAR_DIR/config/pmlogger/config.osvis
فایل پیکربندی
.BR pmlogger (1)
که می‌تواند برای ایجاد یک بایگانی PCP مناسب جهت نمایش با
.B osvis
به کار رود.
.PD
.SH "محیط (ENVIRONMENT)"
متغیرهای محیطی با پیشوند
.B PCP_
برای پارامتریک‌سازی نام فایل‌ها و دایرکتوری‌های مورد استفاده توسط PCP به کار می‌روند. در هر نصب، فایل
.I /etc/pcp.conf
شامل مقادیر محلی برای این متغیرها است. متغیر
.B $PCP_CONF
می‌تواند برای تعیین یک فایل پیکربندی جایگزین استفاده شود، همان‌طور که در
.BR pcp.conf (4)
شرح داده شده است.
.SH "همچنین ببینید (SEE ALSO)"
.BR pmcd (1)،
.BR pmlogger (1)،
.BR pmview (1)،
.BR pcp.conf (4)،
.BR pcp.env (4)
و
.BR pmlaunch (5).
.SH "خطاها (DIAGNOSTICS)"
دستور
.B osvis
آن دسته از بلوک‌هایی را که معیارهای آن‌ها از میزبان زنده یا بایگانی در دسترس نباشد، بدون هشدار از صحنه حذف خواهد کرد.