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 also specify options and or flags of ps(1);
20       in  this  case, Podman will fallback to executing ps with the specified
21       arguments and flags in the container.
22
23

OPTIONS

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

FORMAT DESCRIPTORS

41       Please refer to podman-top(1) for a full list of available descriptors.
42
43

EXAMPLES

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

SEE ALSO

67       podman-pod(1),  podman-top(1),  ps(1),  seccomp(2),  proc(5), capabili‐
68       ties(7)
69
70

HISTORY

72       August  2018,  Originally  compiled  by  Peter  Hunt  pehunt@redhat.com
73       ⟨mailto:pehunt@redhat.com⟩
74
75
76
77                                                           podman-pod-top(1)()
Impressum