نام (NAME)

pmie2col - تبدیل خروجی pmie به قالب چندستونی

خلاصه دستور (SYNOPSIS)

pmie2col [-?] [-d delimiter] [-p precision] [-w width]

توضیحات (DESCRIPTION)

pmie2col ابزار ساده‌ای است که خروجی حاصل از pmie(1) را به قالب ستونی منظم تبدیل می‌کند. هر ستون به‌طور پیش‌فرض ۷ نویسه پهنا دارد (که با گزینهٔ -w قابل تغییر است) و میان ستون‌ها یک فاصلهٔ تکی قرار می‌گیرد. این فاصلهٔ تکی را می‌توان با استفاده از گزینهٔ -d با یک جداکنندهٔ دیگر جایگزین کرد (این قابلیت برای مثال جهت وارد کردن داده‌ها به نرم‌افزارهای صفحه‌گسترده مفید است).

دقت مقادیر جدول‌بندی‌شده از pmie را می‌توان با گزینهٔ -p مشخص کرد (پیش‌فرض ۲ رقم اعشار است). این گزینه به‌منظور ارائهٔ دقت درخواستی، هرگونه تنظیمات پهنا را نادیده گرفته و بر آن اولویت خواهد داشت.

پیکربندی pmie(1) باید از این قوانین پیروی کند:

(1): هر عبارت pmie(1) به صورت “NAME = expr;” است. از NAME به‌عنوان سرستون استفاده خواهد شد و نباید دارای فاصله (white space) باشد، اگرچه نویسه‌های خاص را می‌توان با قرار دادن NAME در میان علامت‌های نقل‌قول تکی گریز داد (escape کرد).
(2): بخش “expr” باید یک عبارت معتبر در pmie(1) باشد که یک مقدار منفرد تولید کند.

علاوه بر این، pmie(1) باید با گزینهٔ خط فرمان -v اجرا شود.

همچنین امکان استفاده از گزینهٔ خط فرمان -e برای pmie(1) وجود دارد که در این صورت، پیشوند خطوط خروجی یک برچسب زمانی خواهد بود.

گزینه‌ها (OPTIONS)

گزینه‌های خط فرمان موجود عبارتند از:

-d char, --delimiter=char: استفاده از char به‌عنوان جداکنندهٔ خروجی.
-p N, --precision=N: استفاده از n به‌عنوان دقت ممیز شناور خروجی.
-w N, --width=N: استفاده از n به‌عنوان پهنای ستون خروجی.
-?, --help: نمایش پیام راهنما و خروج.

مثال‌ها (EXAMPLES)

با در نظر گرفتن این فایل پیکربندی pmie(1) (config):

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);

سپس این خط لولهٔ دستور:

$ pmie -v -t 5 <config | pmie2col -w 8

چنین خروجی‌ای تولید می‌کند:

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

محیط PCP (PCP ENVIRONMENT)

متغیرهای محیطی با پیشوند PCP_ برای مقداردهی و پارامتریک کردن نام فایل‌ها و دایرکتوری‌های مورد استفادهٔ PCP به کار می‌روند. در هر نصب، فایل /etc/pcp.conf شامل مقادیر محلی برای این متغیرها است. متغیر $PCP_CONF می‌تواند برای مشخص کردن یک فایل پیکربندی جایگزین استفاده شود، همان‌طور که در pcp.conf(5) شرح داده شده است.

همچنین ببینید (SEE ALSO)

PCPIntro(1) و pmie(1).