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.
25
26

OPTIONS

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

FORMAT DESCRIPTORS

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

EXAMPLES

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

HISTORY

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