'\"macro stdmacro
.\"
.\" Copyright (c) 2018,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-PIDSTAT 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
\f3pcp-pidstat\f1 \- گزارش آمار تسک‌های لینوکس
.SH "خلاصه دستور (SYNOPSIS)"
\f3pcp\f1
[\f2pcp\ options\f1]
\f3pidstat\f1
[\f3\-I\f1]
[\f3\-l\f1]
[\f3\-R\f1]
[\f3\-r\f1]
[\f3\-k\f1]
[\f3\-U\f1 [\f2username\f1]]
[\f3\-V\f1]
[\f3\-G\f1 \f2processname\f1]
[\f3\-p\f1 \f2pid1,pid2..\f1]
[\f3\-t\f1 \fIinterval\f1]
[\f3\-s\f1 \fIcount\f1]
[\f3\-a\f1 \f2archive\f1]
[\f3\-B\f1 \f2state\f1]
[\f3\-f\f1 \f2format\f1]
[\f3\-Z\f1 \f2timezone\f1]
[\f3\-z\f1]
[\f3\-?\f1]
.SH "توضیحات (DESCRIPTION)"
دستور
.B pcp-pidstat
برای نظارت بر تسک‌های منفرد در حال اجرا روی سیستم به کار می‌رود.
با استفاده از گزینه‌های گوناگون، این ابزار به کاربر کمک می‌کند تا اطلاعات مفیدی درباره فرایندها مشاهده نماید.
این اطلاعات شامل درصد استفاده از CPU، میزان مصرف حافظه و پشته، زمان‌بندی و اولویت است.
به‌طور پیش‌فرض،
.B pcp-pidstat
داده‌های زنده را برای میزبان محلی گزارش می‌کند.
.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 options
دیگر به‌طور غیرمستقیم در دسترس قرار می‌گیرند؛ برای توضیحات کامل درباره این گزینه‌ها به
.BR PCPIntro (1)
مراجعه کنید.
.PP
گزینه‌های خط فرمان اضافی موجود برای
.B pcp-pidstat
عبارت‌اند از:
.TP 5
.BR \-I \fR
در یک محیط SMP، مشخص می‌کند که میزان مصرف CPU تسک‌ها باید بر تعداد کل پردازنده‌ها تقسیم شود.
.TP
.BR \-l \fR
نمایش نام دستور فرایند و تمام آرگومان‌های آن.
.TP
.BR \-R \fR
گزارش اولویت بلادرنگ و اطلاعات خط‌مشی زمان‌بندی.
مقدارهای زیر ممکن است نمایش داده شوند:

UID
       شناسه کاربری واقعی تسک در حال نظارت.

USER
       نام کاربر واقعی مالک تسک در حال نظارت.

PID
       شناسه فرایند تسک در حال نظارت.

prio
       اولویت بلادرنگ تسک در حال نظارت.

policy
       خط‌مشی زمان‌بندی تسک در حال نظارت.

Command
       نام دستور تسک.
.TP
.BR \-r \fR
گزارش خطاهای صفحه (page faults) و میزان مصرف حافظه.
مقدارهای زیر ممکن است نمایش داده شوند:

UID
       شناسه کاربری واقعی تسک در حال نظارت.

USER
       نام کاربر واقعی مالک تسک در حال نظارت.

PID
       شناسه فرایند تسک در حال نظارت.

minflt/s
       تعداد کل خطاهای جزئی (minor faults) ایجادشده توسط تسک در هر ثانیه؛ خطاهایی که نیازی به بارگذاری صفحه حافظه از دیسک نداشته‌اند.

majflt/s
       تعداد کل خطاهای عمده (major faults) ایجادشده توسط تسک در هر ثانیه؛ خطاهایی که نیازمند بارگذاری صفحه حافظه از دیسک بوده‌اند.

VSZ
       Virtual Size: کل حافظه مجازی مورد استفاده کل تسک بر حسب کیلوبایت.

RSS
       Resident Set Size: حافظه فیزیکی مبادله‌نشده (non-swapped) مورد استفاده تسک بر حسب کیلوبایت.

%MEM
       سهم فعلی تسک از کل حافظه فیزیکی موجود بر حسب درصد.

Command
       نام دستور تسک.
.TP
.BR \-k \fR
گزارش میزان مصرف پشته (stack).
مقدارهای زیر ممکن است نمایش داده شوند:

UID
      شناسه کاربری واقعی تسک در حال نظارت.

USER
      نام کاربر واقعی مالک تسک در حال نظارت.

PID
      شناسه فرایند تسک در حال نظارت.

StkSize
      میزان حافظه بر حسب کیلوبایت که به عنوان پشته برای تسک رزرو شده، اما لزوماً استفاده نشده است.

StkRef
      میزان حافظه بر حسب کیلوبایت که به عنوان پشته ارجاع داده شده و توسط تسک استفاده شده است.

Command
      نام دستور تسک.
.TP
.BR \-U \ [\fIusername\fR] ", " \fB\-\-user\-name\fI[=username]\fR
نمایش نام کاربر واقعی تسک‌های در حال نظارت به جای UID.
اگر \fIusername\fR مشخص شود، تنها تسک‌های متعلق به کاربر مشخص‌شده نمایش داده می‌شوند.
.TP
.BR \-V \fR ", " \fB\-\-version\fR
چاپ شماره نسخه و سپس خروج.
.TP
.BR \-G \ \fIprocessname\fR ", " \fB\-\-process-name=\fIprocessname\fR
فقط فرایندهایی را نمایش می‌دهد که نام دستور آن‌ها شامل رشتهٔ \fIprocessname\fR باشد.
این رشته می‌تواند یک عبارت منظم (regular expression) باشد.
.TP
.BR \-p \ \fIpid1,pid2..\fR ", " \fB\-\-pid-list=\fIpid1,pid2..\fR
تنها نمایش فرایندهایی که دارای PIDهای فهرست‌شده هستند.
.TP
.BR \-t \ \fIinterval\fR ", " \fB\-\-interval=\fIinterval\fR
تنظیم فاصله زمانی بین دو نمونه‌برداری.
مقدار پیش‌فرض یک ثانیه است.
.TP
.BR \-s \ \fIcount\fR ", " \fB\-\-samples=\fIcount\fR
تنظیم تعداد نمونه‌هایی که باید نمایش داده شوند.
از آنجا که نمونه اول برای تبدیل نرخ برخی از معیارها استفاده می‌شود، تعداد کل نمونه‌های گزارش‌شده یکی کمتر از \fIcount\fR خواهد بود.
حالت پیش‌فرض، ادامه‌دار و پیوسته است.
.TP
.BR \-a \ \fIarchive\fR ", "\fB\-\-archive=\fIarchive\fR
باعث می‌شود \f3pcp-pidstat\f1 به جای اتصال به PMCD از آرشیو مشخص‌شده استفاده کند.
آرگومان ورودی \f3-a\f1 فهرستی از نام‌هاست که با کاما از هم جدا شده‌اند، و هر کدام می‌تواند نام پایه یک آرشیو یا نام دایرکتوری حاوی یک یا چند آرشیو باشد.
.TP
.BR \-B \fR
گزارش وضعیت فرایندها.
آرگومان ورودی -B یکی از موارد زیر است:

\fBdetail\fP
       نمایش کل زمانی که فرایندها در هر یک از ۵ وضعیت مختلف سپری کرده‌اند

\fBall\fP
       نمایش کل زمانی که فرایندها در وضعیت فعلی خود سپری کرده‌اند

[\fBR\fP,\fBS\fP,\fBT\fP,\fBD\fP,\fBZ\fP]
       فهرستی از وضعیت‌های فرایند که با کاما از هم جدا شده‌اند. برای نمونه، \fB-B R,S\fP فرایندهایی را که هم‌اکنون در یکی از وضعیت‌های \fBR\fP یا \fBS\fP هستند گزارش می‌دهد و فرایندهایی را که در هر وضعیت دیگری باشند گزارش نخواهد کرد.
.TP
.BR \-f \fR
استفاده از رشته قالب‌بندی برای شکل‌دهی به برچسب زمان (timestamp).
این قالب با متد datetime.strftime در
.BR python (1)
استفاده می‌شود که مشابه با موارد شرح‌داده‌شده در
.BR strftime (3)
است.
یک رشته قالب خالی (یعنی "") برچسب‌های زمانی را از خروجی حذف خواهد کرد.
مقدار پیش‌فرض در stdout برابر با %H:%M:%S است.
.TP
.BR \-Z \ \fItimezone\fR ", "\fB\-\-timezone=\fItimezone\fR
به‌طور پیش‌فرض،
.B pcp-pidstat
زمان روز را بر اساس منطقه زمانی محلی سیستمی که
.B pcp-pidstat
روی آن اجرا می‌شود گزارش می‌کند.
گزینهٔ
.B \-Z
منطقه زمانی را به
.I timezone
در قالب متغیر محیطی
.B TZ
همان‌طور که در
.BR environ (7)
شرح داده شده است، تغییر می‌دهد.
.TP
.BR \-z " , " \fB\-\-hostzone\fR
تغییر منطقه زمانی گزارش‌دهی به منطقه زمانی محلی در میزبانی که منبع معیارهای کارایی است.
هنگام بازپخش یک آرشیو PCP که در یک منطقه زمانی دیگر ضبط شده است، گزینهٔ
.B \-z
تقریباً همیشه استفاده می‌شود (منطقه زمانی پیش‌فرض گزارش‌دهی، منطقه زمانی محلی است که ممکن است با منطقه زمانی آرشیو PCP یکسان نباشد).
.TP
.BR \-? " , " \fB\-\-help\fR
نمایش پیام راهنمای استفاده و خروج.
.SH "نکات (NOTES)"
دستور
.B pcp-pidstat
از دستور
.BR pidstat (1)
الهام گرفته شده و هدف آن سازگاری در خط فرمان و قالب خروجی با آن است.
.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 pidstat (1)،
.BR python (1)،
.BR pmParseInterval (3)،
.BR strftime (3)
و
.BR environ (7).

.\" control lines for scripts/man-spell
.\" +ok+ datetime pidstat StkSize majflt minflt StkRef
.\" +ok+ prio SMP RSS VSZ