podman-pod-ps - Man Page

Prints out information about pods

Synopsis

podman pod ps [options]

Description

podman pod ps lists the pods on the system. By default it lists:

StatusDescription
CreatedNo containers running nor stopped
Runningat least one container is running
StoppedAt least one container stopped and none running
ExitedAll containers stopped in pod
DeadError retrieving state

Options

--ctr-names

Includes the container names in the container info field

--ctr-ids

Includes the container IDs in the container info field

--ctr-status

Includes the container statuses in the container info field

--latest, -l

Show the latest pod created (all states)

The latest option is not supported on the remote client.

--no-trunc

Display the extended information

--ns

Display namespace information of the pod

--quiet, -q

Print the numeric IDs of the pods only

--format=format

Pretty-print containers to JSON or using a Go template

Valid placeholders for the Go template are listed below:

PlaceholderDescription
.IDContainer ID
.NameName of pod
.StatusStatus of pod
.LabelsAll the labels assigned to the pod
.NumberOfContainersShow the number of containers attached to pod
.CgroupCgroup path of pod
.CreatedCreation time of pod
.InfraIDPod infra container ID
.NetworksShow all networks connected to the infra container

--sort

Sort by created, ID, name, status, or number of containers

Default: created

--filter, -f=filter

Filter output based on conditions given. Multiple filters can be given with multiple uses of the --filter flag. Filters with the same key work inclusive with the only exception being label which is exclusive. Filters with different keys always work exclusive.

Valid filters are listed below:

FilterDescription
id[ID] Pod's ID (accepts regex)
name[Name] Pod's name (accepts regex)
label[Key] or [Key=Value] Label assigned to a container
statusPod's status:
stopped,
running,
paused,
exited,
dead,
created,
degradednetwork[Network] name or full ID of network
ctr-namesContainer name within the pod (accepts regex)
ctr-idsContainer ID within the pod (accepts regex)
ctr-statusContainer status within the pod
ctr-numberNumber of containers in the pod

--help, -h

Print usage statement

Examples

$ podman pod ps
POD ID         NAME              STATUS    NUMBER OF CONTAINERS
00dfd6fa02c0   jolly_goldstine   Running   1
f4df8692e116   nifty_torvalds    Created   2
$ podman pod ps --ctr-names
POD ID         NAME              STATUS    CONTAINER INFO
00dfd6fa02c0   jolly_goldstine   Running   [ loving_archimedes ]
f4df8692e116   nifty_torvalds    Created   [ thirsty_hawking ] [ wizardly_golick ]
$ podman pod ps --ctr-status --ctr-names --ctr-ids
POD ID         NAME              STATUS    CONTAINER INFO
00dfd6fa02c0   jolly_goldstine   Running   [ ba465ab0a3a4 loving_archimedes Running ]
f4df8692e116   nifty_torvalds    Created   [ 331693bff40a thirsty_hawking Created ] [ 8e428daeb89e wizardly_golick Created ]
$ podman pod ps --format "{{.ID}}  {{.ContainerInfo}}  {{.Cgroup}}" --ctr-names
00dfd6fa02c0      [ loving_archimedes ]                         /libpod_parent
f4df8692e116      [ thirsty_hawking ] [ wizardly_golick ]       /libpod_parent
$ podman pod ps --cgroup
POD ID         NAME              STATUS    NUMBER OF CONTAINERS   CGROUP           USE POD CGROUP
00dfd6fa02c0   jolly_goldstine   Running   1                      /libpod_parent   true
f4df8692e116   nifty_torvalds    Created   2                      /libpod_parent   true
$ podman pod ps --sort id --filter ctr-number=2
POD ID         NAME             STATUS    NUMBER OF CONTAINERS
f4df8692e116   nifty_torvalds   Created   2
$ podman pod ps  --ctr-ids
POD ID         NAME              STATUS    CONTAINER INFO
00dfd6fa02c0   jolly_goldstine   Running   [ ba465ab0a3a4 ]
f4df8692e116   nifty_torvalds    Created   [ 331693bff40a ] [ 8e428daeb89e ]
$ podman pod ps --no-trunc --ctr-ids
POD ID                                                             NAME              STATUS    CONTAINER INFO
00dfd6fa02c0a2daaedfdf8fcecd06f22ad114d46d167d71777224735f701866   jolly_goldstine   Running   [ ba465ab0a3a4e15e3539a1e79c32d1213a02b0989371e274f98e0f1ae9de7050 ]
f4df8692e116a3e6d1d62572644ed36ca475d933808cc3c93435c45aa139314b   nifty_torvalds    Created   [ 331693bff40a0ef2f05a3aba73ce49e3243108911927fff04d1f7fc44dda8022 ] [ 8e428daeb89e69b71e7916a13accfb87d122889442b5c05c2d99cf94a3230e9d ]
$ podman pod ps --ctr-names
POD ID         NAME   STATUS    CONTAINER INFO
314f4da82d74   hi     Created   [ jovial_jackson ] [ hopeful_archimedes ] [ vibrant_ptolemy ] [ heuristic_jennings ] [ keen_raman ] [ hopeful_newton ] [ mystifying_bose ] [ silly_lalande ] [ serene_lichterman ] ...

pod ps

Print a list of pods

See Also

podman-pod(1)

History

July 2018, Originally compiled by Peter Hunt pehunt@redhat.com ⟨mailto:pehunt@redhat.com⟩

Referenced By

podman-pod(1), podman-pod-inspect(1), podman-pod-prune(1).

The man page docker-pod-ps(1) is an alias of podman-pod-ps(1).