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-ids
50 Display the container IDs
51 --ctr-names
54 Display the container names
55 --ctr-status
58 Display the container statuses
59 --filter, -f=filter
62 Provide filter values.
63 The filters argument format is of key=value. If there is more than one
66 filter, then pass multiple OPTIONS: --filter foo=bar --filter bif=baz.
67 Supported filters:
70 ┌───────────┬────────────────────────────┐
73 │Filter │ Description │
74 ├───────────┼────────────────────────────┤
75 │ctr-ids │ Filter by container ID │
76 │ │ within the pod. │
77 ├───────────┼────────────────────────────┤
78 │ctr-names │ Filter by container name │
79 │ │ within the pod. │
80 ├───────────┼────────────────────────────┤
81 │ctr-number │ Filter by number of con‐ │
82 │ │ tainers in the pod. │
83 ├───────────┼────────────────────────────┤
84 │ctr-status │ Filter by container status │
85 │ │ within the pod. │
86 ├───────────┼────────────────────────────┤
87 │id │ Filter by pod ID. │
88 ├───────────┼────────────────────────────┤
89 │label │ Filter by container with │
90 │ │ (or without, in the case │
91 │ │ of label!=[...] is used) │
92 │ │ the specified labels. │
93 ├───────────┼────────────────────────────┤
94 │name │ Filter by pod name. │
95 ├───────────┼────────────────────────────┤
96 │network │ Filter by network name or │
97 │ │ full ID of network. │
98 ├───────────┼────────────────────────────┤
99 │status │ Filter by pod status. │
100 ├───────────┼────────────────────────────┤
101 │until │ Filter by pods created be‐ │
102 │ │ fore given timestamp. │
103 └───────────┴────────────────────────────┘
104 The ctr-ids, ctr-names, id, name filters accept regex format.
106 The ctr-status filter accepts values: created, running, paused,
109 stopped, exited, unknown.
110 The label filter accepts two formats. One is the label=key or la‐
113 bel=key=value, which removes containers with the specified labels. The
114 other format is the label!=key or label!=key=value, which removes con‐
115 tainers without the specified labels.
116 The until filter can be Unix timestamps, date formatted timestamps, or
119 Go duration strings (e.g. 10m, 1h30m) computed relative to the ma‐
120 chine’s time.
121 The status filter accepts values: stopped, running, paused, exited,
124 dead, created, degraded.
125 --format=format
128 Pretty-print containers to JSON or using a Go template
129 Valid placeholders for the Go template are listed below:
132 ┌────────────────────┬────────────────────────────┐
135 │Placeholder │ Description │
136 ├────────────────────┼────────────────────────────┤
137 │.ID │ Container ID │
138 ├────────────────────┼────────────────────────────┤
139 │.Name │ Name of pod │
140 ├────────────────────┼────────────────────────────┤
141 │.Status │ Status of pod │
142 ├────────────────────┼────────────────────────────┤
143 │.Labels │ All the labels assigned to │
144 │ │ the pod │
145 ├────────────────────┼────────────────────────────┤
146 │.NumberOfContainers │ Show the number of con‐ │
147 │ │ tainers attached to pod │
148 ├────────────────────┼────────────────────────────┤
149 │.Cgroup │ Cgroup path of pod │
150 ├────────────────────┼────────────────────────────┤
151 │.Created │ Creation time of pod │
152 ├────────────────────┼────────────────────────────┤
153 │.InfraID │ Pod infra container ID │
154 ├────────────────────┼────────────────────────────┤
155 │.Networks │ Show all networks con‐ │
156 │ │ nected to the infra con‐ │
157 │ │ tainer │
158 └────────────────────┴────────────────────────────┘
159 --help, -h
161 Print usage statement
162 --latest, -l
165 Show the latest pod created (all states) (This option is not available
166 with the remote Podman client, including Mac and Windows (excluding
167 WSL2) machines)
168 --no-trunc
171 Do not truncate the output (default false).
172 --noheading
175 Omit the table headings from the listing of pods.
176 --ns
179 Display namespace information of the pod
180 --quiet, -q
183 Print the numeric IDs of the pods only
184 --sort
187 Sort by created, ID, name, status, or number of containers
188 Default: created
191
194 $ podman pod ps
195 POD ID NAME STATUS CREATED INFRA ID # OF CONTAINERS
196 00dfd6fa02c0 jolly_goldstine Running 31 hours ago ba465ab0a3a4 1
197 f4df8692e116 nifty_torvalds Created 10 minutes ago 331693bff40a 2
198 $ podman pod ps --ctr-names
202 POD ID NAME STATUS CREATED INFRA ID NAMES
203 00dfd6fa02c0 jolly_goldstine Running 31 hours ago ba465ab0a3a4 loving_archimedes
204 f4df8692e116 nifty_torvalds Created 10 minutes ago 331693bff40a thirsty_hawking,wizardly_golick
205 $ podman pod ps --ctr-status --ctr-names --ctr-ids
209 POD ID NAME STATUS CREATED INFRA ID IDS NAMES STATUS
210 00dfd6fa02c0 jolly_goldstine Running 31 hours ago ba465ab0a3a4 ba465ab0a3a4 loving_archimedes running
211 f4df8692e116 nifty_torvalds Created 10 minutes ago 331693bff40a 331693bff40a,8e428daeb89e thirsty_hawking,wizardly_golick configured,configured
212 $ podman pod ps --format "{{.ID}} {{.ContainerNames}} {{.Cgroup}}"
216 00dfd6fa02c0 loving_archimedes /libpod_parent
217 f4df8692e116 thirsty_hawking,wizardly_golick /libpod_parent
218 $ podman pod ps --sort id --filter ctr-number=2
222 POD ID NAME STATUS CREATED INFRA ID # OF CONTAINERS
223 f4df8692e116 nifty_torvalds Created 10 minutes ago 331693bff40a 2
224 $ podman pod ps --ctr-ids
228 POD ID NAME STATUS CREATED INFRA ID IDS
229 00dfd6fa02c0 jolly_goldstine Running 31 hours ago ba465ab0a3a4 ba465ab0a3a4
230 f4df8692e116 nifty_torvalds Created 10 minutes ago 331693bff40a 331693bff40a,8e428daeb89e
231 $ podman pod ps --no-trunc --ctr-ids
235 POD ID NAME STATUS CREATED INFRA ID IDS
236 00dfd6fa02c0a2daaedfdf8fcecd06f22ad114d46d167d71777224735f701866 jolly_goldstine Running 31 hours ago ba465ab0a3a4e15e3539a1e79c32d1213a02b0989371e274f98e0f1ae9de7050 ba465ab0a3a4e15e3539a1e79c32d1213a02b0989371e274f98e0f1ae9de7050
237 f4df8692e116a3e6d1d62572644ed36ca475d933808cc3c93435c45aa139314b nifty_torvalds Created 10 minutes ago 331693bff40a926b6d52b184e116afd15497610c378d5d4c42945dd6e33b75b0 331693bff40a926b6d52b184e116afd15497610c378d5d4c42945dd6e33b75b0,8e428daeb89e69b71e7916a13accfb87d122889442b5c05c2d99cf94a3230e9d
238 $ podman pod ps --ctr-names
242 POD ID NAME STATUS CREATED INFRA ID NAMES
243 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 ...
244
248 Print a list of pods
249
252 podman(1), podman-pod(1)
253
256 July 2018, Originally compiled by Peter Hunt pehunt@redhat.com
257 ⟨mailto:pehunt@redhat.com⟩
258 podman-pod-ps(1)()