'\"macro stdmacro
.\"
.\" 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 PMIE2COL 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
\f3pmie2col\f1 \- تبدیل خروجی pmie به قالب چندستونی
.SH "خلاصه دستور (SYNOPSIS)"
\f3pmie2col\f1
[\f3\-?\f1]
[\f3\-d\f1 \f2delimiter\f1]
[\f3\-p\f1 \f2precision\f1]
[\f3\-w\f1 \f2width\f1]
.SH "توضیحات (DESCRIPTION)"
.de EX
.in +0.5i
.ie t .ft CB
.el .ft B
.ie t .sp .5v
.el .sp
.ta \\w' 'u*8
.nf
..
.de EE
.fi
.ie t .sp .5v
.el .sp
.ft R
.in
..
.B pmie2col
ابزار ساده‌ای است که خروجی حاصل از
.BR pmie (1)
را به قالب ستونی منظم تبدیل می‌کند. هر ستون به‌طور پیش‌فرض ۷ نویسه پهنا دارد (که با گزینهٔ
.B \-w
قابل تغییر است) و میان ستون‌ها یک فاصلهٔ تکی قرار می‌گیرد.
این فاصلهٔ تکی را می‌توان با استفاده از گزینهٔ
.B \-d
با یک جداکنندهٔ دیگر جایگزین کرد (این قابلیت برای مثال جهت وارد کردن داده‌ها به نرم‌افزارهای صفحه‌گسترده مفید است).
.PP
دقت مقادیر جدول‌بندی‌شده از
.B pmie
را می‌توان با گزینهٔ
.B \-p
مشخص کرد (پیش‌فرض ۲ رقم اعشار است).
این گزینه به‌منظور ارائهٔ دقت درخواستی، هرگونه تنظیمات پهنا را نادیده گرفته و بر آن اولویت خواهد داشت.
.PP
پیکربندی
.BR pmie (1)
باید از این قوانین پیروی کند:
.IP (1)
هر عبارت
.BR pmie (1)
به صورت \(lqNAME = expr;\(rq است.
از NAME به‌عنوان سرستون استفاده خواهد شد و نباید دارای فاصله (white space) باشد،
اگرچه نویسه‌های خاص را می‌توان با قرار دادن NAME در میان علامت‌های نقل‌قول تکی گریز داد (escape کرد).
.IP (2)
بخش \(lqexpr\(rq باید یک عبارت معتبر در
.BR pmie (1)
باشد که یک مقدار منفرد تولید کند.
.PP
علاوه بر این،
.BR pmie (1)
باید با گزینهٔ خط فرمان
.B \-v
اجرا شود.
.PP
همچنین امکان استفاده از گزینهٔ خط فرمان
.B \-e
برای
.BR pmie (1)
وجود دارد که در این صورت، پیشوند خطوط خروجی یک برچسب زمانی خواهد بود.
.SH "گزینه‌ها (OPTIONS)"
گزینه‌های خط فرمان موجود عبارتند از:
.TP 5
\fB\-d\fR \fIchar\fR, \fB\-\-delimiter\fR=\fIchar\fR
استفاده از \fIchar\fR به‌عنوان جداکنندهٔ خروجی.
.TP
\fB\-p\fR \fIN\fR, \fB\-\-precision\fR=\fIN\fR
استفاده از \fIn\fR به‌عنوان دقت ممیز شناور خروجی.
.TP
\fB\-w\fR \fIN\fR, \fB\-\-width\fR=\fIN\fR
استفاده از \fIn\fR به‌عنوان پهنای ستون خروجی.
.TP
\fB\-?\fR, \fB\-\-help\fR
نمایش پیام راهنما و خروج.
.SH "مثال‌ها (EXAMPLES)"
با در نظر گرفتن این فایل پیکربندی
.BR pmie (1)
.IR (config) :
.EX
loadav = kernel.all.load #'1 minute';
\&'%usr' = kernel.all.cpu.user;
\&'%sys' = kernel.all.cpu.sys;
\&'%wio' = kernel.all.cpu.wait.total;
\&'%idle' = kernel.all.cpu.idle;
\&'max-iops' = max_inst(disk.dev.total);
.EE
سپس این خط لولهٔ دستور:
.EX
$ pmie \-v \-t 5 <config | pmie2col \-w 8
.EE
چنین خروجی‌ای تولید می‌کند:
.EX
   loadav     %usr     %sys     %wio    %idle max-iops
     0.21        ?        ?        ?        ?        ?
     0.36     0.49     0.03     0.18     0.29    25.40
     0.49     0.41     0.10     0.36     0.13    51.00
     0.69     0.49     0.10     0.05     0.37    43.20
     0.71     0.39     0.08     0.04     0.49    14.00
     0.83     0.63     0.15     0.00     0.21    32.30
     1.09     0.60     0.02     0.10     0.27    47.00
     0.92     0.01     0.00     0.00     0.99     2.40
.EE
.SH "محیط PCP (PCP ENVIRONMENT)"
متغیرهای محیطی با پیشوند \fBPCP_\fP برای مقداردهی و پارامتریک کردن نام فایل‌ها و دایرکتوری‌های مورد استفادهٔ PCP به کار می‌روند.
در هر نصب، فایل \fI/etc/pcp.conf\fP شامل مقادیر محلی برای این متغیرها است.
متغیر \fB$PCP_CONF\fP می‌تواند برای مشخص کردن یک فایل پیکربندی جایگزین استفاده شود، همان‌طور که در \fBpcp.conf\fP(5) شرح داده شده است.
.SH "همچنین ببینید (SEE ALSO)"
.BR PCPIntro (1)
و
.BR pmie (1).

.\" control lines for scripts/man-spell
.\" +ok+ col {from pmie2col}
.\" +ok+ iops loadav sys wio {from column headings}
.\" +ok+ max_inst sp {.sp from troff macro}