mirror of
https://github.com/containers/podman.git
synced 2025-06-03 20:33:20 +08:00
1c0cd0796a
All bash examples are now placed in a code section (```). The PS1 prompt is set to `$`. Signed-off-by: Valentin Rothberg <vrothberg@suse.com> Closes: #1375 Approved by: rhatdan
97 lines
2.7 KiB
Markdown
97 lines
2.7 KiB
Markdown
% podman-top "1"
|
|
|
|
## NAME
|
|
podman\-top - Display the running processes of a container
|
|
|
|
## SYNOPSIS
|
|
**podman top** [*options*] *container* [*format-descriptors*]
|
|
|
|
## DESCRIPTION
|
|
Display the running process of the container. The *format-descriptors* 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.
|
|
|
|
## OPTIONS
|
|
|
|
**--help, -h**
|
|
|
|
Print usage statement
|
|
|
|
**--latest, -l**
|
|
|
|
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.
|
|
|
|
## FORMAT DESCRIPTORS
|
|
|
|
The following descriptors are supported in addition to the AIX format descriptors mentioned in ps (1):
|
|
|
|
**args, capbnd, capeff, capinh, capprm, comm, etime, group, hgroup, hpid, huser, label, nice, pcpu, pgid, pid, ppid, rgroup, ruser, seccomp, state, time, tty, user, vsz**
|
|
|
|
**capbnd**
|
|
|
|
Set of bounding capabilities. See capabilities (7) for more information.
|
|
|
|
**capeff**
|
|
|
|
Set of effective capabilities. See capabilities (7) for more information.
|
|
|
|
**capinh**
|
|
|
|
Set of inheritable capabilities. See capabilities (7) for more information.
|
|
|
|
**capprm**
|
|
|
|
Set of permitted capabilities. See capabilities (7) for more information.
|
|
|
|
**hgroup**
|
|
|
|
The corresponding effective group of a container process on the host.
|
|
|
|
**hpid**
|
|
|
|
The corresponding host PID of a container process.
|
|
|
|
**huser**
|
|
|
|
The corresponding effective user of a container process on the host.
|
|
|
|
**label**
|
|
|
|
Current security attributes of the process.
|
|
|
|
**seccomp**
|
|
|
|
Seccomp mode of the process (i.e., disabled, strict or filter). See seccomp (2) for more information.
|
|
|
|
**state**
|
|
|
|
Process state codes (e.g, **R** for *running*, **S** for *sleeping*). See proc(5) for more information.
|
|
|
|
## EXAMPLES
|
|
|
|
By default, `podman-top` prints data similar to `ps -ef`:
|
|
|
|
```
|
|
$ 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
|
|
```
|
|
|
|
The output can be controlled by specifying format descriptors as arguments after the container:
|
|
|
|
```
|
|
$ sudo ./bin/podman top -l pid seccomp args %C
|
|
PID SECCOMP COMMAND %CPU
|
|
1 filter sh 0.000
|
|
8 filter vi /etc/ 0.000
|
|
```
|
|
|
|
## SEE ALSO
|
|
podman(1), ps(1), seccomp(2), proc(5), capabilities(7)
|
|
|
|
## HISTORY
|
|
July 2018, Introduce format descriptors by Valentin Rothberg <vrothberg@suse.com>
|
|
|
|
December 2017, Originally compiled by Brent Baude <bbaude@redhat.com>
|