.TH PMVIEW 5 "" "Performance Co-Pilot" .SH "نام (NAME)" pmview \- فایل پیکربندی و توصیف صحنه سه‌بعدی برای pmview در PCP .SH "توضیحات (DESCRIPTION)" این صفحه راهنما نسخه ۲.۱ قالب فایل پیکربندی .B pmview (1) را شرح می‌دهد. .PP قالب پیکربندی از معیارهای چندین میزبان یا بایگانی پشتیبانی می‌کند. یک فایل پیکربندی می‌تواند معیارهای بدون منبع، با میزبان‌های متفاوت و با بایگانی‌های مختلف را مشخص کند. با این حال، یک فایل پیکربندی که شامل بایگانی‌ها است، برای هر میزبان تنها می‌تواند یک بایگانی داشته باشد. در حالت «بازپخش» (replay)، هر معیاری با منبع مختص به میزبان نیازمند آن است که یک بایگانی برای آن میزبان در خط فرمان یا به عنوان منبع یک معیار پیشین مشخص شده باشد. این بایگانی باید همان بایگانی (بر اساس مقایسه رشته‌ای نام بایگانی‌ها) مشخص‌شده در فایل پیکربندی برای همان میزبان باشد. .PP کنترل‌های زمان، تمامی میزبان‌های مشخص‌شده در خط فرمان و فایل پیکربندی را در فهرست منطقه زمانی فهرست خواهند کرد (ببینید .BR pmtime (1)). .PP قالب فایل پیکربندی بر پایه یک شبکه دوبعدی (grid) است که می‌تواند شامل انواع میله‌ها (bars)، پشته‌ها (stacks)، پیوندها (links)، لوله‌ها (pipes)، برچسب‌ها (labels) و شبکه‌های دیگر باشد. شبکه‌ها اندازه هر ستون و سطر را برای تطبیق با اندازه بزرگ‌ترین آیتم موجود در آن ستون یا سطر تغییر می‌دهند. یک فایل پیکربندی که تنها شامل یک شیء است نیازی به شبکه ندارد. فایل پیکربندی .B pmview با یک سرآیند شناسایی در اولین خط غیرتوضیحی آغاز می‌شود: .PP .in 1.0i .ft CR .nf pmview Version 2.1 \f2[command_line]\f1 .fi .ft R .in .PP گزینه اختیاری .I command_line در صورتی که فایل پیکربندی توسط ابزار دیگری ایجاد شده باشد، باید خط فرمانی باشد که ابزار با آن اجرا شده است. این ویژگی برای برنامه‌هایی مفید است که قرار است پس از خروج کاربر در حالی که .B pmview همچنان در حال اجرا بوده است، در ورود بعدی کاربر به سیستم به طور خودکار دوباره راه‌اندازی شوند. باید دقت شود که دستور مشخص‌شده یک مسیر کامل باشد یا در متغیر PATH موجود هنگام ورود به سیستم یافت شود. .PP تمامی خطوطی که با «#» آغاز می‌شوند به عنوان توضیحات (کامنت) در نظر گرفته شده و نادیده گرفته می‌شوند. در غیر این صورت، تمام فاصله‌ها، تب‌ها و خطوط جدید به عنوان فضای خالی (white space) در نظر گرفته می‌شوند، بنابراین چندین دستور می‌توانند در یک خط قرار گیرند. .PP نحو مشخص کردن مقادیر در فایل پیکربندی برای تمامی دستورات یکسان و به شرح زیر است: .TP 4n .I color رنگ باید یکی از حدود ۲۰ نام رنگ .BR Qt باشد (به کلاس QColor در https://doc.qt.io/qt-5/qcolor.html#predefined-colors مراجعه کنید)، یا یک مقدار رنگ هگزادسیمال .BR HTML (محصور در علامت نقل‌قول، مانند "#ff6347")، یا سه مقدار حقیقی نرمال‌شده .I real نشان‌دهنده اشباع رنگ‌های قرمز، سبز و آبی باشد. برای مثال، رنگ‌های زیر یکسان هستند: .PP .in 1.5i .ft CR .nf red "#ff0000" 1.0 0.0 0.0 .fi .ft R .in .TP 4n .I int یک عدد صحیح. .TP 4n .I metric یک معیار شامل یک منبع اختیاری (میزبان یا بایگانی)، نام معیار، یک فهرست اختیاری از نمونه‌ها بلافاصله پس از نام، و به دنبال آن مقدار بیشینه (یا مقدار نرمال‌سازی) است. دونقطه («:») برای جدا کردن نام میزبان از معیار، و اسلش رو به جلو («/») برای جدا کردن نام بایگانی از معیار به کار می‌رود. نمونه‌ها در کروشه قرار گرفته و با کاما از هم جدا می‌شوند. هر نمونه می‌تواند در نقل‌قول محصور شود. .IP برای مثال، برخی از معیارهای مجاز عبارتند از: .in 1.5i .ft CR .nf kernel.all.cpu.idle 4000 myhost:kernel.all.cpu.idle[cpu0,"cpu3"] 1000.0 /path/to/myarchive/kernel.all.cpu.idle[cpu1] 1000 .fi .ft R .in برای کمک به فرآیند تطبیق نام نمونه‌ها، دو مقایسه دیگر علاوه بر مقایسه رشته‌ای ساده انجام می‌شود. اگر نام نمونه شامل فاصله باشد، تنها کلمه اول در نام نمونه برای تطبیق با نمونه کافی است، با این فرض که کلمه اول یکتا باشد. اگر کلمه اول یکتا نباشد، تنها اولین نمونه منطبق انتخاب خواهد شد. مقایسه دوم زمانی رخ می‌دهد که کلمه اول عددی با صفرهای ابتدایی باشد؛ پیش از مقایسه مجدد کلمه اول، تمام صفرهای ابتدایی نادیده گرفته می‌شوند. این کار اجازه می‌دهد شناسه‌های فرآیند (PID) استفاده‌شده در معیارهای .I proc بدون مشخص کردن کل نام نمونه به آسانی تطبیق داده شوند. برای مثال، برای مصورسازی زمان کاربر و سیستم در .I init از این مشخصات معیار استفاده کنید: .in 1.5i .ft CR .nf proc.psusage.utime[1] 1000 proc.psusage.stime[1] 1000 .fi .ft R .in .TP 4n .I name نامی برای یک شیء که ممکن است بعداً در فایل پیکربندی به آن ارجاع داده شود. نام‌ها باید یک کلمه منفرد متشکل از نویسه‌های الفبایی‌عددی، خط زیر (underscore)، خط تیره (dash) و دونقطه باشند. توصیه می‌شود که نام‌ها با خط زیر آغاز نشوند زیرا ممکن است به عنوان کلمه کلیدی تفسیر شوند. .TP 4n .I pos این موقعیت شیء در شبکه (grid) است. نحو تعیین موقعیت به صورت زیر است: .IP .in 1.0i [ [\f2x\f1 \f2z\f1] [ [\f2width\f1 \f2depth\f1] [\f2alignment\f1] ] ] .in .TP 14 .I " x" مختصات افقی (از چپ به راست) شیء، با شروع از 0. مقدار پیش‌فرض .I x برابر 0 است. .TP .I " z" مختصات عمودی (از بالا به پایین) شیء، با شروع از 0. مقدار پیش‌فرض .I z برابر 0 است. .TP .I " width" تعداد ستون‌های اشغال‌شده توسط شیء. مقدار پیش‌فرض .I width برابر 1 است. .TP .I " depth" تعداد سطرهای اشغال‌شده توسط شیء. مقدار پیش‌فرض .I depth برابر 1 است. .TP .I " alignment" لبه یا گوشه‌ای که شیء با آن تراز می‌شود. ترازهای ممکن عبارتند از: \f2north\f1، \f2south\f1، \f2east\f1، \f2west\f1، \f2northeast\f1، \f2northwest\f1، \f2southeast\f1، \f2southwest\f1 و \f2center\f1. اختصارهایی مانند \f2se\f1 و \f2SE\f1 نیز پذیرفته می‌شوند. تراز پیش‌فرض \f2center\f1 است. .IP اندازه یک شیء ممکن است نامشخص باشد زیرا تعداد نمونه‌ها برای برخی معیارها بسته به میزبان‌ها و پیکربندی‌های PMDA متفاوت خواهد بود. بنابراین، موقعیت شیء می‌تواند برای مشخص کردن اندازه احتمالی شیء به کار رود تا موقعیت اشیاء مجاور به طور مناسب تنظیم شود. .IP موقعیت‌های زیر مجاز هستند: .TP 21 .ft CR 0 5 .ft R شیء در موقعیت شبکه 0,5 متمرکز است و ۱ خانه شبکه را اشغال می‌کند. .TP .ft CR 1 2 north .ft R شیء با لبه شمالی موقعیت 1,2 تراز شده و ۱ خانه شبکه را اشغال می‌کند. .TP .ft CR 2 2 2 1 east .ft R شیء با لبه شرقی موقعیت 3,2 تراز شده و ۲ خانه شبکه (2,2 و 3,2) را اشغال می‌کند. .TP 4n .I string یک رشته، دنباله‌ای از نویسه‌ها است که در علامت نقل‌قول دوتایی (double quotes) محصور شده‌اند. یک رشته نباید شامل خطوط جدید یا نقل‌قول‌های دوتایی اسکیپ‌شده باشد. .PP چندین پارامتر وجود دارند که ممکن است بر اندازه، شکل و رنگ اشیاء هنگام نمایش تأثیر بگذارند. دامنه اثر این پارامترها به گونه‌ای است که تنها اشیای تعریف‌شده پس از خود در همان دامنه را تغییر می‌دهند. بنابراین، تنظیمات پارامترها در بالای فایل پیکربندی بر کل صحنه تأثیر می‌گذارند، مگر اینکه بعداً در فایل تغییر یابند. بیشتر این پارامترها منبع (resource) نیز محسوب می‌شوند. .TP 4n \f3_barLength\f1 \f2int\f1 طول ضلع بلوک‌های .B _bar و .BR _stack . مقدار پیش‌فرض 28 است. .TP 4n \f3_barHeight\f1 \f2int\f1 بیشینه ارتفاع بلوک‌های .B _bar و .BR _stack . مقدار پیش‌فرض 80 است. .TP 4n \f3_baseColor\f1 \f2color\f1 رنگ صفحات پایه .BR _bar ، .B _grid و .BR _stack . مقدار پیش‌فرض "#262626" (یعنی gray15) است. .TP 4n \f3_baseHeight\f1 \f2int\f1 ارتفاع صفحات پایه .BR _bar ، .B _grid و .BR _stack . مقدار پیش‌فرض 2 است. .TP 4n \f3_gapWidth\f1 \f2int\f1 فاصله میان بلوک‌ها در شیء .B _bar در محور X. مقدار پیش‌فرض 8 است. .TP 4n \f3_gapDepth\f1 \f2int\f1 فاصله میان بلوک‌ها در شیء .B _bar در محور Z. مقدار پیش‌فرض 8 است. .TP 4n \f3_gapLabel\f1 \f2int\f1 فاصله بین پایه یک شیء .B _bar و برچسب‌های معیار یا نمونه. مقدار پیش‌فرض 6 است. .TP 4n \f3_gridWidth\f1 \f2int\f1 حداقل پهنای یک ستون در .BR _grid . مقدار پیش‌فرض 20 است. .TP 4n \f3_gridDepth\f1 \f2int\f1 حداقل عمق یک سطر در .BR _grid . مقدار پیش‌فرض 20 است. .TP 4n \f3_labelMargin\f1 \f2int\f1 حاشیه اطراف یک شیء .BR _label . مقدار پیش‌فرض 5 است. .TP 4n \f3_labelColor\f1 \f2color\f1 رنگ برچسب‌های .B _label و .BR _bar . مقدار پیش‌فرض سفید (white) است. .TP 4n \f3_marginWidth\f1 \f2int\f1 پهنای اضافی صفحه پایه .BR _bar ، .B _grid و .B _stack فراتر از اشیاء موجود روی صفحه. مقدار پیش‌فرض 8 است. .TP 4n \f3_marginDepth\f1 \f2int\f1 عمق اضافی صفحه پایه .BR _bar ، .B _grid و .B _stack فراتر از اشیاء موجود روی صفحه. مقدار پیش‌فرض 8 است. .TP 4n \f3_pipeLength\f1 \f2int\f1 طول کل یک .BR _pipe . مقدار پیش‌فرض برابر با مقدار .B _barHeight است. .TP 4n \f3_scale\f1 \f2real\f1 مقیاس اعمال‌شده به کل صحنه. این پارامتر نمی‌تواند درون هیچ شیئی استفاده شود و فقط در بالای فایل پیکربندی مجاز است. مقدار پیش‌فرض 1.0 است. .PP برای ساده‌سازی تعیین رنگ‌ها، می‌توان از .B _colorList و .B _colorScale برای تعریف رنگ‌های شیئی که معیارهایی به آن وابسته است (مانند .BR _bar ، .B _stack یا .BR _pipe ) استفاده کرد. یک فهرست رنگ می‌تواند درون یک شیء تعریف شود یا اینکه نام‌گذاری شده و در بالای فایل پیکربندی تعریف گردد. سپس می‌توان در چندین شیء به یک فهرست رنگ نام‌گذاری‌شده ارجاع داد: .TP 4n \f3_colorList\f1 \f2name\f1 \f3(\f1 \f2color\f1 [\f2color\f1...] \f3)\f1 رنگ‌های .I color را به فهرست رنگ .I name مرتبط می‌کند. تخصیص رنگ‌ها به بلوک‌ها بستگی به نوع شیء دارد. برای مثال، فهرست رنگی به نام .I foo دارای یک رنگ یکسان است که سه بار تکرار شده است: .RS 4 .ft CR .nf _colorList foo ( red "#ff0000" 1.0 0.0 0.0 ) .fi .ft R .RE .TP 4n \f3_colorScale\f1 \f2name\f1 \f2color\f1 \f3(\f1 \f2color\f1 \f2real\f1 [\f2color\f1 \f2real\f1...] \f3)\f1 رنگ‌های .I color و مقادیر حقیقی .I real را به فهرست رنگ .I name مرتبط می‌کند. رنگ اولیه .I color رنگ پیش‌فرض شیء است. هنگامی که مقدار نرمال‌شده شیء برابر یا بیشتر از هر مقدار .I real باشد، شیء تغییر رنگ داده و به رنگ‌های دیگر تبدیل می‌شود. بنابراین، هر مقدار .I real باید بزرگ‌تر از مقدار .I real پیشین باشد و در محدوده 0.0 تا 1.0 قرار گیرد. این مقیاس رنگ به آرامی از آبی به قرمز تغییر می‌کند: .PP .RS 4 .ft CR .nf _colorScale coldToHot blue ( "#7f00ff" 0.3 purple 0.6 "#ff007f" 0.8 red 0.95) .fi .ft R .RE .PP انواع مختلفی از اشیاء وجود دارند که می‌توانند در یک صحنه .B pmview یافت شوند: .BR _bar ، .BR _stack ، .BR _pipe ، .BR _grid ، .BR _link و .BR _label . همچنین .B _xing وجود دارد که نوع خاصی از .B _link است. اشیای .BR _bar ، .B _stack و .B _pipe توسط مقادیر معیارها مدوله می‌شوند، .B _label یک متن ثابت است، .B _link و .B _xing اتصالات متقابل هستند و .B _grid ظرفی برای اشیاء (از جمله سایر اشیای .BR _grid ) است که چیدمان صحنه را کنترل می‌کند. شیء .B _grid تنها در صورتی مورد نیاز است که دو یا چند شیء در صحنه وجود داشته باشند. .PP اشیای .BR _bar ، .B _grid و .B _stack می‌توانند صفحات پایه داشته باشند که نقطه مرجعی برای بلوک‌ها هنگام تغییر ارتفاع فراهم می‌کنند. در صورت فعال بودن .BR _show ، می‌توان با دستور زیر یک برچسب روی صفحه پایه شیء اعمال کرد: .in 1.5i .ft CR .nf \f3_baseLabel\f1 \f2name\f1|\f2string\f1 .fi .ft R .in دستور .B _baseLabel باید درون دامنه شیء مربوطه .RB ( _bar ، .B _grid یا .BR _stack ) استفاده شود. اولین نویسه‌های «\\n» در رشته با یک خط جدید جایگزین می‌شوند. نویسه‌های بعدی «\\n» نادیده گرفته خواهند شد. .PP برای معتبر بودن یک صحنه، باید حداقل یک شیء مدوله‌شونده در آن وجود داشته باشد. .PP اشیاء به شرح زیر تعریف می‌شوند: .TP 4n \f3_bar\f1 [\f2options\f1] \f3(\f1 [\f2metric-list\f1] [\f2color-list\f1] [\f2label-list\f1] \f3)\f1 شیء .B _bar نمایانگر مجموعه‌ای از بلوک‌ها است. تعداد بلوک‌ها به تعداد معیارها و نمونه‌های معیارهای اختصاص‌یافته به شیء بستگی دارد. به طور پیش‌فرض، بلوک‌ها با تغییر ارتفاع هر بلوک مدوله می‌شوند. در روش جایگزین، بلوک‌ها می‌توانند با تغییر رنگ، یا هم ارتفاع و هم رنگ مدوله شوند. هر رنگ در .I color-list به یک معیار اختصاص می‌یابد؛ بنابراین چندین نمونه از یک معیار یکسان دارای رنگ یکسانی خواهند بود. گزینه‌های .I options که می‌توانند به شیء .B _bar داده شوند عبارتند از: .RS 4n .TP 4n .I pos موقعیت شیء .B _bar درون شیء .B _grid جاری. .TP 4n \f3_col\f1|\f3_row\f1 موقعیت‌دهی به بلوک‌ها به طوری که هر نمونه در یک ستون .RB ( _col ) یا یک سطر .RB ( _row ) قرار گیرد. این بدان معناست که هر معیار متفاوت به ترتیب در یک سطر یا ستون جداگانه قرار خواهد گرفت. مقدار پیش‌فرض .B _col است. .TP 4n \f3_show\f1|\f3_hide\f1 آیا صفحه پایه قابل مشاهده است؟ مقدار پیش‌فرض .B _show است. .TP 4n \f3_ymod\f1|\f3_colormod\f1|\f3_colorymod\f1 مدوله‌سازی بلوک‌ها از طریق تنظیم ارتفاع .RB ( _ymod )، رنگ .RB ( _colormod ) یا هم ارتفاع و هم رنگ .RB ( _colorymod ). .TP 4n \f3_cube\f1|\f3_cylinder\f1 تعیین شکل بلوک‌ها. مقدار پیش‌فرض .B _cube است. .RE .RS 4n .TP 4n \f3_groupbymetric\f1|\f3_groupbyinst\f1|\f3_groupbyrow|\f1|\f3groupbycol\f1 تعیین نحوه گروه‌بندی بلوک‌ها هنگام راه‌اندازی سایر ابزارها. برای ابزارهایی مانند .BR pmchart (1) برخی نماها ممکن است نمودارهای کوچک متعددی ایجاد کنند که امکان رسم تمام آن‌ها درون صفحه وجود نداشته باشد. مشکل دیگر این است که ممکن است ایجاد نمودارهایی با نمونه‌های یکسان در هر نمودار مناسب‌تر از ایجاد با معیارهای یکسان باشد. مشخص‌کننده‌های گروه، الگوریتم مورد استفاده را کنترل می‌کنند تا نمودار جداگانه‌ای برای هر مشخصه .B _metrics رسم شود .RB ( _groupbymetric )، یا برای نمونه‌های اول، دوم و غیره از هر .B _metric رسم شود .RB ( _groupbyinst )، یا بسته به .B _row یا .BR _col ، بر اساس سطرها و ستون‌های شیء .B _bar رسم گردد. مقدار پیش‌فرض .B _groupbymetric است. .PP گزینه‌ها باید دقیقاً به همین ترتیب مشخص شوند، هرچند گزینه‌های قبلی الزامی نیستند. بنابراین عبارت زیر مجاز است: .in 1.5i .ft CR .nf _bar _hide _cylinder ( ... ) .fi .ft R .in معیارها، رنگ‌ها و برچسب‌ها را می‌توان با هر ترتیبی درون پرانتزها مشخص کرد. تنها .I metric-list اجباری است. .TP 4n .I metric-list فهرست معیارهای .B _bar شامل فهرستی از نام‌های معیار، مقادیر نرمال‌سازی و یک برچسب اختیاری برای معیار است: .RS 4n .ft CR .nf \f3_metrics\f1 \f3(\f1 \f2metric\f1 \f2real\f1 [\f2string\f1] [\f2metric\f1 \f2real\f1 [\f2string\f1]...] \f3)\f1 .fi .ft R .RE .TP 4n .I color-list فهرست رنگ‌های .B _bar می‌تواند یک فهرست رنگ نام‌گذاری‌شده باشد که پیش‌تر تعریف شده است، یا یک فهرست رنگ بی‌نام. هنگام استفاده از مدولاسیون .B _colormod یا .B _colorymod باید از فهرست .B _colorScale استفاده شود. بنابراین، نحو فهرست‌های رنگ درون شیء .B _bar یکی از موارد زیر است: .RS 4n .ft CR .nf \f3_colorList\f1 \f2name\f1 \f3_colorList\f1 \f3(\f1 \f2color\f1 [\f2color\f1...] \f3)\f1 \f3_colorScale\f1 \f2name\f1 \f3_colorScale \f2color\f1 \f3(\f1 \f2color\f1 \f2real\f1 [\f2color\f1 \f2real\f1...] \f3)\f1 .fi .ft R .RE .TP 4n .I label-list علاوه بر برچسب‌های هر معیار در .IR metric-list ، برچسب‌های معیار و نمونه می‌توانند با استفاده از دستورات .B _metriclabels و .B _instlabels تعریف شوند. موقعیت برچسب‌ها در اطراف شیء .B _bar بستگی به جهت‌گیری سطری .RB ( _row ) یا ستونی .RB ( _col ) معیارها و نمونه‌ها دارد، و اینکه برچسب به سمت شیء .B _bar خوانده شود .RB ( _towards ) یا به سمت خارج .RB ( _away ). مقدار پیش‌فرض .B _towards است. .RS 4 .ft CR .nf \f3_metriclabels\f1 [\f3_away\f1|\f3_towards\f1] \f3(\f1 \f2name\f1|\f2string\f1 [\f2name\f1|\f2string\f1...] \f3)\f1 \f3_instlabels\f1 [\f3_away\f1|\f3_towards\f1] \f3(\f1 \f2name\f1|\f2string\f1 [\f2name\f1|\f2string\f1...] \f3)\f1 .fi .ft R .RE .RE .TP 4n \f3_grid\f1 [\f2pos\f1] [\f3_show\f1|\f3_hide\f1] \f3(\f1 \f2objects\f1 \f3)\f1 شیء .B _grid یک ظرف برای اشیاء، از جمله سایر اشیای .BR _grid ، است. سطرها و ستون‌های شیء .B _grid به اندازه بزرگ‌ترین شیء موجود در آن سطر یا ستون تغییر اندازه می‌دهند. اگر یک شیء چندین سطر و/یا ستون را در بر بگیرد، آن سطرها و ستون‌ها ممکن است برای دربرگرفتن شیء تا حدی تغییر اندازه دهند. با این حال، تغییر اندازه سطرها و ستون‌ها برای اشیایی که چندین سطر و ستون را اشغال می‌کنند، پس از تغییر اندازه اشیایی که تنها یک مربع شبکه را اشغال می‌کنند رخ می‌دهد. تداخل بین اشیایی که خانه‌های یکسانی را اشغال می‌کنند به عنوان پیام خطا گزارش شده و شیء بعدی نادیده گرفته خواهد شد. گزینه‌های شیء .B _grid موقعیت .RI ( pos ) شیء .B _grid را در .B _grid والد کنترل می‌کنند، و مشخص می‌سازند که آیا صفحه پایه .B _grid نمایش داده شود .RB ( _show ) یا پنهان باشد .RB ( _hide ). به طور پیش‌فرض، صفحه پایه پنهان است. پارامترهای شرح داده‌شده در بالا می‌توانند درون پرانتزهای یک شیء .B _grid مشخص شوند، با این حال آن‌ها تنها روی اشیای درون آن .BR _grid اعمال می‌شوند، نه روی خود .BR _grid . برای اینکه پارامتری روی یک شیء .B _grid اعمال شود، باید پیش از اعلان شیء .B _grid مشخص گردد. .TP 4n .I "\f3_label\f1 [\f2options\f1] \f2string\f1" شیء .B _label محتوای .I string را در موقعیت، جهت‌گیری و اندازه مشخص‌شده در .I options رسم می‌کند: .RS 4n .TP 4n .I pos موقعیت شیء .B _label در شیء .B _grid جاری. .TP 4n \f3_left\f1|\f3_right\f1|\f3_up\f1|\f3_down\f1 جهت‌گیری .IR string . جهت نشان‌دهنده سمتی است که برچسب خوانده می‌شود. بنابراین، .B _right پیش‌فرض است چرا که رشته از چپ به راست خوانده می‌شود. .TP 4n \f3_small\f1|\f3_medium\f1|\f3_large\f1 اندازه قلم. مقدار پیش‌فرض .B _medium است. .RE .TP 4n \f3_link\f1 \f2pos\f1 [\f2string\f1] شیء .B _link یک «لوله» گرد افقی مستقیم یا L-شکل رسم می‌کند که قطر آن برابر با ۸۰٪ مقدار .I _baseHeight در .B _grid دربرگیرنده است. ویژگی‌های این شیء توسط گزینه‌ها تعریف می‌شوند: .RS 4n .TP 4n .I pos هم موقعیت .B _link روی شبکه و هم شکل آن را تعیین می‌کند. .B _link از ستون و سطری در .B _grid شروع می‌شود که توسط دو عدد اول در .I pos مشخص شده است، و به اندازه تعداد ستون‌ها و سطرهای مشخص‌شده توسط دو عدد دوم امتداد می‌یابد. مقدار .I alignment برای تعیین جهت‌گیری پیوند استفاده می‌شود (پیوندها همیشه در مرکز تراز می‌شوند): پیوندهای .I east و .I west مستقیم هستند و از چپ به راست می‌روند، پیوندهای .I north و .I south مستقیم هستند و از انتهای دور شبکه به انتهای نزدیک می‌آیند، و پیوندهای .I northeast، .I northwest، .I southeast و .I southwest L-شکل هستند و نقاط مربوطه قطب‌نما را به هم وصل می‌کنند؛ یعنی یک پیوند .I northeast شکل کلی حرف لاتین «L» را به خود می‌گیرد. .TP 4n .I string یک برچسب متنی (tag) برای .B _link تنظیم می‌کند که هنگام قرار گرفتن نشانگر ماوس روی پیوند، در پنجره متنی نمایش داده خواهد شد. .RE .TP 4n \f3_pipe\f1 \f2pos\f1 \f3(\f1 [\f2metric-list\f1] [\f2color-list\f1] [\f2tag\f1] \f3)\f1 شیء .B _pipe نمایانگر مجموعه‌ای از استوانه‌ها است که روی یکدیگر قرار گرفته و به موازات صفحه پایه جهت‌گیری شده‌اند. قطر یک .B _pipe برابر با ۸۰٪ مقدار .I _baseHeight است. تعداد بلوک‌ها بستگی به تعداد نمونه‌های معیار در .I metric-list دارد. رنگ‌های موجود در .I color-list به نوبت به هر استوانه در .B _pipe اختصاص می‌یابند. طول .B _pipe توسط .I _pipeLength تعیین می‌شود. .RS 4n .TP 4n .I pos موقعیت .B _pipe را در .B _grid دربرگیرنده و جهت‌گیری آن را مشخص می‌کند؛ که در آن فیلد .I alignment برای مشخص کردن این به کار می‌رود که استوانه‌های رنگی در کدام انتهای لوله روی هم چیده شوند. استوانه‌ها در جهت قطب‌نمای متناظر چیده می‌شوند و جهت لوله از آن جهت قطب‌نما به سمت مرکز قطب‌نما است. تنها مقادیر .IR east ، .IR west ، .IR north و .I south برای تراز لوله معتبر هستند. .RE معیارها، رنگ‌ها و برچسب را می‌توان با هر ترتیبی درون پرانتزها مشخص کرد. تنها .I metric-list اجباری است. .TP 4n .I metric-list فهرست معیارهای .B _pipe شامل فهرستی از نام‌های معیار و مقادیر نرمال‌سازی است: .RS 4n .ft CR .nf \f3_metrics\f1 \f3(\f1 \f2metric\f1 \f2real\f1 [\f2metric\f1 \f2real\f1...] \f3)\f1 .fi .ft R .RE .TP 4n .I color-list فهرست رنگ‌های .B _pipe می‌تواند یک فهرست رنگ نام‌گذاری‌شده باشد که پیش‌تر تعریف شده است، یا یک فهرست رنگ بی‌نام: .RS 4n .ft CR .nf \f3_colorList\f1 \f2name\f1 \f3_colorList\f1 \f3(\f1 \f2color\f1 [\f2color\f1...] \f3)\f1 .fi .ft R .RE .TP 4n .I tag یک .B _pipe می‌تواند دارای یک برچسب متنی (tag) برای بلوک پرکننده (بلوک غیرمتحرک در انتهای دیگر لوله) باشد که وقتی نشانگر ماوس روی آن انتهای لوله قرار گیرد در پنجره متنی نمایش داده خواهد شد. .RS 4n .ft CR .nf \f3_pipeTag\f1 \f2name\f1|\f2string\f1 .fi .ft R .RE .TP 4n \f3_stack\f1 [\f2options\f1] \f3(\f1 [\f2metric-list\f1] [\f2color-list\f1] [\f2label\f1] \f3)\f1 شیء .B _stack نمایانگر مجموعه‌ای از بلوک‌ها است که به صورت عمودی روی یکدیگر قرار گرفته‌اند. تعداد بلوک‌ها بستگی به تعداد نمونه‌های معیار در .I metric-list دارد. رنگ‌های موجود در .I color-list به هر بلوک در .B _stack اختصاص می‌یابند. به طور پیش‌فرض، ارتفاع .B _stack برابر با مجموع ارتفاع هر بلوک خواهد بود. گزینه‌های .I options که می‌توانند به شیء .B _stack داده شوند عبارتند از: .RS 4n .TP 4n .I pos موقعیت شیء .B _stack درون شیء .B _grid جاری. .TP 4n \f3_show\f1|\f3_hide\f1 آیا صفحه پایه قابل مشاهده است؟ مقدار پیش‌فرض .B _show است. .TP 4n \f3_utilmod\f1|\f3_fillmod\f1 وادار کردن ارتفاع پشته به اینکه همیشه حداکثر ارتفاع ممکن باشد. این کار با نرمال‌سازی ارتفاع هر بلوک .RB ( _utilmod ) یا با افزودن یک بلوک خاکستری به بالای پشته .RB ( _fillmod ) انجام می‌شود. .TP 4n \f3_cube\f1|\f3_cylinder\f1 تعیین شکل بلوک‌ها. مقدار پیش‌فرض .B _cube است. .RE .RS 4n .PP گزینه‌ها باید دقیقاً به همین ترتیب مشخص شوند، هرچند گزینه‌های قبلی الزامی نیستند. بنابراین عبارت زیر مجاز است: .in 1.5i .ft CR .nf _stack 1 1 _north _utilmod ( ... ) .fi .ft R .in معیارها، رنگ‌ها و برچسب را می‌توان با هر ترتیبی درون پرانتزها مشخص کرد. تنها .I metric-list اجباری است. .TP 4n .I metric-list فهرست معیارهای .B _stack شامل فهرستی از نام‌های معیار و مقادیر نرمال‌سازی است: .RS 4n .ft CR .nf \f3_metrics\f1 \f3(\f1 \f2metric\f1 \f2real\f1 [\f2metric\f1 \f2real\f1...] \f3)\f1 .fi .ft R .RE .TP 4n .I color-list فهرست رنگ‌های .B _stack می‌تواند یک فهرست رنگ نام‌گذاری‌شده باشد که پیش‌تر تعریف شده است، یا یک فهرست رنگ بی‌نام: .RS 4n .ft CR .nf \f3_colorList\f1 \f2name\f1 \f3_colorList\f1 \f3(\f1 \f2color\f1 [\f2color\f1...] \f3)\f1 .fi .ft R .RE .TP 4n .I label یک شیء .B _stack از نوع .B _fillmod می‌تواند یک برچسب برای بلوک پرکننده داشته باشد: .RS 4n .ft CR .nf \f3_stackLabel\f1 \f2name\f1|\f2string\f1 .fi .ft R .RE .RE .TP 4n \f3_xing\f1 \f2col\f1 \f2row\f1 \f2columns\f1 \f2rows\f1 \f2dir1\f1 ... \f2dir4\f1 شیء .B _xing نوع ویژه‌ای از پیوند است که برای رسم یک جفت پیوند متقاطع به کار می‌رود. برای القای این برداشت بصری که پیوندها به هم وصل نمی‌شوند، یکی از پیوندها به عنوان یک استوانه «شکسته» رسم می‌شود. .I col و .I row موقعیت را روی شبکه دربرگیرنده تعریف می‌کنند. .I columns و .I rows اندازه کادر احاطه‌کننده (bounding box) را تعیین می‌کنند. نقاط پایانی استوانه‌های متقاطع دقیقاً در مرکز خانه‌های گوشه‌ای کادر احاطه‌کننده قرار می‌گیرند و از چهار استوانه کوچک یا تکه‌لوله (stub) برای اتصال پیرامون کادر احاطه‌کننده به نقاط پایانی روی استوانه‌های متقاطع استفاده می‌شود. چهار مقدار .I dir جهت‌گیری این تکه‌لوله‌ها را مشخص می‌کنند، که از گوشه بالا سمت چپ .B _xing شروع شده و در جهت عقربه‌های ساعت پیش می‌روند، به گونه‌ای که تکه‌لوله‌های مربوطه برای اتصال نقطه قطب‌نما به مرکز سلول استفاده می‌شوند (مثال را ببینید). .SH "مثال (EXAMPLE)" این مثال ساده استفاده از پارامترها و انواع مختلف اشیاء را نشان می‌دهد: .in 1i .ft CR .nf pmview Version 2.1 # Use a lighter grey for the base planes _baseColor "#7f7f7f" # Define colors for CPU object _colorList cpu ( blue2 red2 yellow2 cyan2 green2 ) # The top grid object, but hide it from view _grid _hide ( # Show the current load in a bar object _bar 0 0 ( _baseLabel "Load averages over a\\n1, 5 and 15 minute interval" _metrics ( kernel.all.load[1] 1 "1" kernel.all.load[5] 1 "5" kernel.all.load[15] 1 "15" ) _colorList ( blue blue blue ) ) # Add a label below the load bars _label 0 1 "Load" # Change the color of the base plane for later objects _baseColor "#fba2f5" # pink # Show the CPU usage over all CPUs in a utilization stack _stack 2 0 _south _utilmod ( _baseLabel "CPU Utilization over all CPUs" _metrics ( kernel.all.cpu.user 1000 kernel.all.cpu.sys 1000 kernel.all.cpu.intr 1000 kernel.all.cpu.wait.total 1000 kernel.all.cpu.idle 1000 ) _colorList cpu ) # Add a label below the CPU stack _label 2 1 "CPU" # Create a separate grid for links and pipes _marginWidth 1 _marginDepth 1 _gridSpace 12 _grid 0 3 5 4 _hide ( _pipeLength 12 _baseHeight 12 # Add a pipe and a link with western orientation _pipe 0 0 west ( _pipeTag "West pipe" _metrics ( kernel.all.cpu.user 1000 kernel.all.cpu.sys 1000 kernel.all.cpu.idle 1000 ) _colorList cpu ) _link 0 2 west "West link" # Add xing _xing 1 0 3 3 west east east west # Add a link and a pipe with eastern orientation _pipe 4 0 east ( _pipeTag "East Pipe" _metrics ( kernel.all.cpu.user 1000 kernel.all.cpu.sys 1000 kernel.all.cpu.idle 1000 ) _colorList cpu ) _link 4 2 east "East link" ) ) .fi .ft R .in .SH "همچنین ببینید (SEE ALSO)" .BR pmview (1). .\" control lines for scripts/man-spell .\" +ok+ _groupbymetric _metriclabels _groupbyinst _labelMargin _marginDepth .\" +ok+ _marginWidth command_line _baseHeight _colorScale _groupbyrow .\" +ok+ _instlabels _labelColor _pipeLength _stackLabel _barHeight _barLength .\" +ok+ _baseColor _baseLabel _colorList _colorymod _gridDepth _gridSpace .\" +ok+ _gridWidth unanimated groupbycol _colormod _cylinder _gapDepth .\" +ok+ _gapLabel _gapWidth coldToHot myarchive _fillmod _metrics _pipeTag .\" +ok+ _towards _utilmod _medium _metric psusage _label _large _north .\" +ok+ _right _scale _shown _small _south _stack myhost _away _cube _down .\" +ok+ _grid _hide _left _link _pipe _show stime utime _xing _ymod _bar .\" +ok+ _col xing {from "Add xing"} intr _row cyan dir col pos _up sys .\" +ok+ qcolor QColor qt {from URL} .\" +ok+ fba ff {from #.... colors}