github.com/hanks177/podman/v4@v4.1.3-0.20220613032544-16d90015bc83/docs/source/markdown/podman-pod-top.1.md (about)

     1  % podman-pod-top(1)
     2  
     3  ## NAME
     4  podman\-pod\-top - Display the running processes of containers in a pod
     5  
     6  ## SYNOPSIS
     7  **podman pod top** [*options*] *pod* [*format-descriptors*]
     8  
     9  ## DESCRIPTION
    10  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 separated arguments or as a single comma-separated argument. Note that you can specify options and/or additionally options of ps(1); in this case, Podman will fallback to executing ps with the specified arguments and options in the container.
    11  
    12  ## OPTIONS
    13  
    14  #### **--help**, **-h**
    15  
    16    Print usage statement
    17  
    18  #### **--latest**, **-l**
    19  
    20  Instead of providing the pod name or ID, use the last created pod. (This option is not available with the remote Podman client, including Mac and Windows (excluding WSL2) machines)
    21  
    22  ## FORMAT DESCRIPTORS
    23  
    24  Please refer to podman-top(1) for a full list of available descriptors.
    25  
    26  ## EXAMPLES
    27  
    28  By default, `podman-pod-top` prints data similar to `ps -ef`:
    29  
    30  ```
    31  $ podman pod top b031293491cc
    32  USER   PID   PPID   %CPU    ELAPSED             TTY   TIME   COMMAND
    33  root   1     0      0.000   2h5m38.737137571s   ?     0s     top
    34  root   8     0      0.000   2h5m15.737228361s   ?     0s     top
    35  ```
    36  
    37  The output can be controlled by specifying format descriptors as arguments after the pod:
    38  
    39  ```
    40  $ podman pod top -l pid seccomp args %C
    41  PID   SECCOMP   COMMAND   %CPU
    42  1     filter    top       0.000
    43  1     filter    /bin/sh   0.000
    44  ```
    45  
    46  ## SEE ALSO
    47  **[podman(1)](podman.1.md)**, **[podman-pod(1)](podman-pod.1.md)**, **ps(1)**, **seccomp(2)**, **proc(5)**, **capabilities(7)**
    48  
    49  ## HISTORY
    50  August 2018, Originally compiled by Peter Hunt <pehunt@redhat.com>