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

DESCRIPTION

14       Display the running processes of the container. The format-descriptors
15       are ps (1) compatible AIX format descriptors but extended to print
16       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 also specify options and or flags of ps(1); in this case,
20       Podman will fallback to executing ps with the specified arguments and
21       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 container name or ID, use the last created
35       container. If you use methods other than Podman to run containers such
36       as CRI-O, the last started container could be from either of those
37       methods.
38
39
40       The latest option is not supported on the remote client.
41
42

FORMAT DESCRIPTORS

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

EXAMPLES

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

SEE ALSO

153       podman(1), ps(1), seccomp(2), proc(5), capabilities(7)
154
155

HISTORY

157       July 2018, Introduce format descriptors by Valentin Rothberg
158       ⟨vrothberg@suse.com⟩
159
160
161       December 2017, Originally compiled by Brent Baude ⟨bbaude@redhat.com⟩
162
163
164
165                                                              podman-top (1"")
Impressum