1podman-pod-top(1)()                                        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 for‐
15       mat-descriptors are  ps  (1)  compatible  AIX  format  descriptors  but
16       extended  to  print additional information, such as the seccomp mode or
17       the effective capabilities of a  given  process.  The  descriptors  can
18       either  be passed as separated arguments or as a single comma-separated
19       argument. Note that you can specify options and/or additionally options
20       of  ps(1);  in this case, Podman will fallback to executing ps with the
21       specified arguments and options in the container.
22
23

OPTIONS

25   --help, -h
26       Print usage statement
27
28
29   --latest, -l
30       Instead of providing the pod name or ID, use the last created pod.
31
32
33       The latest option is not supported on the remote client.
34
35

FORMAT DESCRIPTORS

37       Please refer to podman-top(1) for a full list of available descriptors.
38
39

EXAMPLES

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

SEE ALSO

63       podman-pod(1),  podman-top(1),  ps(1),  seccomp(2),  proc(5), capabili‐
64       ties(7)
65
66

HISTORY

68       August  2018,  Originally  compiled  by  Peter  Hunt  pehunt@redhat.com
69       ⟨mailto:pehunt@redhat.com⟩
70
71
72
73                                                           podman-pod-top(1)()
Impressum