'\" t .\" .\" 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 PMDUMPTEXT 1 "" "Performance Co-Pilot" .SH "نام (NAME)" pmdumptext \- تخلیه معیارهای کارایی در قالب یک جدول ASCII .SH "خلاصه دستور (SYNOPSIS)" \f3pmdumptext\f1 [\f3\-CFGHilmMNoruVXz?\f1] [\f3\-a\f1 \f2archive\f1] [\f3\-A\f1 \f2align\f1] [\f3\-c\f1 \f2config\f1] [\f3\-d\f1 \f2delimiter\f1] [\f3\-D\f1 \f2debug\f1] [\f3\-f\f1 \f2format\f1] [\f3\-h\f1 \f2host\f1] [\f3\-n\f1 \f2pmnsfile\f1] [\f3\-O\f1 \f2offset\f1] [\f3\-P\f1 \f2precision\f1] [\f3\-R\f1 \f2lines\f1] [\f3\-s\f1 \f2sample\f1] [\f3\-S\f1 \f2starttime\f1] [\f3\-t\f1 \f2interval\f1] [\f3\-T\f1 \f2endtime\f1] [\f3\-U\f1 \f2string\f1] [\f3\-w\f1 \f2width\f1] [\f3\-Z\f1 \f2timezone\f1] [\f2metric \f1...] .SH "توضیحات (DESCRIPTION)" دستور .B pmdumptext مقادیر معیارهای کارایی جمع‌آوری‌شده به صورت زنده یا از مجموعه‌ای از بایگانی‌های Performance Co-Pilot (PCP) را در خروجی نمایش می‌دهد. به طور پیش‌فرض، مقادیر معیارها در ستون‌هایی که با نویسهٔ تب (tab) از هم جدا شده‌اند، به همراه برچسب زمان در ابتدای آن‌ها نمایش داده می‌شوند. .PP مگر در مواردی که با گزینهٔ .B \-h به یک میزبان دیگر، با گزینهٔ .B \-a به یک یا چند مجموعه بایگانی، یا با یک پیشوند صریح :host یا /archive در .I metric هدایت شود (برای اطلاعات بیشتر به ادامه مراجعه کنید)، .B pmdumptext با دیمن گردآورنده معیارهای کارایی (PMCD) در میزبان محلی ارتباط برقرار می‌کند تا اطلاعات مورد نیاز را به دست آورد. .PP دستور .B pmdumptext می‌تواند با گزینهٔ .B \-i در حالت تعاملی اجرا شود که مقادیر را در ستون‌هایی با عرض یکسان نمایش می‌دهد. بدون این گزینه، هیچ تلاشی برای هم‌تراز کردن مقادیر انجام نمی‌شود تا خروجی به آسانی توسط برنامه‌های دیگر قابل تجزیه باشد. .PP قالب‌بندی خروجی را می‌توان با تغییر دقت اعشار مقادیر توسط .BR \-P ، عرض ستون‌ها با .BR \-w ، و قالب‌بندی مقادیر با گزینه‌های .B \-G و .B \-F (به ترتیب برای کوتاه‌ترین حالت بین نماد علمی یا ارقام ثابت، و قالب با عرض ثابت) بیشتر کنترل کرد. .PP به طور پیش‌فرض، .B pmdumptext مقادیر معیارها را به واحدهای «استاندارد» (canonical) بایت، ثانیه و شمارش مقیاس‌بندی می‌کند. تنها استثنا با گزینهٔ .B \-r است که در آن مقادیر مقیاس‌بندی نمی‌شوند. گزینهٔ .B \-u واحدهای اندازه‌گیری هر معیار را گزارش می‌دهد. .PP معیارهای .RI ( metrics ) مورد نظر برای تخلیه می‌توانند در خط فرمان، در یک فایل پیکربندی .RI ( config )، یا از طریق ارسال با لوله به .B pmdumptext در .I stdin مشخص شوند. یک معیار شامل یک منبع اختیاری (میزبان یا بایگانی)، نام معیار، و بلافاصله پس از نام، یک فهرست اختیاری از نمونه‌ها (instances) است. از علامت دونقطه برای جداسازی نام میزبان از معیار، و از یک اسلش (``/'') برای جداسازی نام بایگانی از معیار استفاده می‌شود. نمونه‌ها درون قلاب [ ] قرار می‌گیرند و در صورتی که بیش از یکی باشند، بین هر نمونه از یک ویرگول انگلیسی استفاده می‌شود. برای مثال، برخی از معیارهای مجاز عبارتند از: .PP .in 1.5i .ft CR .nf kernel.all.cpu.idle myhost:kernel.all.cpu.idle[cpu0,cpu3] /path/to/myarchive/kernel.all.cpu.idle[cpu1] .fi .ft R .in .PP هنگامی که یک .I metric فاقد پیشوند :host یا /archive باشد (مانند \f(CRkernel.all.cpu.idle\fP در بالا)، منبع معیار بر اساس قواعد زیر تعیین می‌شود: .PD 0 .TP 4n (a) دیمن PMCD روی .I host برگرفته از گزینهٔ .B \-h در صورت وجود؛ در غیر این صورت .TP (b) بایگانی .I archive برگرفته از نخستین گزینهٔ .B \-a در صورت وجود؛ در غیر این صورت .TP (c) میزبان برگرفته از نخستین .I metric پیش از این که دارای پیشوند :host باشد در صورت وجود؛ در غیر این صورت .TP (d) بایگانی برگرفته از نخستین .I metric پیش از این که دارای پیشوند /archive باشد در صورت وجود؛ در غیر این صورت .TP (e) دیمن PMCD روی میزبان محلی، که معادل local::\fImetric\fP است. .PD .PP قالب یک .I metric به تفصیل در .BR PCPIntro (1) در بخش PERFORMANCE METRIC SPECIFICATIONS شرح داده شده است. یک مقدار نرمال‌سازی (normalization) می‌تواند به صورت اختیاری پس از نام معیار در یک فایل .I config یا در .I stdin قرار گیرد. مقدار معیار با این عدد مقیاس‌بندی خواهد شد. برای مثال، اگر فایل‌سیستم ``/dev/root'' ظرفیتی معادل 1965437 بایت داشته باشد، درصد استفاده‌شده از فایل‌سیستم را می‌توان با این .I config تخلیه کرد: .PP .in 1.5i .ft CR .nf filesys.used[/dev/root] 19654.37 .fi .ft R .in .PP نمی‌توان از مقدار نرمال‌سازی برای .IR metrics تعیین‌شده به عنوان آرگومان‌های خط فرمان استفاده کرد. .PP نیازی نیست که نام معیار حتماً یک گره برگ (leaf node) در فضای نام معیارهای کارایی (PMNS) باشد، مگر زمانی که یک یا چند نمونه (instance) مشخص شده باشد. برای مثال، برای تخلیهٔ تمامی معیارهای فایل‌سیستم، تنها تعیین .I filesys کافی است تا مقادیر .IR filesys.capacity ، .IR filesys.used ، .I filesys.free و غیره تخلیه شوند..SH "گزینه‌ها (OPTIONS)" گزینه‌های خط فرمان .hy 0 .B \-A (یا .BR \-\-align )، .B \-O (یا .BR \-\-origin )، .B \-S (یا .BR \-\-start ) و .B \-T (یا .BR \-\-finish ) تراز، افست، زمان شروع و پایان را هنگام مصورسازی معیارها از بایگانی‌ها کنترل می‌کنند. این گزینه‌ها میان بیشتر ابزارهای Performance Co-Pilot مشترک هستند و به‌طور کامل در .BR PCPIntro (1) شرح داده شده‌اند. .br .hy .PP سایر گزینه‌های موجود عبارتند از: .TP 5 \fB\-a\fR \fIarchive\fR, \fB\-\-archive\fR=\fIarchive\fR مشخص‌کننده .I archive (بایگانی) تاریخی است که معیارها می‌توانند برای یک میزبان مشخص از آن دریافت شوند. .I archive مسیر کامل به یک فایل بایگانی، یا نام یک دایرکتوری حاوی بایگانی‌ها، یا نام پایه (basename) یک بایگانی است \- که همگی پیش‌تر توسط .BR pmlogger (1) ایجاد شده‌اند. می‌توان چندین مجموعه از بایگانی‌ها را (جداشده با کاما یا در گزینه‌های \f3\-a\f1 مختلف) از میزبان‌های متفاوت مشخص کرد، اما برای هر میزبان تنها یک مجموعه از بایگانی‌ها مجاز است. هر معیاری که با یک میزبان یا بایگانی خاص مرتبط نباشد، از اولین بایگانی به‌عنوان منبع خود استفاده خواهد کرد. .TP \fB\-c\fR \fIconfig\fR, \fB\-\-config\fR=\fIconfig\fR اگر هیچ .I metrics (معیاری) در خط فرمان مشخص نشده باشد، می‌توان از یک فایل .I config برای تعیین .IR metrics مورد نظر جهت استخراج استفاده کرد. برخلاف .IR metrics خط فرمان، در اینجا هر معیار می‌تواند با یک مقدار نرمال‌سازی دنبال شود. خطوط خالی و خطوطی که با «#» آغاز می‌شوند نادیده گرفته می‌شوند. .TP \fB\-C\fR, \fB\-\-check\fR خروج پیش از استخراج مقادیر، اما پس از تجزیه معیارها. اگر .BR \-m ، .BR \-l ، .BR \-N و/یا .BR \-u مشخص شده باشند، معیارها، نمونه‌ها (instances)، مقادیر نرمال و واحدها فهرست می‌شوند. .TP \fB\-d\fR \fIdelimiter\fR, \fB\-\-delimiter\fR=\fIdelimiter\fR تعیین .I delimiter (جداکننده‌ای) که هر ستون از خروجی را تفکیک می‌کند. .I delimiter تنها می‌تواند یک نویسه منفرد باشد. .TP \fB\-f\fR \fIformat\fR, \fB\-\-time\-format\fR=\fIformat\fR استفاده از رشته .I format برای قالب‌بندی برچسب زمانی همراه با هر مجموعه از مقادیر. نحو این رشته مشابه ساختار شرح داده شده در .BR strftime (3) است. یک رشته .I format خالی (مانند \(aq\(aq) برچسب‌های زمانی را از خروجی حذف خواهد کرد. .TP \fB\-F\fR, \fB\-\-fixed\fR تولید خروجی مقادیر در قالبی با عرض ثابت ۶ نویسه. اعداد مثبت به‌صورت \f2dd\f1.\f2dd\f3u\f1 و اعداد منفی به‌صورت \f3[\f1-\f3]\f2d\f1.\f2dd\f3u\f1 نمایش داده می‌شوند. ضریب پسوندی می‌تواند مقادیر .BR K (10^3)، .BR M (10^6)، .BR G (10^9) و .BR T (10^12) را داشته باشد. برای مثال، مقدار ۴۵۶۷ حتی اگر واحد معیار بایت باشد، به‌صورت 4.57K نمایش داده می‌شود. .TP \fB\-G\fR, \fB\-\-scientific\fR نمایش مقادیر با استفاده از کوتاه‌ترین حالت بین نماد علمی یا نمایش ده‌دهی (اعشاری). .TP \fB\-h\fR \fIhost\fR, \fB\-\-host\fR=\fIhost\fR دریافت معیارهای کارایی از .BR pmcd (1) روی .IR host ، به‌جای localhost پیش‌فرض. .TP \fB\-H\fR, \fB\-\-headers\fR نمایش تمام سرآیندها پیش از استخراج مقادیر معیارها. این گزینه معادل .BR \-lmNu است. .TP \fB\-i\fR, \fB\-\-interactive\fR نمایش داده‌ها در ستون‌هایی با عرض ثابت با استفاده از مقادیر با عرض ثابت (ببینید .BR \-F ) به‌طوری که خوانایی انسانی داشته باشد. این گزینه را نمی‌توان همراه با .B \-P استفاده کرد، زیرا مقادیر ممیز ثابت دارای عرض ثابت نیستند. این گزینه همچنین بر خروجی گزینه‌های .BR \-m و .BR \-u اثر می‌گذارد، چرا که نام معیارها، نمونه‌ها و واحدها کوتاه خواهند شد. .TP \fB\-l\fR, \fB\-\-source\fR نمایش منبع معیارها. در حالت تعاملی، میزبان معیارها نمایش داده می‌شود. در حالت غیرتعاملی، این گزینه منبع معیارها را همراه با نام معیار نمایش می‌دهد، حتی اگر .B \-m مشخص نشده باشد. .TP \fB\-m\fR, \fB\-\-metrics\fR نمایش نام معیارها پیش از مقادیر آن‌ها. منبع و واحدهای معیارها نیز می‌توانند به‌ترتیب با گزینه‌های \f3\-l\f1 و \f3\-u\f1 در خروجی درج شوند. اگر در حالت تعاملی باشد، نام معیارها ممکن است کوتاه شود، و نام نمونه‌ها نیز در صورت لزوم، در خط بعدی کوتاه می‌شوند. .TP \fB\-M\fR نمایش شماره ستون و نام کامل معیارها پیش از استخراج هر مقداری. اگر پرچم .B \-l نیز مشخص شده باشد، منبع معیارها نیز نمایش داده می‌شود. .TP \fB\-n\fR \fIpmnsfile\fR, \fB\-\-namespace\fR=\fIpmnsfile\fR بارگذاری یک PMNS محلی جایگزین از فایل .IR pmnsfile . .TP \fB\-o\fR, \fB\-\-offset\fR هنگامی که یک برچسب زمانی گزارش می‌شود (یعنی مگر اینکه یک رشته قالب خالی با گزینه .B \-f مشخص شده باشد)، برچسب زمانی با افست بر حسب ثانیه از شروع مجموعه بایگانی‌ها یا آغاز اجرای .BR pmdumptext پیشوندگذاری می‌شود. .TP \fB\-N\fR نمایش فاکتورهای نرمال‌سازی پیش از مقادیر معیارها. .TP \fB\-p\fR \fIprecision\fR, \fB\-\-precision\fR=\fIprecision\fR تنظیم دقت ( .IR precision ) مقادیر. این گزینه را نمی‌توان همراه با .B \-F استفاده کرد، زیرا دقت در آن ثابت است. دقت پیش‌فرض ۳ است. .TP \fB\-r\fR, \fB\-\-raw\fR نمایش مقادیر خام معیارها؛ بدون تبدیل شمارنده‌ها به نرخ و بدون تغییر مقیاس مقادیر به واحدهای استاندارد (canonical). این گزینه همچنین باعث می‌شود .B pmdumptext مقادیر نرمال‌سازی را برای هر معیار نادیده بگیرد. .TP \fB\-R\fR \fIlines\fR, \fB\-\-repeat\fR=\fIlines\fR تکرار سرآیند به ازای هر .I lines خط از خروجی. این گزینه در حالت تعاملی و هنگام استفاده از پنجره‌های گرافیکی، برای جلوگیری از پیمایش سرآیند به خارج از بافر پنجره، و همچنین تراز مجدد سرآیند در صورت تغییر اندازه پنجره مفید است. .TP \fB\-s\fR \fIsamples\fR, \fB\-\-samples\fR=\fIsamples\fR .B pmdumptext پس از این تعداد نمونه خاتمه می‌یابد. .TP \fB\-t\fR \fIinterval\fR, \fB\-\-interval\fR=\fIinterval\fR گزینه .I interval از نحو توصیف‌شده در .BR PCPIntro (1) پیروی می‌کند، و در ساده‌ترین شکل می‌تواند یک عدد صحیح بدون علامت باشد (واحد ضمنی در این حالت ثانیه است). فاصله زمانی پیش‌فرض ۱ ثانیه است..TP \fB\-u\fR, \fB\-\-units\fR واحدهای متریک‌ها را پیش از نخستین مقادیر نمایش می‌دهد، اما در صورتی که \f3\-m\f1 نیز مشخص شده باشد، پس از نام‌های متریک قرار می‌گیرد. .TP \fB\-U\fR \fIstring\fR, \fB\-\-unavailable\fR=\fIstring\fR خروجی را در زمانی که مقادیر در دسترس نیستند به .IR string تغییر می‌دهد. رشته پیش‌فرض ``?'' است. .TP \fB\-V\fR, \fB\-\-version\fR شماره نسخه را نمایش داده و خارج می‌شود. .TP \fB\-w\fR \fIwidth\fR, \fB\-\-widthfR=\fIwidth\fR عرض ستون خروجی را تعیین می‌کند. رشته‌ها تا این عرض کوتاه می‌شوند، و اگر .I width بزرگ‌تر از ۵ باشد ممکن است پسوند ``...'' به انتهای آن‌ها افزوده شود. .TP \fB\-X\fR, \fB\-\-extended\fR شماره ستون و نام کامل متریک‌ها را، یک مورد در هر خط، هم پیش از تخلیه اولین مجموعه مقادیر و هم هر بار با تکرار سربرگ، در خروجی نمایش می‌دهد. .TP \fB\-z\fR, \fB\-\-hostzone\fR از منطقه زمانی محلی میزبانی که منبع متریک‌های کارایی است، همان‌طور که توسط گزینه‌های .B \-h یا اولین گزینه .B \-a مشخص شده است، استفاده می‌کند. پیش‌فرض استفاده از منطقه زمانی میزبان محلی است. .TP \fB\-Z\fR \fItimezone\fR, \fB\-\-timezone\fR=\fItimezone\fR از .I timezone برای تاریخ و زمان استفاده می‌کند. .I Timezone در قالب متغیر محیطی .B TZ است، همان‌گونه که در .BR environ (7) شرح داده شده است. .TP \fB\-?\fR, \fB\-\-help\fR پیام راهنمای نحوه استفاده را نمایش داده و خارج می‌شود. .SH "منابع چندگانه (MULTIPLE SOURCES)" دستور .B pmdumptext از تخلیه متریک‌ها از چندین میزبان یا مجموعه‌ای از بایگانی‌ها پشتیبانی می‌کند. متریک‌های فهرست‌شده در خط فرمان یا در فایل .I config می‌توانند منبع مشخصی نداشته باشند یا از منابع متفاوتی بیایند. .PP با این حال، هنگامی که بایگانی‌ها در خط فرمان .RB ( \-a ) و/یا در فایل پیکربندی مشخص شده باشند، محدودیت‌هایی اعمال می‌شود. نخست، برای هر میزبان تنها یک مجموعه بایگانی می‌تواند وجود داشته باشد. دوم، میزبان‌های هر متریکی با منبع میزبان باید با میزبانِ یک مجموعه بایگانی، چه در خط فرمان و چه پیش‌تر به عنوان منبع متریکی دیگر، مطابقت داشته باشد. .PP گزینه‌های .B \-a و .B \-h نمی‌توانند هم‌زمان با یکدیگر استفاده شوند. .SH "تبدیل واحد (UNIT CONVERSION)" تمامی متریک‌هایی که معنای شمارنده دارند، به‌طور خودکار به نرخ در بازه زمانی نمونه‌برداری تبدیل می‌شوند. در حالت تعاملی، .B pmdumptext همچنین واحدهای برخی از متریک‌ها را تغییر می‌دهد تا درک آن‌ها آسان‌تر شود: .TP o تمامی متریک‌های با واحدهای فضا (بایت تا ترابایت) به بایت مقیاس‌بندی می‌شوند. توجه داشته باشید که ۱۰۲۴ بایت به صورت 1.02K نمایش داده خواهد شد، نه 1.00K. .TP o متریک‌هایی که شمارنده‌هایی با واحدهای زمانی هستند (نانوثانیه تا ساعت)، میزان بهره‌وری زمانی را در طول بازه نمونه‌برداری نشان می‌دهند. رشته واحد چنین متریک‌هایی به ``Time Utilization'' تغییر یافته یا به صورت خلاصه به ``util'' تبدیل می‌شود و مقادیر آن‌ها در بازه صفر تا یک نرمال‌سازی می‌شوند. .SH "مثال‌ها (EXAMPLES)" o برای بررسی بار کاری روی دو میزبان foo و bar به‌طور هم‌زمان: .PP .in 0.5i .ft CR .nf $ pmdumptext \-il 'foo:kernel.all.load[1]' 'bar:kernel.all.load[1]' Source foo bar Wed Jul 30 11:37:53 0.309 0.409 Wed Jul 30 11:37:54 0.309 0.409 Wed Jul 30 11:37:55 0.309 0.409 .fi .ft R .in .PP o برای نمایش میزان استفاده از حافظه روی یک میزبان دوردست به نام bong با یک برچسب زمانی ساده‌تر: .PP .in 0.5i .ft CR .nf $ pmdumptext \-imu \-h bong \-f '%H:%M:%S' mem.util Metric kernel fs_ctl _dirty _clean free user Units b b b b b b 09:32:28 8.98M 0.97M 0.00 3.90M 7.13M 46.13M 09:32:29 8.99M 0.98M 0.00 5.71M 5.39M 46.03M 09:32:30 8.99M 1.07M 0.00 5.81M 4.55M 46.69M 09:32:31 9.03M 1.16M 0.00 6.45M 3.48M 47.00M 09:32:32 9.09M 1.18M 20.48K 6.23M 3.29M 47.30M .fi .ft R .in .PP o برای تخلیه تمامی متریک‌های جمع‌آوری‌شده در یک بایگانی با بازه زمانی ۳۰ ثانیه به یک فایل، جهت پردازش توسط ابزاری دیگر: .PP .in 0.5i .ft CR .nf $ pminfo \-a archive | pmdumptext \-t 30s \-m \-a archive > outfile .fi .ft R .in.SH "فایل‌ها (FILES)" .TP 5 .I $PCP_VAR_DIR/pmns/* فایل‌های پیش‌فرض مشخصات PMNS .SH "محیط PCP (PCP ENVIRONMENT)" متغیرهای محیطی با پیشوند \fBPCP_\fP برای تعیین نام فایل‌ها و دایرکتوری‌های مورد استفاده توسط PCP به کار می‌روند. در هر نصب، فایل \fI/etc/pcp.conf\fP حاوی مقادیر محلی برای این متغیرها است. متغیر \fB$PCP_CONF\fP ممکن است برای مشخص کردن یک فایل پیکربندی جایگزین استفاده شود، همان‌طور که در \fBpcp.conf\fP(5) شرح داده شده است. .PP برای متغیرهای محیطی تأثیرگذار بر ابزارهای PCP، به \fBpmGetOptions\fP(3) مراجعه کنید. .SH "گزینه‌های اشکال‌زدایی (DEBUGGING OPTIONS)" گزینه .B \-D یا .B \-\-debug خروجی عیب‌یابی‌های تکمیلی را در .I stderr برای کمک به تفکیک و بررسی مشکلات فعال می‌کند، هرچند این اطلاعات گاهی مبهم بوده و در وهله نخست برای راهنمایی توسعه‌دهندگان به جای کاربران نهایی در نظر گرفته شده‌اند. .I debug یک فهرست جداشده با کاما از گزینه‌های اشکال‌زدایی است؛ از .BR pmdbg (1) به همراه گزینه .B \-l برای دریافت فهرستی از گزینه‌های اشکال‌زدایی موجود و معانی آن‌ها استفاده کنید. .PP گزینه‌های اشکال‌زدایی ویژه .B pmdumptext به شرح زیر هستند: .TS box; lf(B) | lf(B) lf(B) | lxf(R) . گزینه توضیحات _ appl0 T{ .ad l عیب‌یابی تفصیلی برای معیارها، منبع و منطقه زمانی آن‌ها، متادیتا، نرمال‌سازی واحدها، قالب خروجی و غیره. T} .TE .SH "همچنین ببینید (SEE ALSO)" .BR PCPIntro (1)، .BR pmcd (1)، .BR pmchart (1)، .BR pmlogger (1)، .BR pmrep (1)، .BR PMAPI (3)، .BR strftime (3) و .BR environ (7). .\" control lines for scripts/man-spell .\" +ok+ Jul _clean _dirty dd explict filesys fs_ctl .\" +ok+ myarchive myhost outfile .\" +ok+ il {from -il} imu {from -imu} lmNu {from -lmNu}