Files
podman/docs/podman-top.1.md
W. Trevor King f2462ca59e docs: Follow man-pages(7) suggestions for SYNOPSIS
man-pages(7) has [1]:

> For commands, this shows the syntax of the command and its arguments
> (including options); boldface is used for as-is text and italics are
> used to indicate replaceable arguments. Brackets ([]) surround
> optional arguments, vertical bars (|) separate choices, and ellipses
> (...) can be repeated.

I've adjusted our SYNOPSIS entries to match that formatting, and
generally tried to make them more consistent with the precedent set by
the man-pages project.  Outside of the SYNOPSIS entry, I prefer using
backticks for literals, although in some places I've left the **
bolding to keep things visually similar to a nearby SYNOPSIS entry.

[1]: http://man7.org/linux/man-pages/man7/man-pages.7.html

Signed-off-by: W. Trevor King <wking@tremily.us>

Closes: #1027
Approved by: rhatdan
2018-07-04 09:40:37 +00:00

1.1 KiB

% podman-top "1"

NAME

podman-top - Display the running processes of a container

SYNOPSIS

podman top [options] container [ps-options]

DESCRIPTION

Display the running process of the container. ps-options can be any of the options you would pass to ps(1).

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.

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 pid,fuser,f,comm,label
  PID FUSER    F COMMAND         LABEL
18715 root     4 bash            system_u:system_r:container_t:s0:c429,c1016
18741 root     0 vi              system_u:system_r:container_t:s0:c429,c1016
#

SEE ALSO

podman(1), ps(1)

HISTORY

December 2017, Originally compiled by Brent Baudebbaude@redhat.com