.nh
.TH podman\-top(1)
.SH NAME
.PP
podman\-top \- Display the running processes of a container

.SH SYNOPSIS
.PP
\fBpodman top\fP [\fIoptions\fP] \fIcontainer\fP [\fIformat\-descriptors\fP]

.PP
\fBpodman container top\fP [\fIoptions\fP] \fIcontainer\fP [\fIformat\-descriptors\fP]

.SH DESCRIPTION
.PP
Display the running processes of the container. The \fIformat\-descriptors\fP are ps (1) compatible AIX format descriptors but extended to print additional information, such as the seccomp mode or the effective capabilities of a given process. The descriptors can either be passed as separated arguments or as a single comma\-separated argument. Note that you can also specify options and or flags of ps(1); in this case, Podman will fallback to executing ps with the specified arguments and flags in the container.  Please use the "h*" descriptors if you want to extract host\-related information.  For instance, \fB\fCpodman top $name hpid huser\fR to display the PID and user of the processes in the host context.

.SH OPTIONS
.SS \fB\-\-help\fP, \fB\-h\fP
.PP
Print usage statement

.SS \fB\-\-latest\fP, \fB\-l\fP
.PP
Instead of providing the container name or ID, use the last created container. If you use methods other than Podman
to run containers such as CRI\-O, the last started container could be from either of those methods.

.PP
The latest option is not supported on the remote client.

.SH FORMAT DESCRIPTORS
.PP
The following descriptors are supported in addition to the AIX format descriptors mentioned in ps (1):

.PP
\fBargs, capbnd, capeff, capinh, capprm, comm, etime, group, hgroup, hpid, huser, label, nice, pcpu, pgid, pid, ppid, rgroup, ruser, seccomp, state, time, tty, user, vsz\fP

.PP
\fBcapbnd\fP

.PP
Set of bounding capabilities. See capabilities (7) for more information.

.PP
\fBcapeff\fP

.PP
Set of effective capabilities. See capabilities (7) for more information.

.PP
\fBcapinh\fP

.PP
Set of inheritable capabilities. See capabilities (7) for more information.

.PP
\fBcapprm\fP

.PP
Set of permitted capabilities. See capabilities (7) for more information.

.PP
\fBhgroup\fP

.PP
The corresponding effective group of a container process on the host.

.PP
\fBhpid\fP

.PP
The corresponding host PID of a container process.

.PP
\fBhuser\fP

.PP
The corresponding effective user of a container process on the host.

.PP
\fBlabel\fP

.PP
Current security attributes of the process.

.PP
\fBseccomp\fP

.PP
Seccomp mode of the process (i.e., disabled, strict or filter). See seccomp (2) for more information.

.PP
\fBstate\fP

.PP
Process state codes (e.g, \fBR\fP for \fIrunning\fP, \fBS\fP for \fIsleeping\fP). See proc(5) for more information.

.PP
\fBstime\fP

.PP
Process start time (e.g, "2019\-12\-09 10:50:36 +0100 CET).

.SH EXAMPLES
.PP
By default, \fB\fCpodman\-top\fR prints data similar to \fB\fCps \-ef\fR:

.PP
.RS

.nf
$ podman top f5a62a71b07
USER   PID   PPID   %CPU    ELAPSED         TTY     TIME   COMMAND
root   1     0      0.000   20.386825206s   pts/0   0s     sh
root   7     1      0.000   16.386882887s   pts/0   0s     sleep
root   8     1      0.000   11.386886562s   pts/0   0s     vi

.fi
.RE

.PP
The output can be controlled by specifying format descriptors as arguments after the container:

.PP
.RS

.nf
$ podman top \-l pid seccomp args %C
PID   SECCOMP   COMMAND     %CPU
1     filter    sh          0.000
8     filter    vi /etc/    0.000

.fi
.RE

.PP
Podman will fallback to executing ps(1) in the container if an unknown descriptor is specified.

.PP
.RS

.nf
$ podman top \-l \-\- aux
USER   PID   PPID   %CPU    ELAPSED             TTY   TIME   COMMAND
root   1     0      0.000   1h2m12.497061672s   ?     0s     sleep 100000

.fi
.RE

.SH SEE ALSO
.PP
podman(1), ps(1), seccomp(2), proc(5), capabilities(7)

.SH HISTORY
.PP
July 2018, Introduce format descriptors by Valentin Rothberg vrothberg@suse.com
\[la]mailto:vrothberg@suse.com\[ra]

.PP
December 2017, Originally compiled by Brent Baude bbaude@redhat.com
\[la]mailto:bbaude@redhat.com\[ra]