'\"macro stdmacro
.\"
.\" Copyright (c) 2000-2002 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 DKVIS 1 "" "Performance Co-Pilot"
.SH "نام (NAME)"
dkvis \- ابزار بصری‌سازی کارایی فعالیت دیسک‌ها در PCP
.\" literals use .B or \f3
.\" arguments use .I or \f2
.SH "خلاصه دستور (SYNOPSIS)"
\f3dkvis\f1
[\f3\-brVw\f1]
[\f3\-m\f1 \f2maxrate\f1]
[\f3\-X\f1 \f2ndisk\f1]
[\f3\-Y\f1 \f2nctl\f1]
[\f2گزینه‌های pmview\f1]
[\f2diskid ...\f1]
.SH "توضیحات (DESCRIPTION)"
دستور
.B dkvis
یک نمودار میله‌ای سه‌بعدی از فعالیت دیسک را نمایش می‌دهد. هر ردیف از میله‌ها در صفحه پایه، نمایانگر یک کنترلر دیسک (یا آداپتور میزبان، یا باس) است و میله‌های درون هر ردیف با دیسک‌های متصل به آن کنترلر مطابقت دارند.
.PP
برچسب سمت چپ هر ردیف، بخش مشترک نام دیسک‌ها را برای تمام دیسک‌های آن ردیف مشخص می‌کند؛ برای نمونه \c
.B dks3
برای تمام دیسک‌های IRIX SCSI متصل به کنترلر شماره ۳.
.PP
ارتفاع میله‌ها با میزان فعالیت دیسک متناسب است.
.PP
کاربر می‌تواند فهرستی از دیسک‌ها را به عنوان آرگومان‌های
.I diskid
با استفاده از الگوی نام‌گذاری دیسک گزارش‌شده توسط دستور زیر مشخص کند:
.sp 0.5v
.ft CR
.ti 1i
$ pminfo -f disk.dev.total
.sp 0.5v
.ft R
بسته به نوع دیسک‌ها، برای نمونه \c
.B hda
یا
.B dks0d4
یا
.B sda
یا
.B scsi/host1/bus0/target4/lun0/disc
یا
.BR 20000080e5114459/lun3/c2p1 .
همچنین اگر آرگومان
.I diskid
حاوی یکی از نویسه‌های
.B ^
یا
.B .
یا
.B [
باشد، آن‌گاه
.I diskid
به‌عنوان یک عبارت باقاعده (Regular Expression) به سبک
.BR egrep (1)
در نظر گرفته می‌شود و مجموعه نام‌های دیسک منطبق به جای
.I diskid
استفاده خواهند شد.
.PP
اگر یک یا چند آرگومان
.I diskid
مشخص شود، تنها دیسک‌های موجود در این فهرست در نما نمایش داده می‌شوند. دیسک‌ها در صحنه بر اساس کنترلر گروه‌بندی می‌شوند، مشابه صحنه پیش‌فرض که تمام دیسک‌ها در آن حاضر هستند.
.PP
دستور
.B dkvis
یک فایل پیکربندی برای
.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 ،
.B \-Z
و
.BR \-z ،
و همچنین رابط کاربری در صفحه راهنمای
.BR pmview (1)
توضیح داده شده‌اند.
.SH "گزینه‌ها (OPTIONS)"
گزینه‌های اختصاصی
.B dkvis
عبارتند از:
.IP \f3\-b\f1
گزارش فعالیت به صورت گذردهی داده‌ها بر حسب کیلوبایت در ثانیه به جای حالت پیش‌فرض که تعداد عملیات ورودی/خروجی در ثانیه (IOPS) است.
.IP \f3\-m\f1
استفاده از
.I maxrate
به‌عنوان حداکثر فعالیت که درصد استفاده بر اساس آن محاسبه می‌شود. این گزینه در عمل ارتفاعی که میله‌ها در آن برش می‌خورند را مشخص می‌کند. اگر گزینه
.B \-b
مشخص شده باشد، مقدار پیش‌فرض حداکثر برابر با ۲۰۴۸ کیلوبایت بر ثانیه است؛ در غیر این صورت مقدار پیش‌فرض حداکثر برابر با ۱۵۰ IOPS خواهد بود.
.IP \f3\-r\f1
نمایش فعالیت خواندن. حالت پیش‌فرض، نمایش مجموع فعالیت (خواندن و نوشتن) است.
.IP \f3\-V\f1
حالت پرجزئیات \- نمایش فایل پیکربندی تولیدشده برای
.BR pmview (1).
.IP \f3\-w\f1
نمایش فعالیت نوشتن. حالت پیش‌فرض، نمایش مجموع فعالیت (خواندن و نوشتن) است.
.IP \f3\-X\f1
در چیدمان پیش‌فرض تلاش می‌شود تا ۱۲ دیسک متصل به یک کنترلر در یک ردیف واحد نمایش داده شوند. زمانی که بیش از ۱۲ دیسک به یک کنترلر متصل باشند، ردیف‌های اضافی ایجاد می‌شوند تا مساحت اشغال‌شده روی صفحه پایه صحنه تا حد امکان نزدیک به مربع باشد.
.RS
.PP
گزینه
.B \-X
می‌تواند برای لغو الگوریتم چیدمان پیش‌فرض و تحمیل صحنه‌ای استفاده شود که در آن هر ردیف شامل بیش از
.I ndisk
دیسک نباشد.
.RE
.IP \f3\-Y\f1
در چیدمان پیش‌فرض تلاش می‌شود تا ردیف‌های دیسک برای حداکثر ۱۶ کنترلر در یک بلوک واحد نمایش داده شوند. زمانی که بیش از ۱۶ ردیف کنترلر وجود داشته باشد، بلوک‌های اضافی ایجاد می‌شوند تا مساحت اشغال‌شده روی صفحه پایه صحنه تا حد امکان نزدیک به مربع باشد.
.RS
.PP
گزینه
.B \-Y
می‌تواند برای لغو الگوریتم چیدمان پیش‌فرض و تحمیل صحنه‌ای استفاده شود که در آن بلوک‌ها به گونه‌ای تخصیص یابند که هر یک شامل بیش از
.I nctl
ردیف کنترلر نباشد.
.PP
برای سازگاری با نسخه‌های پیشین، گزینه
.B \-R
یک مترادف منسوخ‌شده برای
.B \-Y
است.
.RE
.PP
در هر بار اجرای
.BR dkvis ،
تنها یک نوع فعالیت می‌تواند نمایش داده شود؛ از این رو گزینه‌های
.B \-r
و
.B \-w
مانعة‌الجمع هستند.
.SH "راه‌اندازی (LAUNCH)"
رفتار
.BR pmchart (1)
هنگام اجرا از طریق
.B dkvis
به تعداد دیسک‌ها در هر ردیف بستگی دارد. اگر بیش از ۶ کنترلر وجود داشته باشد، یک نمودار جداگانه برای هر ستون از دیسک‌ها تولید خواهد شد. به عبارت دیگر، اولین دیسک از هر کنترلر در یک نمودار، دومین دیسک در نمودار بعدی و به همین ترتیب قرار می‌گیرد. در غیر این صورت، یک نمودار جداگانه برای هر کنترلر دیسک تولید می‌شود.
.SH "فایل‌ها (FILES)"
.PD 0
.TP 10
.B $PCP_VAR_DIR/config/pmlogger/config.dkvis
یک فایل پیکربندی
.BR pmlogger (1)
برای معیارهای
.BR dkvis .
.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 dkstat (1)،
.BR mpvis (1)،
.BR nfsvis (1)،
.BR pmchart (1)،
.BR pmlogger (1)،
.BR pmview (1)،
.BR pcp.conf (4)
و
.BR pcp.env (4).
.PP
نماهای
.B Disk
و
.B DiskCntrls
برای
.BR pmchart (1).