'\" t
.\"
.\" Copyright (c) 2022 Oracle and/or its affiliates.
.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
.\"
.\" 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-PS 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
\f3pcp-ps\f1 \- گزارش آمار پردازه‌های لینوکس.
.SH "خلاصه دستور (SYNOPSIS)"
\f3pcp\f1
[\f2pcp\ options\f1]
\f3ps\f1
[\f3\-e\f1]
[\f3\-U\f1 [\f2username\f1]]
[\f3\-V\f1 \f2--version\f1]
[\f3\-c\f1 \f2Command name\f1]
[\f3\-P\f1 \f2pid1,pid2..\f1]
[\f3\-p\f1 \f2pid1,pid2..\f1]
[\f3\-o\f1 \f2col1,col2... or ALL\f1]
[\f3\-O\f1 \f2%mem,%cpu\f1]
[\f3\-d\f1]
[\f3\-Z\f1 \f2timezone\f1]
[\f3\-z\f1]
[\f3\-?\f1]
.SH "توضیحات (DESCRIPTION)"
دستور
.B pcp-ps
برای پایش تک‌تک پردازه‌های در حال اجرا روی سیستم استفاده می‌شود.
این ابزار با استفاده از گزینه‌های گوناگون به کاربر کمک می‌کند تا اطلاعات سودمندی را دربارهٔ پردازه‌ها مشاهده کند.
این اطلاعات شامل درصد پردازنده (CPU)، میزان مصرف حافظه و پشته، زمان‌بندی و اولویت است.
به‌طور پیش‌فرض،
.B pcp-ps
داده‌های زنده را برای میزبان محلی گزارش می‌کند.
.SH "گزینه‌ها (OPTIONS)"
هنگامی که این دستور از طریق دستور
.BR pcp (1)
فراخوانی شود، گزینه‌های
.BR \-h /\c
.BR \-\-host ،
.BR \-O /\c
.BR \-\-origin ،
.BR \-t /\c
.BR \-\-interval ،
.BR \-Z /\c
.BR \-\-timezone
و چندین
.I گزینهٔ pcp
دیگر به‌طور غیرمستقیم در دسترس قرار می‌گیرند؛ برای شرح کامل این گزینه‌ها به
.BR PCPIntro (1)
مراجعه کنید.
.PP
گزینه‌های خط فرمان اضافی موجود برای
.B pcp-ps
عبارتند از:
.TP 5
.BR \-e \fR
نمایش تمام پردازه‌ها.
.br
.TS
l l.
PID	شناسهٔ پردازه (Process identifier).
TTY	ترمینال مرتبط با پردازه.
TIME	T{
.ad l
.hy 0
زمان انباشته‌شدهٔ CPU در قالب [DD-]hh:mm:ss (time=TIME).
T}
CMD	نام وظیفه به همراه آرگومان‌های کامل آن.
.TE
.TP
.B \-c [\fIcommand name\fR]
به‌جای UID، نام واقعی دستور (Command name) مربوط به وظایف تحت پایش را نمایش می‌دهد.
اگر \fIcommand name\fR مشخص شده باشد، تنها وظایف متعلق به دستور مشخص‌شده نمایش داده می‌شوند.
.TP
.BR \-U \ [\fIusername\fR] ", " \fB\-\-user\-name\fR[=\fIusername\fR]
به‌جای UID، نام کاربری واقعی وظایف تحت پایش را نمایش می‌دهد.
اگر \fIusername\fR مشخص شده باشد، تنها وظایف متعلق به کاربر مشخص‌شده نمایش داده می‌شوند.
.TP
.BR \-V \fR ", " \fB\-\-version\fR
چاپ شمارهٔ نسخه و سپس خروج.
.TP
.BR \-p \ \fIpid1,pid2..\fR ", " \fB\-\-pid-list\fR=\fIpid1,pid2..\fR
تنها پردازه‌هایی را که دارای PIDهای فهرست‌شده هستند نمایش می‌دهد.
.TP
.BR \-P \ \fIppid1,ppid2..\fR ", " \fB\-\-ppid-list\fR=\fIppid1,ppid2..\fR
تنها پردازه‌هایی را که دارای PPIDهای فهرست‌شده هستند نمایش می‌دهد.
.TP
.B \-o
قالب تعریف‌شده توسط کاربر.

این گزینه یک تک‌آرگومان به شکل فهرستی جداشده با فاصله یا کاما است که روشی را برای تعیین تک‌تک ستون‌های خروجی فراهم می‌کند.

آرگومان‌های \-o موارد زیر هستند:

.TS
lfB  lfB  lfB
lfB  l    lx.
COL	HEADER	DESCRIPTION
_	_	_
%cpu	%CPU	میزان استفادهٔ پردازه از پردازنده (CPU)
%mem	%MEM	T{
.ad l
.hy 0
حافظهٔ فیزیکی روی دستگاه بیان‌شده به‌صورت درصد
T}
start	START	زمانی که دستور شروع به کار کرد
time	TIME	زمان پردازندهٔ انباشته‌شده، کاربر + سیستم (user + system)
cls	CLS	کلاس زمان‌بندی پردازه.
cmd	CMD	به \fBTask name\fR مراجعه کنید (نام‌های مستعار args، command).
args	COMMAND	T{
.ad l
.hy 0
نمایش نام کامل برنامه به همراه آرگومان‌های آن (در آخرین جایگاه فهرست \-o برای مشاهدهٔ کامل دستور استفاده شود)
T}
pid	PID	شناسهٔ پردازه (PID)
ppid	PPID	شناسهٔ پردازهٔ والد (PPID)
pri	PRI	اولویت پردازه
state	S	به \fBs\fR مراجعه کنید
rss	RSS	T{
.ad l
.hy 0
حافظهٔ فیزیکی جابه‌جانشده (غیر swap) که یک وظیفه استفاده کرده است
T}
rtprio	RTPRIO	اولویت بی‌درنگ (real-time)
pname	Pname	نام پردازه
tty	TT	ترمینالِ کنترل‌کننده (tty)
uid	UID	به \fBeuid\fR مراجعه کنید
uname	USER	به \fBeuser\fR مراجعه کنید
vsize	VSZ	به \fBvsz\fR مراجعه کنید
wchan	WCHAN	T{
.ad l
.hy 0
نام تابع کرنل که پردازه در آن در وضعیت خواب (sleeping) است
T}
.TE
.SH "مشخص‌کننده‌های قالب استاندارد (STANDARD FORMAT SPECIFIERS)"
در اینجا کلیدواژه‌های گوناگونی که می‌توان برای کنترل قالب خروجی (برای نمونه با گزینهٔ
.BR \-o )
یا مرتب‌سازی پردازه‌های برگزیده استفاده کرد، آورده شده‌اند:

برای نمونه:
.B pcp-ps \-o pid,\:user,\:args

.TS
lfB  lfB  lfB
lfB  l    lx.
CODE	HEADER	DESCRIPTION
_	_	_
pid	PID	عددی که شناسهٔ پردازه (PID) را نشان می‌دهد
%cpu	%CPU	T{
.ad l
.hy 0
درصد استفادهٔ پردازه از CPU در قالب "##.#".
.br
در حال حاضر، این مقدار برابر است با زمان پردازندهٔ استفاده‌شده تقسیم بر مدت زمانی که پردازه در حال اجرا بوده است (نسبت cputime/realtime)، که به‌صورت درصد بیان می‌شود.
T}
%mem	%MEM	T{
.ad l
.hy 0
درصد نسبت اندازهٔ مجموعهٔ مقیم (resident set size) پردازه به حافظهٔ فیزیکی دستگاه، بیان‌شده به‌صورت درصد.
T}
args	COMMAND	T{
.ad l
.hy 0
دستور همراه با تمامی آرگومان‌هایش به‌صورت یک رشته. تغییرات اعمال‌شده روی آرگومان‌ها ممکن است نمایش داده شوند. خروجی در این ستون ممکن است حاوی فاصله باشد. پردازه‌ای که با <defunct> علامت‌گذاری شده نیمه‌مرده است و در انتظار پاکسازی کامل توسط والد خود می‌باشد. گاهی اوقات آرگومان‌های پردازه در دسترس نخواهند بود؛ هنگامی که این اتفاق رخ دهد، به‌جای آن نام فایل اجرایی درون قلاب چاپ می‌شود.
T}
class	CLS	T{
.ad l
.hy 0
کلاس زمان‌بندی پردازه.
.br
مقدارهای ممکن این فیلد عبارتند از:
\-      گزارش‌نشده
.br
TS     SCHED_OTHER
.br
FF     SCHED_FIFO
.br
RR     SCHED_RR
.br
B      SCHED_BATCH
.br
ISO    SCHED_ISO
.br
IDL    SCHED_IDLE
.br
DLN    SCHED_DEADLINE
.br
?      مقدار ناشناخته
T}
s	S	T{
.ad l
.hy 0
نمایش کمینهٔ وضعیت.
اگر مایلید اطلاعات بیشتری نمایش داده شود، به \fBstate\fR نیز مراجعه کنید.
T}
euid	EUID	شناسهٔ کاربری مؤثر (effective user ID).
vsz	VSZ	T{
.ad l
.hy 0
اندازهٔ حافظهٔ مجازی پردازه بر حسب KiB (واحدهای ۱۰۲۴ بایتی).
نگاشت‌های دستگاه در حال حاضر مستثنی شده‌اند؛ این مورد ممکن است تغییر کند.
T}
euser	EUSER	T{
.ad l
.hy 0
نام کاربری مؤثر (effective user name). اگر قابل دریافت باشد و پهنای فیلد اجازه دهد، این مقدار شناسهٔ کاربری متنی خواهد بود، و در غیر این صورت یک نمایش ده‌دهی خواهد بود.
T}
All	N/A	T{
.ad l
.hy 0
این گزینه موارد USER،
PID،
PPID،
PRI،
%CPU،
%MEM،
VSZ،
RSS،
S،
START،
TIME،
WCHAN و COMMAND را نشان می‌دهد.
T}
.TE
.TP
.BR \-O\ \fI%mem,%cpu\fR ", " \fB\-\-sort=\fI%mem,%cpu\fR
مرتب‌سازی پردازه‌های خروجی بر اساس ستون مشخص‌شده.
این مرتب‌سازی اکنون می‌تواند در کنار گزینهٔ
.BR \-o
برای مرتب‌سازی بر اساس هر ستون خروجیِ مشخص‌شده توسط کاربر به کار رود (مانند \-o pid,%mem \-O %mem).
ستونی که به \-O/\-\-sort داده می‌شود باید در فهرست \-o وجود داشته باشد.
اگر ستون مرتب‌سازی در قالب خروجی وجود نداشته باشد، خطایی نشان داده خواهد شد.
(در صورت نامعتبر بودن یا عدم ذکر نام فیلد، مرتب‌سازی به‌طور پیش‌فرض بر اساس %cpu انجام می‌شود.)
.TP
.BR \-d\,
حالت اشکال‌زدایی
.br
فعال کردن حالت اشکال‌زدایی، که باعث می‌شود پیام‌های اشکال‌زدایی در
stdout
نوشته شوند.
.TP
.BR \-Z \ \fItimezone\fR ", "\fB\-\-timezone=\fItimezone\fR
به‌طور پیش‌فرض،
.B pcp-ps
زمان روز را مطابق با منطقهٔ زمانی محلیِ سیستمی که
.B pcp-ps
روی آن اجرا می‌شود، گزارش می‌کند.
گزینهٔ
.B \-Z
منطقهٔ زمانی را در قالب متغیر محیطی
.B TZ
به
.I timezone
تغییر می‌دهد، همان‌طور که در
.BR environ (7)
شرح داده شده است.
.TP
.BR \-z " , " \fB\-\-hostzone\fR
تغییر منطقهٔ زمانی گزارش‌دهی به منطقهٔ زمانی محلی در میزبانی که منبع معیارهای کارایی است.
هنگام بازپخش یک بایگانی PCP که در یک منطقهٔ زمانی دیگر ثبت شده است، گزینهٔ
.B \-z
تقریباً همیشه به کار می‌رود (منطقهٔ زمانی پیش‌فرض گزارش‌دهی، منطقهٔ زمانی محلی است که ممکن است با منطقهٔ زمانی بایگانی PCP یکسان نباشد).
.TP
.BR \-? " , " \fB\-\-help\fR
نمایش پیام راهنمای استفاده و خروج.
.SH "نکات (NOTES)"
.B pcp-ps
از دستور
.BR ps (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 pcp-ps (1)،
.BR python (1)،
.BR pmParseInterval (3)،
.BR strftime (3)
و
.BR environ (7).

.\" control lines for scripts/man-spell
.\" +ok+ SCHED_DEADLINE SCHED_BATCH SCHED_OTHER SCHED_FIFO SCHED_IDLE
.\" +ok+ SCHED_ISO SCHED_RR cputime
.\" +ok+ RTPRIO rtprio WCHAN PPIDs EUSER wchan Pname pname uname
.\" +ok+ vsize euser PPID EUID ppid args euid IDL DLN CLS CMD COL PRI RSS
.\" +ok+ VSZ cls cmd col pri vsz DD FF RR TT hh ss
.\" +ok+ realtime {not real-time, from (cputime/realtime ratio)}