1podman-pod-top(1)           General Commands Manual          podman-pod-top(1)
2
3
4

NAME

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

SYNOPSIS

10       podman pod top [options] pod [format-descriptors]
11
12

DESCRIPTION

14       Display  the  running  processes of containers in a pod. The format-de‐
15       scriptors are ps (1) compatible AIX format descriptors but extended  to
16       print additional information, such as the seccomp mode or the effective
17       capabilities of a given process. The descriptors can either  be  passed
18       as separate arguments or as a single comma-separated argument.
19
20

OPTIONS

22   --help, -h
23       Print usage statement
24
25
26   --latest, -l
27       Instead  of  providing  the  pod  name or ID, use the last created pod.
28       Note: the last started pod can be from other users  of  Podman  on  the
29       host  machine.   (This  option  is not available with the remote Podman
30       client, including Mac and Windows (excluding WSL2) machines)
31
32

FORMAT DESCRIPTORS

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

EXAMPLES

38       By default, podman-pod-top prints data similar to ps -ef:
39
40
41              $ podman pod top b031293491cc
42              USER   PID   PPID   %CPU    ELAPSED             TTY   TIME   COMMAND
43              root   1     0      0.000   2h5m38.737137571s   ?     0s     top
44              root   8     0      0.000   2h5m15.737228361s   ?     0s     top
45
46
47
48       The output can be controlled by specifying format descriptors as  argu‐
49       ments after the pod:
50
51
52              $ podman pod top -l pid seccomp args %C
53              PID   SECCOMP   COMMAND   %CPU
54              1     filter    top       0.000
55              1     filter    /bin/sh   0.000
56
57
58

SEE ALSO

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

HISTORY

64       August  2018,  Originally  compiled  by  Peter  Hunt  pehunt@redhat.com
65       ⟨mailto:pehunt@redhat.com⟩
66
67
68
69                                                             podman-pod-top(1)
Impressum