NAME

       podman-top - Display the running processes of a container

SYNOPSIS

       podman top [options] container [format-descriptors]

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

DESCRIPTION

       Display  the  running processes of the container. The format-descriptors are ps (1) compatible AIX format
       descriptors but extended to print additional information, such as  the  seccomp  mode  or  the  effective
       capabilities  of  a  given  process.  The descriptors can either be passed as separated arguments or as a
       single comma-separated argument. Note that options and or flags of ps(1) can also be specified;  in  this
       case,  Podman  falls  back to executing ps(1) from the host with the specified arguments and flags in the
       container namespace. If the container has the CAP_SYS_PTRACE capability then we will execute ps(1) in the
       container so it must be installed there.  To extract host-related information, use the "h*"  descriptors.
       For  instance,  podman  top  $name  hpid  huser  to display the PID and user of the processes in the host
       context.

OPTIONS

   --help, -h
       Print usage statement

   --latest, -l
       Instead of providing the container name or ID, use the last created container.  Note:  the  last  started
       container  can be from other users of Podman on the host machine.  (This option is not available with the
       remote Podman client, including Mac and Windows (excluding WSL2) machines)

FORMAT DESCRIPTORS

       The following descriptors are supported in addition to the AIX format descriptors mentioned in ps (1):

       args, capbnd, capeff, capinh, capprm, comm, etime, group, hgroup, hpid, huser, label, nice,  pcpu,  pgid,
       pid, ppid, rgroup, ruser, seccomp, state, time, tty, user, vsz

       capbnd

       Set of bounding capabilities. See capabilities (7) for more information.

       capeff

       Set of effective capabilities. See capabilities (7) for more information.

       capinh

       Set of inheritable capabilities. See capabilities (7) for more information.

       capprm

       Set of permitted capabilities. See capabilities (7) for more information.

       hgroup

       The corresponding effective group of a container process on the host.

       hpid

       The corresponding host PID of a container process.

       huser

       The corresponding effective user of a container process on the host.

       label

       Current security attributes of the process.

       seccomp

       Seccomp mode of the process (i.e., disabled, strict or filter). See seccomp (2) for more information.

       state

       Process state codes (e.g, R for running, S for sleeping). See proc(5) for more information.

       stime

       Process start time (e.g, "2019-12-09 10:50:36 +0100 CET).

EXAMPLES

       By default, podman-top prints data similar to 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

       The output can be controlled by specifying format descriptors as arguments after the container:

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

       Podman falls back to executing ps(1) from the host in the container namespace if an unknown descriptor is
       specified.

       $ 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

       July     2018,     Introduce    format    descriptors    by    Valentin    Rothberg    vrothberg@suse.com
       ⟨mailto:vrothberg@suse.com⟩

       December 2017, Originally compiled by Brent Baude bbaude@redhat.com ⟨mailto:bbaude@redhat.com⟩

                                                                                                   podman-top(1)