.nh
.TH podman-top 1
.SH "نام (NAME)"
podman-top \- نمایش فرآیندهای در حال اجرای یک کانتینر

.SH "خلاصه دستور (SYNOPSIS)"
\fBpodman top\fP [\fIoptions\fP] \fIcontainer\fP [\fIformat-descriptors\fP]

.PP
\fBpodman container top\fP [\fIoptions\fP] \fIcontainer\fP [\fIformat-descriptors\fP]

.SH "توضیحات (DESCRIPTION)"
نمایش فرآیندهای در حال اجرای کانتینر. توصیف‌کننده‌های قالب‌بندی (\fIformat-descriptors\fP) از نوع توصیف‌کننده‌های سازگار با فرمت AIX در \fBps(1)\fP هستند که برای نمایش اطلاعات بیشتر، مانند حالت seccomp یا قابلیت‌های مؤثر (effective capabilities) یک فرآیند مشخص گسترش یافته‌اند. این توصیف‌کننده‌ها را می‌توان به صورت آرگومان‌های جداگانه یا به عنوان یک آرگومان تکی جداشده با کاما ارسال کرد. توجه داشته باشید که گزینه‌ها یا سوییچ‌های \fBps(1)\fP را نیز می‌توان مشخص کرد؛ در این حالت، Podman به اجرای \fBps(1)\fP از میزبان همراه با آرگومان‌ها و فلگ‌های مشخص‌شده در فضای نام (namespace) کانتینر رجوع می‌کند. اگر کانتینر قابلیت \fBCAP_SYS_PTRACE\fR را داشته باشد، ما دستور \fBps(1)\fP را درون کانتینر اجرا خواهیم کرد، بنابراین باید در آنجا نصب شده باشد.
برای استخراج اطلاعات مرتبط با میزبان، از توصیف‌کننده‌های "*h" استفاده کنید؛ به عنوان مثال \fBpodman top $name hpid huser\fR برای نمایش PID و کاربر فرآیندها در بافت میزبان.

.SH "گزینه‌ها (OPTIONS)"
.SS \fB--help\fP, \fB-h\fP
چاپ راهنمای نحوه استفاده از دستور.

.SS \fB--latest\fP, \fB-l\fP
به‌جای وارد کردن نام یا شناسهٔ کانتینر، از آخرین کانتینر ایجادشده استفاده می‌کند.
نکته: آخرین کانتینر راه‌اندازی‌شده می‌تواند مربوط به سایر کاربران Podman روی ماشین میزبان باشد.
(این گزینه در کلاینت راه دور Podman، از جمله ماشین‌های Mac و Windows (به‌استثنای WSL2) در دسترس نیست)

.SH "توصیف‌کننده‌های قالب‌بندی (FORMAT DESCRIPTORS)"
علاوه بر توصیف‌کننده‌های فرمت AIX ذکرشده در \fBps(1)\fP، توصیف‌کننده‌های زیر نیز پشتیبانی می‌شوند:

.PP
\fBargs, capbnd, capeff, capinh, capprm, comm, etime, group, groups, hgroup, hgroups, hpid, huser, label, nice, pcpu, pgid, pid, ppid, rgroup, ruser, seccomp, state, time, tty, user, vsz\fP

.PP
\fBcapbnd\fP

.PP
مجموعه قابلیت‌های مرزی (bounding capabilities). برای اطلاعات بیشتر به \fBcapabilities(7)\fP مراجعه کنید.

.PP
\fBcapeff\fP

.PP
مجموعه قابلیت‌های مؤثر (effective capabilities). برای اطلاعات بیشتر به \fBcapabilities(7)\fP مراجعه کنید.

.PP
\fBcapinh\fP

.PP
مجموعه قابلیت‌های ارث‌رسیدنی (inheritable capabilities). برای اطلاعات بیشتر به \fBcapabilities(7)\fP مراجعه کنید.

.PP
\fBcapprm\fP

.PP
مجموعه قابلیت‌های مجاز (permitted capabilities). برای اطلاعات بیشتر به \fBcapabilities(7)\fP مراجعه کنید.

.PP
\fBgroup\fP

.PP
گروه مؤثر (effective group) فرآیند.

.PP
\fBgroups\fP

.PP
گروه‌های تکمیلی (supplementary groups) فرآیند.

.PP
\fBhgroup\fP

.PP
گروه مؤثر متناظر یک فرآیند کانتینر روی میزبان.

.PP
\fBhgroups\fP

.PP
گروه‌های تکمیلی متناظر یک فرآیند کانتینر روی میزبان.

.PP
\fBhpid\fP

.PP
شناسه فرآیند (PID) متناظر فرآیند کانتینر روی میزبان.

.PP
\fBhuser\fP

.PP
کاربر مؤثر متناظر فرآیند کانتینر روی میزبان.

.PP
\fBlabel\fP

.PP
ویژگی‌های امنیتی جاری فرآیند.

.PP
\fBseccomp\fP

.PP
حالت seccomp فرآیند (مانند disabled، strict یا filter). برای اطلاعات بیشتر به \fBseccomp(2)\fP مراجعه فرمایید.

.PP
\fBstate\fP

.PP
کدهای وضعیت فرآیند (مانند \fBR\fP برای \fIrunning\fP، \fBS\fP برای \fIsleeping\fP). برای اطلاعات بیشتر به \fBproc(5)\fP مراجعه کنید.

.PP
\fBstime\fP

.PP
زمان شروع فرآیند (به عنوان مثال "2019-12-09 10:50:36 +0100 CET").

.SH "مثال‌ها (EXAMPLES)"
به‌طور پیش‌فرض، \fBpodman-top\fR داده‌هایی شبیه به \fBps -ef\fR چاپ می‌کند:

.EX
$ podman top f5a62a71b07
USER   PID   PPID   %CPU    ELAPSED         TTY     TIME   COMMAND
root   1     0      0.000   20.386825206s   pts/0   0s     sh
root   7     1      0.000   16.386882887s   pts/0   0s     sleep
root   8     1      0.000   11.386886562s   pts/0   0s     vi
.EE

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

.EX
$ podman top -l pid seccomp args %C
PID   SECCOMP   COMMAND     %CPU
1     filter    sh          0.000
8     filter    vi /etc/    0.000
.EE

.PP
اگر توصیف‌کنندهٔ ناشناخته‌ای مشخص شود، Podman به اجرای دستور ps(1) از میزبان درون فضای نام کانتینر رجوع می‌کند:

.EX
$ podman top -l -- aux
USER   PID   PPID   %CPU    ELAPSED             TTY   TIME   COMMAND
root   1     0      0.000   1h2m12.497061672s   ?     0s     sleep 100000
.EE

.SH "همچنین ببینید (SEE ALSO)"
\fBpodman(1)\fP, \fBps(1)\fP, \fBseccomp(2)\fP, \fBproc(5)\fP, \fBcapabilities(7)\fP

.SH "تاریخچه (HISTORY)"
ژوئیه ۲۰۱۸، معرفی توصیف‌کننده‌های قالب‌بندی توسط Valentin Rothberg vrothberg@suse.com
\[la]mailto:vrothberg@suse.com\[ra]

.PP
دسامبر ۲۰۱۷، در ابتدا توسط Brent Baude bbaude@redhat.com
\[la]mailto:bbaude@redhat.com\[ra] گردآوری شد.