podman-pod-top(1)

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       The following descriptors are supported in addition to the  AIX  format
42       descriptors mentioned in ps (1):
43
44
45       args, capbnd, capeff, capinh, capprm, comm, etime, group, hgroup, hpid,
46       huser, label, nice, pcpu, pgid,  pid,  ppid,  rgroup,  ruser,  seccomp,
47       state, time, tty, user, vsz
48
49
50       capbnd
51
52
53       Set  of  bounding  capabilities. See capabilities (7) for more informa‐
54       tion.
55
56
57       capeff
58
59
60       Set of effective capabilities. See capabilities (7) for  more  informa‐
61       tion.
62
63
64       capinh
65
66
67       Set of inheritable capabilities. See capabilities (7) for more informa‐
68       tion.
69
70
71       capprm
72
73
74       Set of permitted capabilities. See capabilities (7) for  more  informa‐
75       tion.
76
77
78       hgroup
79
80
81       The corresponding effective group of a container process on the host.
82
83
84       hpid
85
86
87       The corresponding host PID of a container process.
88
89
90       huser
91
92
93       The corresponding effective user of a container process on the host.
94
95
96       label
97
98
99       Current security attributes of the process.
100
101
102       seccomp
103
104
105       Seccomp  mode  of  the  process (i.e., disabled, strict or filter). See
106       seccomp (2) for more information.
107
108
109       state
110
111
112       Process state codes (e.g, R for running, S for sleeping).  See  proc(5)
113       for more information.
114
115

EXAMPLES

117       By default, podman-top prints data similar to ps -ef:
118
119
120              $ podman pod top b031293491cc
121              USER   PID   PPID   %CPU    ELAPSED             TTY   TIME   COMMAND
122              root   1     0      0.000   2h5m38.737137571s   ?     0s     top
123              root   8     0      0.000   2h5m15.737228361s   ?     0s     top
124
125
126
127       The  output can be controlled by specifying format descriptors as argu‐
128       ments after the pod:
129
130
131              $ podman pod top -l pid seccomp args %C
132              PID   SECCOMP   COMMAND   %CPU
133              1     filter    top       0.000
134              1     filter    /bin/sh   0.000
135
136
137

HISTORY

143       August  2018,  Originally  compiled  by  Peter  Hunt  pehunt@redhat.com
144       ⟨mailto:pehunt@redhat.com⟩
145
146
147
148                                                           podman-pod-top(1)()