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

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


خلاصه دستور (SYNOPSIS)
       podman top [options] container [format-descriptors]


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


توضیحات (DESCRIPTION)
       نمایش فرآیندهای در حال اجرای کانتینر. توصیف‌کننده‌های قالب‌بندی (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 و کاربر فرآیندها در بافت میزبان.


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


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


توصیف‌کننده‌های قالب‌بندی (FORMAT DESCRIPTORS)
       علاوه بر توصیف‌کننده‌های فرمت 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").


مثال‌ها (EXAMPLES)
       به‌طور پیش‌فرض، 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


همچنین ببینید (SEE ALSO)
       podman(1), ps(1), seccomp(2), proc(5), capabilities(7)


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


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

                                                                 podman-top(1)