aboutsummaryrefslogtreecommitdiff
path: root/docs/podman-top.1.md
blob: eed15c584a34526e59ceb4d7740c14490af5545e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
% 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>