podman-top(1) General Commands Manual podman-top(1)

podman-top - نمایش فرآیندهای در حال اجرای یک کانتینر

podman top [options] container [format-descriptors]

podman container top [options] container [format-descriptors]

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

چاپ راهنمای نحوه استفاده از دستور.

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

علاوه بر توصیف‌کننده‌های فرمت AIX ذکرشده در ps(1)، توصیف‌کننده‌های زیر نیز پشتیبانی می‌شوند:

args, 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

capbnd

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

capeff

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

capinh

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

capprm

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

group

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

groups

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

hgroup

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

hgroups

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

hpid

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

huser

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

label

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

seccomp

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

state

کدهای وضعیت فرآیند (مانند R برای running، S برای sleeping). برای اطلاعات بیشتر به proc(5) مراجعه کنید.

stime

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

به‌طور پیش‌فرض، podman-top داده‌هایی شبیه به ps -ef چاپ می‌کند:

$ 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

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

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

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

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

podman(1), ps(1), seccomp(2), proc(5), capabilities(7)

ژوئیه ۲۰۱۸، معرفی توصیف‌کننده‌های قالب‌بندی توسط Valentin Rothberg vrothberg@suse.com ⟨mailto:vrothberg@suse.com⟩

دسامبر ۲۰۱۷، در ابتدا توسط Brent Baude bbaude@redhat.com ⟨mailto:bbaude@redhat.com⟩ گردآوری شد.