'\" t
.TH "SYSTEMD\-CGTOP" "1" "" "systemd 261.2" "systemd-cgtop"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
systemd-cgtop \- نمایش زنده و لحظه‌ای مصرف منابع توسط گروه‌های کنترلی (cgroups)
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBsystemd\-cgtop\fR\ 'u
\fBsystemd\-cgtop\fR [OPTIONS...] [GROUP]
.SH "توضیحات (DESCRIPTION)"
.PP
دستور
\fBsystemd\-cgtop\fR
برترین گروه‌های کنترلی سلسله‌مراتب محلی گروه‌های کنترلی لینوکس (cgroups) را بر اساس بار پردازنده (CPU)، حافظه، یا ورودی/خروجی دیسک (Disk I/O) مرتب کرده و نمایش می‌دهد\&. صفحه نمایش در بازه‌های زمانی منظم (به‌طور پیش‌فرض هر ۱ ثانیه یک‌بار) به‌سبکی شبیه به دستور
\fBtop\fR(1)
تازه‌سازی می‌شود\&. در صورت مشخص شدن مسیر یک گروه کنترلی، تنها سرویس‌های همان گروه کنترلی مشخص‌شده نمایش داده می‌شوند\&.
.PP
اگر
\fBsystemd\-cgtop\fR
به یک tty متصل نباشد، هیچ عنوان ستونی چاپ نمی‌شود و پیش‌فرض برنامه این است که تنها یک دور (iteration) اجرا شود\&. در صورت تعیین آرگومان
\fB\-\-iterations=\fR
مقدار آن رعایت خواهد شد\&. این حالت برای استفاده در اسکریپت‌ها مناسب است\&.
.PP
محاسبه مصرف منابع تنها برای گروه‌های کنترلی دارای کنترل‌کننده‌های فعال مربوطه انجام می‌شود: کنترل‌کننده
"memory"
برای مصرف حافظه و کنترل‌کننده
"io"
برای مصرف ورودی/خروجی دیسک\&. در صورتی که پایش این منابع مورد نیاز باشد، توصیه می‌شود تنظیمات
\fIMemoryAccounting=1\fR
و
\fIIOAccounting=1\fR
در فایل‌های واحد مربوطه اضافه شوند\&. برای جزئیات بیشتر به
\fBsystemd.resource-control\fR(5)
مراجعه کنید\&.
.PP
مقدار بار پردازنده (CPU) می‌تواند بین ۰ تا ۱۰۰ برابر تعداد پردازنده‌های سیستم باشد\&. برای مثال، اگر سیستم دارای ۸ پردازنده باشد، مقدار بار پردازنده بین ۰٪ تا ۸۰۰٪ خواهد بود\&. تعداد پردازنده‌ها را می‌توان در فایل
"/proc/cpuinfo"
یافت\&.
.PP
جهت تاکید: مگر این‌که
"MemoryAccounting=1"
و
"IOAccounting=1"
برای سرویس‌های مورد نظر فعال شده باشند، هیچ داده‌ای برای محاسبه منابع سرویس‌های سیستمی در دسترس نخواهد بود و اطلاعات نمایش داده شده توسط
\fBsystemd\-cgtop\fR
ناقص خواهد بود\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
گزینه‌های زیر پشتیبانی می‌شوند:
.PP
\fB\-p\fR, \fB\-\-order=path\fR
.RS 4
مرتب‌سازی بر اساس نام مسیر گروه کنترلی\&.
.RE
.PP
\fB\-t\fR, \fB\-\-order=tasks\fR
.RS 4
مرتب‌سازی بر اساس تعداد وظایف/فرآیندها (tasks/processes) در گروه کنترلی\&.
.RE
.PP
\fB\-c\fR, \fB\-\-order=cpu\fR
.RS 4
مرتب‌سازی بر اساس بار پردازنده (CPU)\&.
.RE
.PP
\fB\-m\fR, \fB\-\-order=memory\fR
.RS 4
مرتب‌سازی بر اساس میزان مصرف حافظه\&.
.RE
.PP
\fB\-i\fR, \fB\-\-order=io\fR
.RS 4
مرتب‌سازی بر اساس بار ورودی/خروجی (I/O) دیسک\&.
.RE
.PP
\fB\-b\fR, \fB\-\-batch\fR
.RS 4
اجرا در حالت دسته‌ای (batch): ورودی از کاربر نمی‌پذیرد و تا زمانی که محدودیت دفعات تکرار تنظیم‌شده با
\fB\-\-iterations=\fR
به پایان برسد یا فرآیند متوقف شود اجرا می‌شود\&. این حالت برای ارسال خروجی از
\fBsystemd\-cgtop\fR
به برنامه‌های دیگر یا به یک فایل مفید است\&.
.sp
اضافه‌شده در نسخه 188\&.
.RE
.PP
\fB\-r\fR, \fB\-\-raw\fR
.RS 4
قالب‌بندی شمارش بایت‌ها (مانند مصرف حافظه و معیارهای ورودی/خروجی) و زمان پردازنده با مقادیر عددی خام به‌جای مقادیر خوانا برای انسان (human-readable)\&.
.sp
اضافه‌شده در نسخه 221\&.
.RE
.PP
\fB\-\-cpu=percentage\fR, \fB\-\-cpu=time\fR
.RS 4
کنترل می‌کند که آیا مصرف پردازنده به‌صورت درصد نمایش داده شود یا زمان\&. به‌طور پیش‌فرض، مصرف پردازنده به‌صورت درصد نشان داده می‌شود\&. این تنظیم می‌تواند در زمان اجرا با فشردن کلید
%
نیز تغییر یابد\&.
.sp
اضافه‌شده در نسخه 226\&.
.RE
.PP
\fB\-P\fR
.RS 4
تنها فرآیندهای فضای کاربری را به‌جای همه وظایف شمارش می‌کند\&. به‌طور پیش‌فرض، تمام وظایف شمرده می‌شوند: هر ریسه هسته (kernel thread) و هر ریسه فضای کاربری به‌صورت مجزا\&. با این تنظیم، ریسه‌های هسته از شمارش حذف می‌شوند و هر فرآیند فضای کاربری فارغ از تعداد ریسه‌هایی که دارد، تنها به‌عنوان یک وظیفه شمرده می‌شود\&. این تنظیم می‌تواند در زمان اجرا با فشردن کلید
P
نیز تغییر یابد\&. این گزینه را نمی‌توان با
\fB\-k\fR
ترکیب کرد\&.
.sp
اضافه‌شده در نسخه 227\&.
.RE
.PP
\fB\-k\fR
.RS 4
تنها فرآیندهای فضای کاربری و ریسه‌های هسته را به‌جای همه وظایف شمارش می‌کند\&. به‌طور پیش‌فرض، تمام وظایف شمرده می‌شوند: هر ریسه هسته و هر ریسه فضای کاربری به‌صورت مجزا\&. با این تنظیم، ریسه‌های هسته در شمارش گنجانده می‌شوند و هر فرآیند فضای کاربری فارغ از تعداد ریسه‌هایش، تنها به‌عنوان یک وظیفه شمرده می‌شود\&. این تنظیم می‌تواند در زمان اجرا با فشردن کلید
k
نیز تغییر یابد\&. این گزینه را نمی‌توان با
\fB\-P\fR
ترکیب کرد\&.
.sp
اضافه‌شده در نسخه 226\&.
.RE
.PP
\fB\-\-recursive=\fR
.RS 4
مشخص می‌کند که آیا تعداد فرآیندهای نمایش‌داده‌شده برای یک گروه کنترلی باید شامل تمام فرآیندهای موجود در گروه‌های کنترلی فرزند آن نیز باشد یا خیر\&. یک آرگومان بولی می‌پذیرد که مقدار پیش‌فرض آن
"yes"
است\&. در صورت فعال بودن، فرآیندهای گروه‌های کنترلی فرزند نیز لحاظ می‌شوند و در صورت غیرفعال بودن، تنها فرآیندهای موجود در خود گروه کنترلی شمرده می‌شوند\&. این تنظیم می‌تواند در زمان اجرا با فشردن کلید
r
نیز تغییر یابد\&. توجه داشته باشید که این تنظیم تنها برای شمارش فرآیندها اعمال می‌شود، یعنی زمانی که گزینه‌های
\fB\-P\fR
یا
\fB\-k\fR
استفاده شوند\&. در صورتی که همه وظایف شمرده شوند، تاثیری ندارد؛ زیرا در آن حالت شمارش همیشه به‌صورت بازگشتی (recursive) است\&.
.sp
اضافه‌شده در نسخه 226\&.
.RE
.PP
\fB\-n\fR, \fB\-\-iterations=\fR
.RS 4
تنها به همین تعداد دور (iterations) تکرار انجام می‌دهد\&. مقدار 0 مشخص می‌کند که برنامه باید به‌طور نامحدود اجرا شود\&.
.sp
اضافه‌شده در نسخه 188\&.
.RE
.PP
\fB\-1\fR
.RS 4
میان‌بری برای
\fB\-\-iterations=1\fR\&.
.sp
اضافه‌شده در نسخه 238\&.
.RE
.PP
\fB\-d\fR, \fB\-\-delay=\fR
.RS 4
تعیین تاخیر تازه‌سازی بر حسب ثانیه (یا در صورتی که یکی از واحدهای
"ms"،
"us"،
"min"
به‌عنوان واحد مشخص شود، بر حسب آن واحد زمانی)\&. این تنظیم را می‌توان در زمان اجرا با فشردن کلیدهای
+
و
\-
نیز افزایش یا کاهش داد\&.
.RE
.PP
\fB\-\-depth=\fR
.RS 4
حداکثر عمق پیمایش درخت گروه کنترلی\&. مشخص می‌کند که
\fBsystemd\-cgtop\fR
تا چه عمقی از سلسله‌مراتب گروه‌های کنترلی را پیمایش کند\&. اگر 0 تعیین شود، تنها گروه ریشه پایش می‌شود\&. برای 1، تنها سطح اول گروه‌های کنترلی پایش می‌شوند و به همین ترتیب\&. پیش‌فرض 3 است\&.
.RE
.PP
\fB\-M \fR\fB\fIMACHINE\fR\fR, \fB\-\-machine=\fR\fB\fIMACHINE\fR\fR
.RS 4
محدود کردن گروه‌های کنترلی نمایش‌داده‌شده به بخشی که متناظر با کانتینر
\fIMACHINE\fR
است\&. این گزینه را نمی‌توان زمانی که مسیر گروه کنترلی مشخص شده است استفاده کرد\&.
.sp
اضافه‌شده در نسخه 227\&.
.RE
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
نمایش یک متن راهنمای کوتاه و خروج\&.
.RE
.PP
\fB\-\-version\fR
.RS 4
نمایش رشته نسخه کوتاه و خروج\&.
.RE
.SH "کلیدهای تعاملی (KEYS)"
.PP
دستور
\fBsystemd\-cgtop\fR
یک ابزار تعاملی است و می‌توان آن را از طریق ورودی‌های کاربر با استفاده از کلیدهای زیر کنترل کرد:
.PP
h
.RS 4
نمایش یک متن راهنمای کوتاه\&.
.RE
.PP
Space
.RS 4
تازه‌سازی فوری خروجی\&.
.sp
اضافه‌شده در نسخه 226\&.
.RE
.PP
q
.RS 4
پایان دادن به اجرای برنامه\&.
.RE
.PP
p, t, c, m, i
.RS 4
مرتب‌سازی گروه‌های کنترلی به‌ترتیب بر اساس مسیر، تعداد وظایف، بار پردازنده، مصرف حافظه یا بار ورودی/خروجی دیسک\&. این تنظیم را می‌توان با سوییچ خط فرمان
\fB\-\-order=\fR
نیز کنترل کرد\&.
.RE
.PP
%
.RS 4
تغییر وضعیت بین نمایش مصرف پردازنده به‌صورت زمان یا درصد\&. این تنظیم را می‌توان با سوییچ خط فرمان
\fB\-\-cpu=\fR
نیز کنترل کرد\&.
.sp
اضافه‌شده در نسخه 201\&.
.RE
.PP
+, \-
.RS 4
به‌ترتیب افزایش یا کاهش تاخیر تازه‌سازی\&. این تنظیم را می‌توان با سوییچ خط فرمان
\fB\-\-delay=\fR
نیز کنترل کرد\&.
.RE
.PP
P
.RS 4
تغییر وضعیت بین شمارش تمام وظایف یا فقط فرآیندهای فضای کاربری\&. این تنظیم را می‌توان با سوییچ خط فرمان
\fB\-P\fR
(به بالا مراجعه کنید) نیز کنترل کرد\&.
.sp
اضافه‌شده در نسخه 227\&.
.RE
.PP
k
.RS 4
تغییر وضعیت بین شمارش تمام وظایف یا فقط فرآیندهای فضای کاربری و ریسه‌های هسته\&. این تنظیم را می‌توان با سوییچ خط فرمان
\fB\-k\fR
(به بالا مراجعه کنید) نیز کنترل کرد\&.
.sp
اضافه‌شده در نسخه 226\&.
.RE
.PP
r
.RS 4
تغییر وضعیت بین گنجاندن یا حذف بازگشتی فرآیندهای موجود در گروه‌های کنترلی فرزند در شمارش فرآیندهای گروه کنترلی\&. این تنظیم را می‌توان با سوییچ خط فرمان
\fB\-\-recursive=\fR
نیز کنترل کرد\&. این کلید در صورتی که تمام وظایف شمرده شوند در دسترس نیست؛ تنها در صورتی فعال است که فرآیندها شمارش شوند، یعنی حالتی که با کلیدهای
P
یا
k
فعال شده باشد\&.
.sp
اضافه‌شده در نسخه 226\&.
.RE
.SH "کدهای خروج (EXIT STATUS)"
.PP
در صورت موفقیت 0 و در غیر این صورت یک کد شکست غیرصفر بازگردانده می‌شود\&.
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBsystemd\fR(1), \fBsystemctl\fR(1), \fBsystemd-cgls\fR(1), \fBsystemd.resource-control\fR(5), \fBtop\fR(1)