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  separated  arguments  or as a single comma-separated argument. Note
19       that you can specify options and/or additionally options of  ps(1);  in
20       this  case, Podman will fallback to executing ps with the specified ar‐
21       guments 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       (This  option is not available with the remote Podman client, including
32       Mac and Windows (excluding WSL2) machines)
33
34

FORMAT DESCRIPTORS

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

EXAMPLES

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

SEE ALSO

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

HISTORY

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