Files
podman/docs/podman-top.1.md
baude 7b08aa78e4 Shortcut for most recent container
It is desirable to have a shortcut for the most
recently created container.  We can now use "**latest"
to represent the most recent container instead of its
container ID or name.  For example:

Signed-off-by: baude <bbaude@redhat.com>

Closes: #179
Approved by: baude
2018-01-08 19:12:17 +00:00

64 lines
1.6 KiB
Markdown

% podman(1) podman-top - display the running processes of a container
% Brent Baude
## NAME
podman top - Display the running processes of a container
## SYNOPSIS
**podman top**
[**--help**|**-h**]
## DESCRIPTION
Display the running process of the container. ps-OPTION can be any of the options you would pass to a Linux ps command
**podman [GLOBAL OPTIONS] top [OPTIONS]**
## OPTIONS
**--help, -h**
Print usage statement
**--format**
Display the output in an alternate format. The only supported format is **JSON**.
**--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.
## EXAMPLES
```
# podman top f5a62a71b07
UID PID PPID %CPU STIME TT TIME CMD
0 18715 18705 0.0 10:35 pts/0 00:00:00 /bin/bash
0 18741 18715 0.0 10:35 pts/0 00:00:00 vi
#
```
```
#podman --log-level=debug top f5a62a71b07 -o fuser,f,comm,label
FUSER F COMMAND LABEL
root 4 bash system_u:system_r:container_t:s0:c429,c1016
root 0 vi system_u:system_r:container_t:s0:c429,c1016
#
```
```
# podman top --format=json f5a62a71b07b -o %cpu,%mem,command,blocked
[
{
"CPU": "0.0",
"MEM": "0.0",
"COMMAND": "vi",
"BLOCKED": "0000000000000000",
"START": "",
"TIME": "",
"C": "",
"CAUGHT": "",
...
```
## SEE ALSO
podman(1), ps(1)
## HISTORY
December 2017, Originally compiled by Brent Baude<bbaude@redhat.com>