'"macro stdmacro
."
." Copyright (c) 2000-2018 Gerlof Langeveld.
." Copyright (c) 2017-2020 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-ATOPRC 5 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
3pcp-atoprc1 \- فایل پیکربندی و منابع برای pcp-atop و pcp-atopsar
.SH "توضیحات (DESCRIPTION)"
این صفحه راهنما فایل منابع دستورهای
.I pcp-atop
و
.I pcp-atopsar
را مستند می‌کند.
این دستورها را می‌توان برای نظارت بر بار سیستم و پردازش‌ها در یک سیستم به کار برد.
.PP
فایل pcp-atoprc حاوی تنظیمات پیش‌فرض است. این تنظیمات هنگام راه‌اندازی، ابتدا از فایل rc سراسری سیستم
.I /etc/atoprc
و پس از آن از فایل rc مخصوص کاربر
.I ~/.atoprc
خوانده می‌شوند (بنابراین تنظیمات سراسری سیستم را می‌توان توسط یک کاربر به صورت جداگانه بازنویسی کرد).
گزینه‌ها در هر دو فایل rc یکسان هستند.
.SH "گزینه‌ها (OPTIONS)"
فایل rc حاوی جفت‌های کلیدواژه-مقدار است، هر کدام در یک خط (خطوط خالی و خطوطی که با علامت # آغاز می‌شوند نادیده گرفته می‌شوند).
.br
کلیدواژه‌های زیر را می‌توان مشخص کرد:
.TP 4
.B flags
فهرستی از گزینه‌ها و فلگ‌های پیش‌فرض برای
.B pcp-atop
را می‌توان در اینجا تعریف کرد. فلگ‌های مجاز عبارتند از:
'B'، 'H'، 'g'، 'm'، 'd'، 'n'، 'u'، 'p'، 's'، 'c'، 'v'،
'C'، 'M'، 'D'، 'N'، 'A'،
'a'، 'y'، 'f'، 'F'، 'G'، 'R'، '1'، 'e'، 'E' و 'x'.
.TP 4
.B interval
مقدار بازه زمانی پیش‌فرض بر حسب ثانیه.
.TP 4
.B linelen
طول خط نمایشگر هنگام ارسال خروجی به فایل یا لوله (پیش‌فرض 80).
.TP 4
.B username
عبارت منظم پیش‌فرض برای کاربرانی که پردازش‌های فعال آن‌ها نمایش داده خواهد شد.
.TP 4
.B procname
عبارت منظم پیش‌فرض برای نام پردازش‌هایی که باید نمایش داده شوند.
.TP 4
.B maxlinecpu
حداکثر تعداد پردازنده‌های فعالی که نمایش داده خواهند شد.
.TP 4
.B maxlinegpu
حداکثر تعداد GPUهای فعالی که نمایش داده خواهند شد.
.TP 4
.B maxlinelvm
حداکثر تعداد حجم‌های منطقی (LVM) فعالی که نمایش داده خواهند شد.
.TP 4
.B maxlinemdd
حداکثر تعداد دستگاه‌های چندگانه (MDD) فعالی که نمایش داده خواهند شد.
.TP 4
.B maxlinedisk
حداکثر تعداد دیسک‌های فعالی که نمایش داده خواهند شد.
.TP 4
.B maxlinenfsm
حداکثر تعداد مانت‌های NFS که روی یک کلاینت NFS نمایش داده خواهند شد.
.TP 4
.B maxlineintf
حداکثر تعداد رابط‌های شبکه فعالی که نمایش داده خواهند شد.
.TP 4
.B maxlinecont
حداکثر تعداد کانتینرهای فعالی که نمایش داده خواهند شد.
.TP 4
.B cpucritperc
درصد مشغول بودن بحرانی برای یک پردازنده
(بخش COLORS را در صفحه راهنمای دستور
.I pcp-atop
ببینید).
از این درصد برای تعیین درصد وزنی جهت رنگ‌آمیزی خطوط و مرتب‌سازی پردازش‌های فعال
در حالت متنی استفاده می‌شود.
اگر این مقدار صفر باشد، هیچ رنگ‌آمیزی یا مرتب‌سازی خودکاری برای این منبع انجام نمی‌شود.
.TP 4
.B dskcritperc
درصد مشغول بودن بحرانی برای یک دیسک
(بخش COLORS را در صفحه راهنمای دستور
.I pcp-atop
ببینید).
از این درصد برای تعیین درصد وزنی جهت رنگ‌آمیزی خطوط و مرتب‌سازی پردازش‌های فعال
در حالت متنی استفاده می‌شود.
اگر این مقدار صفر باشد، هیچ رنگ‌آمیزی یا مرتب‌سازی خودکاری برای این منبع انجام نمی‌شود.
.TP 4
.B netcritperc
درصد مشغول بودن بحرانی برای یک رابط شبکه
(بخش COLORS را در صفحه راهنمای دستور
.I pcp-atop
ببینید).
از این درصد برای تعیین درصد وزنی جهت رنگ‌آمیزی خطوط و مرتب‌سازی پردازش‌های فعال
در حالت متنی استفاده می‌شود.
اگر این مقدار صفر باشد، هیچ رنگ‌آمیزی یا مرتب‌سازی خودکاری برای این منبع انجام نمی‌شود.
.TP 4
.B memcritperc
درصد بحرانی استفاده از حافظه
(بخش COLORS را در صفحه راهنمای دستور
.I pcp-atop
ببینید).
از این درصد برای تعیین درصد وزنی جهت رنگ‌آمیزی خطوط و مرتب‌سازی پردازش‌های فعال
در حالت متنی استفاده می‌شود.
اگر این مقدار صفر باشد، هیچ رنگ‌آمیزی یا مرتب‌سازی خودکاری برای این منبع انجام نمی‌شود.
.TP 4
.B swpcritperc
درصد اشغال بحرانی برای فضای سواپ
(بخش COLORS را در صفحه راهنمای دستور
.I pcp-atop
ببینید).
از این درصد برای تعیین درصد وزنی جهت رنگ‌آمیزی خطوط و مرتب‌سازی پردازش‌های فعال استفاده می‌شود.
اگر این مقدار صفر باشد، هیچ رنگ‌آمیزی یا مرتب‌سازی خودکاری برای این منبع انجام نمی‌شود.
.TP 4
.B swoutcritsec
تعداد صفحات منتقل‌شده به سواپ در هر ثانیه که برای مصرف حافظه بحرانی تلقی می‌شود
(بخش COLORS را در صفحه راهنمای دستور
.I pcp-atop
ببینید).
این آستانه در ترکیب با 'memcritperc' برای تعیین درصد وزنی جهت رنگ‌آمیزی خطوط و مرتب‌سازی پردازش‌های فعال استفاده می‌شود.
اگر این مقدار صفر باشد، هیچ رنگ‌آمیزی یا مرتب‌سازی خودکاری برای این منبع انجام نمی‌شود.
.TP 4
.B almostcrit
درصدی از درصد بحرانی برای تعیین اینکه آیا منبع در آستانه وضعیت بحرانی است یا خیر
(بخش COLORS را در صفحه راهنمای دستور
.I pcp-atop
ببینید).
اگر این مقدار صفر باشد، هیچ رنگ‌آمیزی خطی برای وضعیت «در آستانه بحرانی» انجام نمی‌شود.
.TP 4
.B cpubarwidth
تعداد ستون‌های مورد استفاده برای هر میله در نمودار میله‌ای پردازنده.
مقدار پیش‌فرض 0 است که به این معناست که پهنای میله به صورت خودکار تغییر اندازه می‌دهد
(هر چه ترمینال عریض‌تر باشد، ستون‌های بیشتری برای هر میله تا سقف ۳ ستون اختصاص می‌یابد).
با مقادیر 1، 2 یا 3 می‌توان تعداد ستون‌ها را ثابت نگه داشت، با یک ستون فاصله خالی میان میله‌ها.
.TP 4
.B colorinfo
تعریف نام رنگ برای پیام‌های اطلاعاتی (پیش‌فرض: green) در حالت متنی.
.br
رنگ‌های مجاز عبارتند از: red green yellow blue magenta cyan black white.
.TP 4
.B colorthread
تعریف نام رنگ برای خطوط مربوط به رشته‌ها هنگام استفاده از گزینه 'y' (پیش‌فرض: yellow).
.br
رنگ‌های مجاز عبارتند از: red green yellow blue magenta cyan black white.
.TP 4
.B coloralmost
تعریف نام رنگ برای منابع در آستانه بحرانی (پیش‌فرض: cyan) در حالت متنی.
.br
رنگ‌های مجاز عبارتند از: red green yellow blue magenta cyan black white.
.TP 4
.B colorcritical
تعریف نام رنگ برای منابع بحرانی (پیش‌فرض: red) در حالت متنی.
.br
رنگ‌های مجاز عبارتند از: red green yellow blue magenta cyan black white.
.TP 4
.B pcp-atopsarflags
فهرستی از فلگ‌های پیش‌فرض برای
.B pcp-atopsar
را می‌توان در اینجا تعریف کرد. فلگ‌های مجاز عبارتند از:
'S'، 'x'، 'C'، 'M'، 'H'، 'a'، 'A' و فلگ‌های مربوط به انتخاب یک یا چند گزارش خاص.
.PP
نمونه‌ای از فایل
.B /etc/atoprc
یا
.B ~/.atoprc
:
.TP 8
\ 
.br
flags\ \ \ \ \ \ \ \ \ Aaf
.br
interval\ \ \ \ \ \ 5
.br
username
.br
procname
.br
maxlinecpu\ \ \ \ 4
.br
maxlinedisk\ \ \ 10
.br
maxlineintf\ \ \ 5
.br
cpucritperc\ \ \ 80
.br
almostcrit\ \ \ \ 90
.br
pcp-atopsarflags\ \ CMH
.br
ownprocline\ \ \ PID:50 VGROW:40 RGROW:45 COMMAND-LINE:50
.br
ownpagline\ \ \ \ PAGSCAN:3 BLANKBOX:0 PAGSWIN:3 PAGSWOUT:7
.PP
کلیدواژه‌های 'ownprocline' و 'ownpagline' در بخش بعدی شرح داده شده‌اند.
.SH "تعریف اختصاصی خط خروجی (OWN DEFINITION OF OUTPUT LINE)"
از طریق فایل rc امکان تعریف قالب خطوط خروجی توسط خودتان وجود دارد، بدین معنی که
می‌توانید قالب یک خط شامل اطلاعات پردازش را با کلیدواژه 'ownprocline' تعریف کنید
(که با کلید 'o' یا فلگ \-o انتخاب می‌شود) و می‌توانید تمامی خطوط اطلاعات سیستم را بازتعریف نمایید.
.PP
قالب یک خط خروجی را می‌توان به شرح زیر تعریف کرد
(توجه داشته باشید که این مورد باید در قالب یک خط در فایل rc مشخص شود):
.PP
\ \ \ keyword\ \ \ <columnid>:<prio> [<columnid>:<prio> ...]
.PP
شناسه
.B columnid
نام نمادین ستونی است که باید در این موقعیت در خط خروجی نمایش داده شود.
.br
شناسه
.B prio
یک مقدار عدد صحیح مثبت است که اولویت ستون‌ها را در صورتی که تمام ستون‌های مشخص‌شده
در پهنای صفحه جاری جا نشوند، تعیین می‌کند. هرچه مقدار بالاتر باشد، اولویت بیشتر است.
.br
مشخصات ستون‌ها باید با یک فاصله از هم جدا شوند. ترتیبی که ستون‌ها در آن مشخص شده‌اند،
ترتیب نمایش آن‌ها با در نظر گرفتن اولویتشان خواهد بود (ستون‌هایی که جا نشوند، به صورت پویا حذف خواهند شد).
.PP
یک columnid ویژه برای خطوط سیستمی 'BLANKBOX' است. این شناسه نشان می‌دهد که در این موقعیت
یک ستون خالی مورد نیاز است. همچنین این شناسه خاص با یک مقدار اولویت (معمولاً پایین) همراه است.
.PP
تعریف زیر را می‌توان برای اطلاعات پردازش مشخص کرد:
.TP 4
.B ownprocline
شناسه‌های ستون‌ها همان نام‌های ستون‌هایی هستند که در خروجی عادی خطوط مربوط به پردازش توسط
.I pcp-atop
نمایش داده می‌شوند، مانند 'PID'، 'CMD'، 'S' و غیره.
تنها استثنا شناسه ستون ویژه 'SORTITEM' است که برای نمایش یکی از ستون‌های
%CPU%/DSK%/MEM%/NET بسته به معیار مرتب‌سازی انتخاب‌شده استفاده می‌شود.
.br
نمونه‌ای از یک خط پردازش تعریف‌شده توسط کاربر:
.TP 8
\ 
ownprocline\ \ \ PID:20 PPID:10 SYSCPU:15 USRCPU:15
VGROW:14 VSIZE:12 RGROW:14 RSIZE:12 ST:8 EXC:7 S:11 SORTITEM:18 CMD:20
.PP
تعاریف زیر به صورت داخلی توسط
.I pcp-atop
به عنوان خطوط سیستمی پیش‌فرض استفاده می‌شوند (می‌توانید هر یک از آن‌ها را در فایل rc به صورت یک خط بازتعریف کنید):
.TP 4
.B ownsysprcline
بازتعریف خط برچسب‌گذاری‌شده با 'PRC':
.TP 8
\ 
ownsysprcline\ \ \ PRCSYS:8 PRCUSER:8 BLANKBOX:0 PRCNPROC:7 PRCNZOMBIE:5 PRCCLONES:4 BLANKBOX:0 PRCNNEXIT:6
.TP 4
.B ownallcpuline
بازتعریف خط برچسب‌گذاری‌شده با 'CPU' برای استفاده کل پردازنده:
.TP 8
\ 
ownallcpuline\ \ \ CPUSYS:8 CPUUSER:7 CPUIRQ:4 BLANKBOX:0 CPUIDLE:5 CPUWAIT:6 BLANKBOX:0 CPUSTEAL:1 CPUGUEST:3
.TP 4
.B ownonecpuline
بازتعریف خط برچسب‌گذاری‌شده با 'CPU' برای استفاده از یک پردازنده مشخص:
.TP 8
\ 
ownonecpuline\ \ \ CPUISYS:8 CPUIUSER:7 CPUIIRQ:4 BLANKBOX:0 CPUIIDLE:5 CPUIWAIT:6 BLANKBOX:0 CPUISTEAL:1 CPUIGUEST:3
.TP 4
.B owncplline
بازتعریف خط برچسب‌گذاری‌شده با 'CPL':
.TP 8
\ 
owncplline\ \ \ CPLAVG1:4 CPLAVG5:3 CPLAVG15:2 BLANKBOX:0 CPLCSW:6 CPLINTR:5 BLANKBOX:0 CPLNUMCPU:1
.TP 4
.B ownmemline
بازتعریف خط برچسب‌گذاری‌شده با 'MEM':
.TP 8
\ 
ownmemline\ \ \ MEMTOT:2 MEMFREE:5 MEMCACHE:3 MEMDIRTY:1 MEMBUFFER:3 MEMSLAB:3 BLANKBOX:0 BLANKBOX:0 BLANKBOX:0 BLANKBOX:0
.TP 4
.B ownswpline
بازتعریف خط برچسب‌گذاری‌شده با 'SWP':
.TP 8
\ 
ownswpline\ \ \ SWPTOT:3 SWPFREE:4 BLANKBOX:0 BLANKBOX:0 BLANKBOX:0 BLANKBOX:0 BLANKBOX:0 BLANKBOX:0 SWPCOMMITTED:5 SWPCOMMITLIM:6
.TP 4
.B ownpagline
بازتعریف خط برچسب‌گذاری‌شده با 'PAG':
.TP 8
\ 
ownpagline\ \ \ PAGSCAN:3 PAGSTALL:1 BLANKBOX:0 PAGSWIN:4 PAGSWOUT:3
.TP 4
.B owndskline
بازتعریف خطوط برچسب‌گذاری‌شده با 'LVM'، 'MDD' و 'DSK':
.TP 8
\ 
owndskline\ \ \ DSKNAME:8 DSKBUSY:7 DSKNREAD:6 DSKNWRITE:6 DSKKBPERRD:4 DSKKBPERWR:4 DSKMBPERSECRD:5 DSKMBPERSECWR:5 DSKAVQUEUE:1 DSKAVIO:5
.TP 4
.B ownnettrline
بازتعریف خط برچسب‌گذاری‌شده با 'NET' برای بخش انتقال (transport):
.TP 8
\ 
ownnettrline\ \ \ NETTRANSPORT:9 NETTCPI:8 NETTCPO:8 NETUDPI:8 NETUDPO:8 NETTCPACTOPEN:6 NETTCPPASVOPEN:5 NETTCPRETRANS:4 NETTCPINERR:3 NETTCPORESET:20 NETUDPNOPORT:1 NETUDPINERR:3
.TP 4
.B ownnetnetline
بازتعریف خط برچسب‌گذاری‌شده با 'NET' برای شبکه (network):
.TP 8
\ 
ownnetnetline\ \ \ NETNETWORK:5 NETIPI:4 NETIPO:4 NETIPFRW:4 NETIPDELIV:4 BLANKBOX:0 BLANKBOX:0 BLANKBOX:0 NETICMPIN:1 NETICMPOUT:1
.TP 4
.B ownnetifline
بازتعریف خط برچسب‌گذاری‌شده با 'NET' برای رابط‌ها (interfaces):
.TP 8
\ 
ownnetifline\ \ \ NETNAME:8 NETPCKI:7 NETPCKO:7 NETSPEEDIN:6 NETSPEEDOUT:6 NETCOLLIS:3 NETMULTICASTIN:2 NETRCVERR:5 NETSNDERR:5 NETRCVDROP:4 NETSNDDROP:4
.PP
خطوط بالا به ترتیبی نمایش داده شده‌اند که توسط
.I pcp-atop
در ترکیب با فلگ
.B -f
نمایش داده می‌شوند (در یک پنجره بسیار عریض باید بتوانید تمامی ستون‌ها را مشاهده کنید).
.SH "همچنین ببینید (SEE ALSO)"
.BR pcp (1),
.BR pcp-atop (1),
.BR pcp-atopsar (1)
و
.BR PCPIntro (1).

." control lines for scripts/man-spell
." +ok+ NETMULTICASTIN NETTCPPASVOPEN NETTCPACTOPEN NETTCPRETRANS
." +ok+ colorcritical DSKMBPERSECRD DSKMBPERSECWR ownallcpuline ownnetnetline
." +ok+ ownonecpuline ownsysprcline NETTCPORESET NETTRANSPORT NETUDPNOPORT
." +ok+ atopsarflags ownnetifline ownnettrline swoutcritsec SWPCOMMITLIM
." +ok+ SWPCOMMITTED maxlinecont maxlinedisk maxlineintf maxlinenfsm
." +ok+ memcritperc netcritperc NETSPEEDOUT NETTCPINERR NETUDPINERR
." +ok+ coloralmost colorthread cpubarwidth cpucritperc dskcritperc
." +ok+ ownprocline swpcritperc maxlinecpu maxlinegpu maxlinelvm maxlinemdd
." +ok+ NETICMPOUT NETIPDELIV NETNETWORK NETRCVDROP NETSNDDROP NETSPEEDIN
." +ok+ almostcrit PRCNZOMBIE DSKAVQUEUE DSKKBPERRD DSKKBPERWR owncplline
." +ok+ owndskline ownmemline ownpagline ownswpline MEMBUFFER NETCOLLIS
." +ok+ NETICMPIN NETRCVERR NETSNDERR colorinfo columnids CPLNUMCPU CPUIGUEST
." +ok+ CPUISTEAL PRCCLONES PRCNNEXIT DSKNWRITE PAGSTALL PAGSWOUT
." +ok+ MEMCACHE MEMDIRTY NETIPFRW BLANKBOX columnid SORTITEM CPUGUEST
." +ok+ CPUIIDLE CPUIUSER CPUIWAIT CPUSTEAL PRCNPROC procname DSKNREAD
." +ok+ PAGSCAN PAGSWIN rcfiles MEMFREE MEMSLAB NETNAME NETPCKI NETPCKO
." +ok+ NETTCPI NETTCPO NETUDPI NETUDPO linelen CPLINTR CPUIDLE CPUIIRQ
." +ok+ CPUISYS CPUUSER CPUWAIT PRCUSER DSKAVIO DSKBUSY DSKNAME atopsar
." +ok+ SWPFREE rcfile MEMTOT NETIPI NETIPO CPLAVG CPLCSW CPUIRQ CPUSYS
." +ok+ PRCSYS USRCPU atoprc SWPTOT SYSCPU RGROW VGROW RSIZE VSIZE PPID
." +ok+ prio cyan Aaf PAG MDD MEM CMD CMH CPL PRC DSK LVM SWP EXC