1
0
Fork 0
mirror of https://github.com/moby/moby.git synced 2022-11-09 12:21:53 -05:00
moby--moby/docs/man/docker-ps.1.md
Dan Walsh a2b529ead2 --help option and help command should print to stdout not stderr
--help and help are successful commands so output should not go to error.

    QE teams have requested this change, also users doing docker help | less
    or docker run --help | less would expect this to work.

    Usage statement should only be printed when the user asks for it.
    Errors should print error message and then suggest the docker COMMAND --help
    command to see usage information.

    The current behaviour causes the user to have to search for the error message
    and sometimes scrolls right off the screen.  For example a error on a
    "docker run" command is very difficult to diagnose.

    Finally erros should always exit with a non 0 exit code, if the user
    makes a CLI error.

Docker-DCO-1.1-Signed-off-by: Dan Walsh <dwalsh@redhat.com> (github: rhatdan)
2015-01-06 13:40:14 +01:00

2.6 KiB

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

NAME

docker-ps - List containers

SYNOPSIS

docker ps [-a|--all[=false]] [--before[=BEFORE]] [--help] [-f|--filter[=[]]] [-l|--latest[=false]] [-n[=-1]] [--no-trunc[=false]] [-q|--quiet[=false]] [-s|--size[=false]] [--since[=SINCE]]

DESCRIPTION

List the containers in the local repository. By default this show only the running containers.

OPTIONS

-a, --all=true|false Show all containers. Only running containers are shown by default. The default is false.

--before="" Show only container created before Id or Name, include non-running ones.

--help Print usage statement

-f, --filter=[] Provide filter values. Valid filters: exited= - containers with exit code of status=(restarting|running|paused|exited)

-l, --latest=true|false Show only the latest created container, include non-running ones. The default is false.

-n=-1 Show n last created containers, include non-running ones.

--no-trunc=true|false Don't truncate output. The default is false.

-q, --quiet=true|false Only display numeric IDs. The default is false.

-s, --size=true|false Display total file sizes. The default is false.

--since="" Show only containers created since Id or Name, include non-running ones.

EXAMPLES

Display all containers, including non-running

# docker ps -a
CONTAINER ID        IMAGE                 COMMAND                CREATED             STATUS      PORTS    NAMES
a87ecb4f327c        fedora:20             /bin/sh -c #(nop) MA   20 minutes ago      Exit 0               desperate_brattain
01946d9d34d8        vpavlin/rhel7:latest  /bin/sh -c #(nop) MA   33 minutes ago      Exit 0               thirsty_bell
c1d3b0166030        acffc0358b9e          /bin/sh -c yum -y up   2 weeks ago         Exit 1               determined_torvalds
41d50ecd2f57        fedora:20             /bin/sh -c #(nop) MA   2 weeks ago         Exit 0               drunk_pike

Display only IDs of all containers, including non-running

# docker ps -a -q
a87ecb4f327c
01946d9d34d8
c1d3b0166030
41d50ecd2f57

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 August 2014, updated by Sven Dowideit SvenDowideit@home.org.au November 2014, updated by Sven Dowideit SvenDowideit@home.org.au