1podman-pod-ps(1)()                                          podman-pod-ps(1)()
2
3
4

NAME

6       podman-pod-ps - Prints out information about pods
7
8

SYNOPSIS

10       podman pod ps [options]
11
12

DESCRIPTION

14       podman pod ps lists the pods on the system.  By default it lists:
15
16
17              • pod id
18
19              • pod name
20
21              • the time the pod was created
22
23              • number of containers attached to pod
24
25              • container id of the pod infra container
26
27              • status of pod as defined by the following table
28
29
30
31       ┌────────┬───────────────────────────────┐
32Status  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

OPTIONS

49   --ctr-ids
50       Display the container IDs
51
52
53   --ctr-names
54       Display the container names
55
56
57   --ctr-status
58       Display the container statuses
59
60
61   --filter, -f=filter
62       Provide filter values.
63
64
65       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
68
69       Supported filters:
70
71
72       ┌───────────┬────────────────────────────┐
73Filter     Description                
74       ├───────────┼────────────────────────────┤
75ctr-ids    │ Filter   by  container  ID │
76       │           │ within the pod.            │
77       ├───────────┼────────────────────────────┤
78ctr-names  │ Filter by  container  name │
79       │           │ within the pod.            │
80       ├───────────┼────────────────────────────┤
81ctr-number │ Filter  by  number of con‐ │
82       │           │ tainers in the pod.        │
83       ├───────────┼────────────────────────────┤
84ctr-status │ Filter by container status │
85       │           │ within the pod.            │
86       ├───────────┼────────────────────────────┤
87id         │ Filter by pod ID.          │
88       ├───────────┼────────────────────────────┤
89label      │ Filter  by  container with │
90       │           │ (or without, in  the  case │
91       │           │ of  label!=[...]  is used) │
92       │           │ the specified labels.      │
93       ├───────────┼────────────────────────────┤
94name       │ Filter by pod name.        │
95       ├───────────┼────────────────────────────┤
96network    │ Filter by network name  or │
97       │           │ full ID of network.        │
98       ├───────────┼────────────────────────────┤
99status     │ Filter by pod status.      │
100       ├───────────┼────────────────────────────┤
101until      │ Filter by pods created be‐ │
102       │           │ fore given timestamp.      │
103       └───────────┴────────────────────────────┘
104
105       The ctr-ids, ctr-names, id, name filters accept regex format.
106
107
108       The  ctr-status  filter  accepts  values:  created,  running,   paused,
109       stopped, exited, unknown.
110
111
112       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
117
118       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
122
123       The status filter accepts values:  stopped,  running,  paused,  exited,
124       dead, created, degraded.
125
126
127   --format=format
128       Pretty-print containers to JSON or using a Go template
129
130
131       Valid placeholders for the Go template are listed below:
132
133
134       ┌────────────────────┬────────────────────────────┐
135Placeholder         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
160   --help, -h
161       Print usage statement
162
163
164   --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
169
170   --no-trunc
171       Do not truncate the output (default false).
172
173
174   --noheading
175       Omit the table headings from the listing of pods.
176
177
178   --ns
179       Display namespace information of the pod
180
181
182   --quiet, -q
183       Print the numeric IDs of the pods only
184
185
186   --sort
187       Sort by created, ID, name, status, or number of containers
188
189
190       Default: created
191
192

EXAMPLES

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
199
200
201              $ 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
206
207
208              $ 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
213
214
215              $ podman pod ps --format "{{.ID}}  {{.ContainerNames}}  {{.Cgroup}}"
216              00dfd6fa02c0   loving_archimedes   /libpod_parent
217              f4df8692e116   thirsty_hawking,wizardly_golick   /libpod_parent
218
219
220
221              $ 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
225
226
227              $ 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
232
233
234              $ 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
239
240
241              $ 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
245
246

pod ps

248       Print a list of pods
249
250

SEE ALSO

252       podman(1), podman-pod(1)
253
254

HISTORY

256       July   2018,   Originally  compiled  by  Peter  Hunt  pehunt@redhat.com
257       ⟨mailto:pehunt@redhat.com⟩
258
259
260
261                                                            podman-pod-ps(1)()
Impressum