podman-pod-top(1)

1podman-pod-top(1)           General Commands Manual          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
15       format-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
54       information.
55
56
57       capeff
58
59
60       Set of effective capabilities. See capabilities (7) for more
61       information.
62
63
64       capinh
65
66
67       Set of inheritable capabilities. See capabilities (7) for more
68       information.
69
70
71       capprm
72
73
74       Set of permitted capabilities. See capabilities (7) for more
75       information.
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
128       arguments 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
145
146
147                                                             podman-pod-top(1)