Files
docker-cli/components/cli/man/docker-top.1.md
Pavel Pospisil 6e75b48631 Improvement of docker top Man Page
Some users expect that the `docker top $CONT` command displays information from the inside container perspective.
They expect that the `docker top $CONT` command displays same information as the `docker exec $CONT ps -ef` command. But it does not.

That's why the `docker top` man page shall explicitly state that the `docker top $CONT` displays information from the host's point of view.

Signed-off-by: Pavel Pospisil <pospispa@gmail.com>
Upstream-commit: 70efcb00b4
Component: cli
2017-06-02 00:07:18 +00:00

967 B

% DOCKER(1) Docker User Manuals % Docker Community % JUNE 2014

NAME

docker-top - Display the running processes of a container

SYNOPSIS

docker top [--help] CONTAINER [ps OPTIONS]

DESCRIPTION

Display the running process of the container. ps-OPTION can be any of the options you would pass to a Linux ps command.

All displayed information is from host's point of view.

OPTIONS

--help Print usage statement

EXAMPLES

Run docker top with the ps option of -x:

$ docker top 8601afda2b -x
PID      TTY       STAT       TIME         COMMAND
16623    ?         Ss         0:00         sleep 99999

HISTORY

April 2014, Originally compiled by William Henry (whenry at redhat dot com) based on docker.com source material and internal work. June 2014, updated by Sven Dowideit SvenDowideit@home.org.au June 2015, updated by Ma Shimiao mashimiao.fnst@cn.fujitsu.com December 2015, updated by Pavel Pospisil pospispa@gmail.com