podman-top(1)

1podman-top(1)()                                                podman-top(1)()
2
3
4

NAME

6       podman-top - Display the running processes of a container
7
8

SYNOPSIS

10       podman top [options] container [format-descriptors]
11
12
13       podman container top [options] container [format-descriptors]
14
15

DESCRIPTION

17       Display  the running processes of the container. The format-descriptors
18       are ps (1) compatible AIX format  descriptors  but  extended  to  print
19       additional information, such as the seccomp mode or the effective capa‐
20       bilities of a given process. The descriptors can either  be  passed  as
21       separated  arguments or as a single comma-separated argument. Note that
22       you can also specify options and or flags of ps(1); in this case,  Pod‐
23       man  will  fallback  to  executing  ps with the specified arguments and
24       flags in the container.  Please use the "h*" descriptors if you want to
25       extract  host-related information.  For instance, podman top $name hpid
26       huser to display the PID and user of the processes in the host context.
27
28

OPTIONS

30   --help, -h
31       Print usage statement
32
33
34   --latest, -l
35       Instead of providing the container name or ID,  use  the  last  created
36       container.  If you use methods other than Podman to run containers such
37       as CRI-O, the last started container could  be  from  either  of  those
38       methods.
39
40
41       The latest option is not supported on the remote client.
42
43

FORMAT DESCRIPTORS

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

EXAMPLES

127       By default, podman-top prints data similar to ps -ef:
128
129
130              $ podman top f5a62a71b07
131              USER   PID   PPID   %CPU    ELAPSED         TTY     TIME   COMMAND
132              root   1     0      0.000   20.386825206s   pts/0   0s     sh
133              root   7     1      0.000   16.386882887s   pts/0   0s     sleep
134              root   8     1      0.000   11.386886562s   pts/0   0s     vi
135
136
137
138       The output can be controlled by specifying format descriptors as  argu‐
139       ments after the container:
140
141
142              $ podman top -l pid seccomp args %C
143              PID   SECCOMP   COMMAND     %CPU
144              1     filter    sh          0.000
145              8     filter    vi /etc/    0.000
146
147
148
149       Podman  will fallback to executing ps(1) in the container if an unknown
150       descriptor is specified.
151
152
153              $ podman top -l -- aux
154              USER   PID   PPID   %CPU    ELAPSED             TTY   TIME   COMMAND
155              root   1     0      0.000   1h2m12.497061672s   ?     0s     sleep 100000
156
157
158

HISTORY

164       July 2018, Introduce format descriptors  by  Valentin  Rothberg  vroth‐
165       berg@suse.com ⟨mailto:vrothberg@suse.com⟩
166
167
168       December  2017,  Originally  compiled  by Brent Baude bbaude@redhat.com
169       ⟨mailto:bbaude@redhat.com⟩
170
171
172
173                                                               podman-top(1)()