'\"macro stdmacro
.\"
.\" Copyright (c) 2017,2019 Red Hat.
.\"
.\" 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 PCP-MPSTAT 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
\f3pcp-mpstat\f1 \- گزارش آمار و اطلاعات مربوط به پردازنده و وقفه‌ها.
.SH "خلاصه دستور (SYNOPSIS)"
.B pcp
[\f2pcp\ options\f1]
.B mpstat [ -A ] [ -u ] [ -V ] [ -I {
.B SUM | CPU | SCPU | ALL } ] [ -P {
.I cpu1,cpu2
.B [,...] | ON | ALL } ] [ -t
.I interval
.B ] [ -s
.I count
.B ] [ -a
.I archive
.B ] [ -? ]
.SH "توضیحات (DESCRIPTION)"
دستور
.B pcp-mpstat
فعالیت‌های هر پردازندهٔ در دسترس را در خروجی استاندارد می‌نویسد، که پردازندهٔ ۰ نخستین آن‌ها است.
اگر هیچ فعالیت/گزینه‌ای انتخاب نشده باشد، گزارش پیش‌فرض همان گزارش میزان استفاده از پردازنده (\f3-u\f1) است.
.PP
پارامتر
.I interval
میزان زمان بر حسب ثانیه را بین هر گزارش مشخص می‌کند.
مقدار پیش‌فرض یک ثانیه است.
مقدار پارامتر
.I count
تعداد نمونه‌هایی را که باید نمایش داده شوند تعیین می‌کند.
حالت پیش‌فرض پیوسته است.
.SH "گزینه‌ها (OPTIONS)"
هنگامی که این ابزار از طریق دستور
.BR pcp (1)
فراخوانی شود، گزینه‌های
.BR \-h /\c
.BR \-\-host ،
.BR \-a /\c
.BR \-\-archive ،
.BR \-O /\c
.BR \-\-origin ،
.BR \-s /\c
.BR \-\-samples ،
.BR \-t /\c
.BR \-\-interval ،
.BR \-Z /\c
.BR \-\-timezone
و چندین
.I گزینهٔ pcp
دیگر به‌طور غیرمستقیم در دسترس قرار می‌گیرند؛ برای توضیح کامل این گزینه‌ها به
.BR PCPIntro (1)
مراجعه کنید.
.PP
گزینه‌های دیگر خط فرمان که برای
.B pcp-mpstat
در دسترس هستند عبارتند از:
.IP -A
این گزینه معادل با مشخص کردن
.BR "-u -I ALL -P ALL"
است.
.IP "-I { SUM | CPU | SCPU | ALL }"
گزارش آمار وقفه‌ها.
.br
با کلیدواژهٔ
.BR SUM ،
دستور
.B pcp-mpstat
تعداد کل وقفه‌ها را به‌ازای هر پردازنده گزارش می‌دهد.
مقادیر زیر نمایش داده می‌شوند:
.PP
.B CPU
.RS
.RS
شمارهٔ پردازنده.
کلیدواژهٔ
.I all
نشان می‌دهد که آمار به عنوان میانگین در میان تمام پردازنده‌ها محاسبه شده است.
.RE

.B intr/s
.RS
نمایش تعداد کل وقفه‌های دریافت‌شده در هر ثانیه توسط پردازنده یا پردازنده‌ها.
.RE

با کلیدواژهٔ
.BR CPU ،
تعداد هر یک از وقفه‌های مجزای دریافت‌شده در هر ثانیه توسط پردازنده یا پردازنده‌ها نمایش داده می‌شود.
وقفه‌ها مواردی هستند که در درخت سنجه‌های kernel.percpu.interrupts قرار دارند.
.br
نام نمونه‌های عددی (برای مثال شماره‌های IRQ) پیش از برچسب‌های غیرعددی فهرست می‌شوند تا با افزوده شدن گرداننده‌های نام‌دار جدید، خروجی پایدار بماند.
.br
اگر منبع فعلی (میزبان یا بایگانی) سنجه‌های وقفهٔ به‌ازای‌هر‌پردازنده را ارائه ندهد، این گزارش عبارت
.B "No per-CPU interrupt metrics available for this context."
را چاپ کرده و از جدول صرف‌نظر می‌کند.

با کلیدواژهٔ
.BR SCPU ،
تعداد هر یک از وقفه‌های نرم‌افزاری مجزای دریافت‌شده در هر ثانیه توسط پردازنده یا پردازنده‌ها نمایش داده می‌شود.
وقفه‌های نرم‌افزاری مواردی هستند که در درخت kernel.percpu.softirqs قرار دارند.
.br
خروجی پیش از هر برچسب نرم‌وقفهٔ (softirq) باقی‌مانده، از ترتیب استاندارد نرم‌وقفه‌های
.BR HI ،
.BR TIMER ،
.BR NET_TX ،
.BR NET_RX ،
.BR BLOCK ،
.BR IRQ_POLL ،
.BR TASKLET ،
.BR SCHED ،
.BR HRTIMER
و
.BR RCU
پیروی می‌کند، که قرارگیری هماهنگ ستون‌ها را در میان نمونه‌ها تضمین می‌نماید.
.br
هنگامی که سنجه‌های نرم‌وقفهٔ به‌ازای‌هر‌پردازنده در زمینهٔ فعلی موجود نباشد، گزارش به‌جای جدول، عبارت
.B "No per-CPU softirq metrics available for this context."
را صادر می‌کند.

کلیدواژهٔ
.B ALL
معادل با مشخص کردن تمام کلیدواژه‌های بالا است و بنابراین تمام آمارهای وقفه‌ها نمایش داده می‌شوند.
.RE

.IP "-P { cpu1,cpu2[,...] | ON | ALL }"
شمارهٔ پردازنده‌ای را مشخص می‌کند که آمار باید برای آن گزارش شود.
.I cpu1
و
.I cpu2
شماره‌های پردازنده هستند.
می‌توان فهرستی از شماره‌های پردازندهٔ مورد نیاز را ارائه کرد.
توجه داشته باشید که پردازندهٔ ۰ نخستین پردازنده است.

کلیدواژهٔ
.B ON
نشان می‌دهد که آمار باید برای هر پردازندهٔ برخط (online) گزارش شود، در حالی که کلیدواژهٔ
.B ALL
نشان می‌دهد که آمار باید برای همهٔ پردازنده‌ها گزارش شود.
.IP -u
گزارش میزان استفاده از پردازنده.
مقادیر زیر نمایش داده می‌شوند:

.B CPU
.RS
.RS
شمارهٔ پردازنده.
کلیدواژهٔ
.I ALL
نشان می‌دهد که آمار به عنوان میانگین در میان تمام پردازنده‌ها محاسبه شده است.
.RE

.B %usr
.RS
نمایش درصد استفاده از پردازنده که هنگام اجرا در سطح کاربر (برنامه‌ها) رخ داده است.
.RE

.B %nice
.RS
نمایش درصد استفاده از پردازنده که هنگام اجرا در سطح کاربر با اولویت nice رخ داده است.
.RE

.B %sys
.RS
نمایش درصد استفاده از پردازنده که هنگام اجرا در سطح سیستم (هسته) رخ داده است.
توجه داشته باشید که این مقدار شامل زمان صرف‌شده برای رسیدگی به وقفه‌های سخت‌افزاری و نرم‌افزاری نمی‌شود.
.RE

.B %iowait
.RS
نمایش درصد زمانی که پردازنده یا پردازنده‌ها در حالی بیکار بوده‌اند که سیستم یک درخواست ورودی/خروجی دیسک معلق داشته است.
.RE

.B %irq
.RS
نمایش درصد زمان صرف‌شده توسط پردازنده یا پردازنده‌ها برای رسیدگی به وقفه‌های سخت‌افزاری.
.RE

.B %soft
.RS
نمایش درصد زمان صرف‌شده توسط پردازنده یا پردازنده‌ها برای رسیدگی به وقفه‌های نرم‌افزاری.
.RE

.B %steal
.RS
نمایش درصد زمان صرف‌شده در انتظار غیرداوطلبانه توسط پردازنده یا پردازنده‌های مجازی در حالی که هایپروایزر در حال رسیدگی به یک پردازندهٔ مجازی دیگر بوده است.
.RE

.B %guest
.RS
نمایش درصد زمان صرف‌شده توسط پردازنده یا پردازنده‌ها برای اجرای یک پردازندهٔ مجازی.
.RE

.B %gnice
.RS
نمایش درصد زمان صرف‌شده توسط پردازنده یا پردازنده‌ها برای اجرای یک میهمان با اولویت nice.
.RE

.B %idle
.RS
نمایش درصد زمانی که پردازنده یا پردازنده‌ها بیکار بوده‌اند و سیستم هیچ درخواست معلق ورودی/خروجی دیسک نداشته است.
.RE

نکته: در سامانه‌های SMP، پردازنده‌ای که مطلقاً هیچ فعالیتی ندارد، یک پردازندهٔ غیرفعال (offline) محسوب می‌شود.
.RE

.IP "-s \ N , --samples = N"
تنظیم تعداد نمونه‌هایی که باید نمایش داده شوند.
از آنجا که نخستین نمونه برای تبدیل نرخ برخی از سنجه‌ها استفاده می‌شود، تعداد کل نمونه‌های گزارش‌شده یکی کمتر از N خواهد بود.
حالت پیش‌فرض پیوسته است.

.IP "-t DELTA , --interval = DELTA"
تنظیم فاصلهٔ زمانی بین دو نمونه.
پیش‌فرض یک ثانیه است.

.IP "-a  FILE , --archive = FILE "
باعث می‌شود \f3pcp-mpstat\f1 به‌جای اتصال به PMCD از بایگانی مشخص‌شده استفاده کند.
آرگومان \f3-a\f1 فهرستی از نام‌های جداشده با کاما است که هر یک می‌تواند نام پایهٔ یک بایگانی یا نام دایرکتوری حاوی یک یا چند بایگانی باشد.

.IP "-V , --version"
چاپ شمارهٔ نسخه و سپس خروج.

.IP "-? , --help"
چاپ پیام راهنمای نحوهٔ استفاده و سپس خروج.
.SH "مثال‌ها (EXAMPLES)"
.B pcp-mpstat -t 2 -s 5
.RS
چهار گزارش از آمارهای سراسری میان تمام پردازنده‌ها را با فواصل زمانی دو ثانیه‌ای نمایش می‌دهد.
.RE
.PP
.B pcp mpstat -P ALL -t 2 -s 5
.RS
چهار گزارش از آمار تمام پردازنده‌ها را با فواصل زمانی دو ثانیه‌ای نمایش می‌دهد.
.SH "نکات (NOTES)"
دستور
.B pcp-mpstat
از دستور
.BR mpstat (1)
الهام گرفته شده و هدف آن سازگاری در خط فرمان و قالب خروجی با آن است.
.SH "محیط (ENVIRONMENT)"
متغیرهای محیطی
.BR TZ
و
.BR LC_TIME
می‌توانند برای لغو و بازنویسی قالب پیش‌فرض نمایش تاریخ در
.BR pcp-mpstat
به کار روند.
.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 "همچنین ببینید (SEE ALSO)"
.BR PCPIntro (1)،
.BR pcp (1)،
.BR mpstat (1)،
.BR pmParseInterval (3)،
.BR pmTraversePMNS (3)
و
.BR environ (7).

.\" control lines for scripts/man-spell
.\" +ok+ softirqs LC_TIME iowait niced gnice
.\" +ok+ SCPU intr SMP irq sys mpstat {from pcp-mpstat}