NAME

       podman-pod-top - Display the running processes of containers in a pod

SYNOPSIS

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

DESCRIPTION

       Display  the  running  processes of containers in a pod. 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 separate arguments or
       as a single comma-separated argument.

OPTIONS

   --help, -h
       Print usage statement

   --latest, -l
       Instead of providing the pod name or ID, use the last created pod.  Note: the last  started  pod  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

       For a full list of available descriptors, see podman-top(1)

EXAMPLES

       By default, podman-pod-top prints data similar to ps -ef:

       $ podman pod top b031293491cc
       USER   PID   PPID   %CPU    ELAPSED             TTY   TIME   COMMAND
       root   1     0      0.000   2h5m38.737137571s   ?     0s     top
       root   8     0      0.000   2h5m15.737228361s   ?     0s     top

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

       $ podman pod top -l pid seccomp args %C
       PID   SECCOMP   COMMAND   %CPU
       1     filter    top       0.000
       1     filter    /bin/sh   0.000

SEE ALSO

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

HISTORY

       August 2018, Originally compiled by Peter Hunt pehunt@redhat.com ⟨mailto:pehunt@redhat.com⟩

                                                                                               podman-pod-top(1)