1podman-pod-ps(1)() podman-pod-ps(1)()
2
6 podman-pod-ps - Prints out information about pods
7
10 podman pod ps [options]
11
14 podman pod ps lists the pods on the system. By default it lists:
15 • pod id
18 • pod name
20 • the time the pod was created
22 • number of containers attached to pod
24 • container id of the pod infra container
26 • status of pod as defined by the following table
28 ┌────────┬───────────────────────────────┐
32 │Status │ Description │
33 ├────────┼───────────────────────────────┤
34 │Created │ No containers running nor │
35 │ │ stopped │
36 ├────────┼───────────────────────────────┤
37 │Running │ at least one container is │
38 │ │ running │
39 ├────────┼───────────────────────────────┤
40 │Stopped │ At least one container │
41 │ │ stopped and none running │
42 ├────────┼───────────────────────────────┤
43 │Exited │ All containers stopped in pod │
44 ├────────┼───────────────────────────────┤
45 │Dead │ Error retrieving state │
46 └────────┴───────────────────────────────┘
47
49 --ctr-names
50 Display the container names
51 --ctr-ids
54 Display the container IDs
55 --ctr-status
58 Display the container statuses
59 --latest, -l
62 Show the latest pod created (all states) (This option is not available
63 with the remote Podman client)
64 --noheading
67 Omit the table headings from the listing of pods.
68 --no-trunc
71 Display the extended information
72 --ns
75 Display namespace information of the pod
76 --quiet, -q
79 Print the numeric IDs of the pods only
80 --format=format
83 Pretty-print containers to JSON or using a Go template
84 Valid placeholders for the Go template are listed below:
87 ┌────────────────────┬────────────────────────────┐
90 │Placeholder │ Description │
91 ├────────────────────┼────────────────────────────┤
92 │.ID │ Container ID │
93 ├────────────────────┼────────────────────────────┤
94 │.Name │ Name of pod │
95 ├────────────────────┼────────────────────────────┤
96 │.Status │ Status of pod │
97 ├────────────────────┼────────────────────────────┤
98 │.Labels │ All the labels assigned to │
99 │ │ the pod │
100 ├────────────────────┼────────────────────────────┤
101 │.NumberOfContainers │ Show the number of con‐ │
102 │ │ tainers attached to pod │
103 ├────────────────────┼────────────────────────────┤
104 │.Cgroup │ Cgroup path of pod │
105 ├────────────────────┼────────────────────────────┤
106 │.Created │ Creation time of pod │
107 ├────────────────────┼────────────────────────────┤
108 │.InfraID │ Pod infra container ID │
109 ├────────────────────┼────────────────────────────┤
110 │.Networks │ Show all networks con‐ │
111 │ │ nected to the infra con‐ │
112 │ │ tainer │
113 └────────────────────┴────────────────────────────┘
114 --sort
116 Sort by created, ID, name, status, or number of containers
117 Default: created
120 --filter, -f=filter
123 Filter output based on conditions given. Multiple filters can be given
124 with multiple uses of the --filter flag. Filters with the same key
125 work inclusive with the only exception being label which is exclusive.
126 Filters with different keys always work exclusive.
127 Valid filters are listed below:
130 ┌───────────┬─────────────────────────────────────────────────────────────────────────┐
133 │Filter │ Description │
134 ├───────────┼─────────────────────────────────────────────────────────────────────────┤
135 │id │ [ID] Pod's ID (accepts regex) │
136 ├───────────┼─────────────────────────────────────────────────────────────────────────┤
137 │name │ [Name] Pod's name (accepts regex) │
138 ├───────────┼─────────────────────────────────────────────────────────────────────────┤
139 │label │ [Key] or [Key=Value] Label assigned to a container │
140 ├───────────┼─────────────────────────────────────────────────────────────────────────┤
141 │until │ Only list pods created before given timestamp │
142 ├───────────┼─────────────────────────────────────────────────────────────────────────┤
143 │status │ Pod's status: stopped, running, paused, exited, dead, created, degraded │
144 ├───────────┼─────────────────────────────────────────────────────────────────────────┤
145 │network │ [Network] name or full ID of network │
146 ├───────────┼─────────────────────────────────────────────────────────────────────────┤
147 │ctr-names │ Container name within the pod (accepts regex) │
148 ├───────────┼─────────────────────────────────────────────────────────────────────────┤
149 │ctr-ids │ Container ID within the pod (accepts regex) │
150 ├───────────┼─────────────────────────────────────────────────────────────────────────┤
151 │ctr-status │ Container status within the pod │
152 ├───────────┼─────────────────────────────────────────────────────────────────────────┤
153 │ctr-number │ Number of containers in the pod │
154 └───────────┴─────────────────────────────────────────────────────────────────────────┘
155 --help, -h
157 Print usage statement
158
161 $ podman pod ps
162 POD ID NAME STATUS CREATED INFRA ID # OF CONTAINERS
163 00dfd6fa02c0 jolly_goldstine Running 31 hours ago ba465ab0a3a4 1
164 f4df8692e116 nifty_torvalds Created 10 minutes ago 331693bff40a 2
165 $ podman pod ps --ctr-names
169 POD ID NAME STATUS CREATED INFRA ID NAMES
170 00dfd6fa02c0 jolly_goldstine Running 31 hours ago ba465ab0a3a4 loving_archimedes
171 f4df8692e116 nifty_torvalds Created 10 minutes ago 331693bff40a thirsty_hawking,wizardly_golick
172 $ podman pod ps --ctr-status --ctr-names --ctr-ids
176 POD ID NAME STATUS CREATED INFRA ID IDS NAMES STATUS
177 00dfd6fa02c0 jolly_goldstine Running 31 hours ago ba465ab0a3a4 ba465ab0a3a4 loving_archimedes running
178 f4df8692e116 nifty_torvalds Created 10 minutes ago 331693bff40a 331693bff40a,8e428daeb89e thirsty_hawking,wizardly_golick configured,configured
179 $ podman pod ps --format "{{.ID}} {{.ContainerNames}} {{.Cgroup}}"
183 00dfd6fa02c0 loving_archimedes /libpod_parent
184 f4df8692e116 thirsty_hawking,wizardly_golick /libpod_parent
185 $ podman pod ps --sort id --filter ctr-number=2
189 POD ID NAME STATUS CREATED INFRA ID # OF CONTAINERS
190 f4df8692e116 nifty_torvalds Created 10 minutes ago 331693bff40a 2
191 $ podman pod ps --ctr-ids
195 POD ID NAME STATUS CREATED INFRA ID IDS
196 00dfd6fa02c0 jolly_goldstine Running 31 hours ago ba465ab0a3a4 ba465ab0a3a4
197 f4df8692e116 nifty_torvalds Created 10 minutes ago 331693bff40a 331693bff40a,8e428daeb89e
198 $ podman pod ps --no-trunc --ctr-ids
202 POD ID NAME STATUS CREATED INFRA ID IDS
203 00dfd6fa02c0a2daaedfdf8fcecd06f22ad114d46d167d71777224735f701866 jolly_goldstine Running 31 hours ago ba465ab0a3a4e15e3539a1e79c32d1213a02b0989371e274f98e0f1ae9de7050 ba465ab0a3a4e15e3539a1e79c32d1213a02b0989371e274f98e0f1ae9de7050
204 f4df8692e116a3e6d1d62572644ed36ca475d933808cc3c93435c45aa139314b nifty_torvalds Created 10 minutes ago 331693bff40a926b6d52b184e116afd15497610c378d5d4c42945dd6e33b75b0 331693bff40a926b6d52b184e116afd15497610c378d5d4c42945dd6e33b75b0,8e428daeb89e69b71e7916a13accfb87d122889442b5c05c2d99cf94a3230e9d
205 $ podman pod ps --ctr-names
209 POD ID NAME STATUS CREATED INFRA ID NAMES
210 314f4da82d74 hi Created 17 hours ago a9f2d2165675 jovial_jackson,hopeful_archimedes,vibrant_ptolemy,heuristic_jennings,keen_raman,hopeful_newton,mystifying_bose,silly_lalande,serene_lichterman ...
211
215 Print a list of pods
216
219 podman-pod(1)
220
223 July 2018, Originally compiled by Peter Hunt pehunt@redhat.com
224 ⟨mailto:pehunt@redhat.com⟩
225 podman-pod-ps(1)()