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

EXAMPLES

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

HISTORY

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