.nh
.TH podman-wait 1
.SH NAME
.PP
podman-wait - Wait on one or more containers to stop and print their exit codes

.SH SYNOPSIS
.PP
\fBpodman wait\fP [\fIoptions\fP] \fIcontainer\fP [...]

.PP
\fBpodman container wait\fP [\fIoptions\fP] \fIcontainer\fP [...]

.SH DESCRIPTION
.PP
Waits on one or more containers to stop.  The container can be referred to by its
name or ID.  In the case of multiple containers, Podman waits on each consecutively.
After all conditions are satisfied, the containers' return codes are printed
separated by newline in the same order as they were given to the command.  An
exit code of -1 is emitted for all conditions other than "stopped" and
"exited".

.PP
NOTE: there is an inherent race condition when waiting for containers with a
restart policy of \fBalways\fR or \fBon-failure\fR, such as those created by \fBpodman
kube play\fR\&. Such containers may be repeatedly exiting and restarting, possibly
with different exit codes, but \fBpodman wait\fR can only display and detect one.

.SH OPTIONS
.SS \fB--condition\fP=\fIstate\fP
.PP
Container state or condition to wait for.  Can be specified multiple times where at least one condition must match for the command to return.  Supported values are "configured", "created", "exited", "healthy", "initialized", "paused", "removing", "running", "stopped",  "stopping", "unhealthy".  The default condition is "stopped".

.SS \fB--help\fP, \fB-h\fP
.PP
Print usage statement

.SS \fB--ignore\fP
.PP
Ignore errors when a specified container is missing and mark its return code as -1.

.SS \fB--interval\fP, \fB-i\fP=\fIduration\fP
.PP
Time interval to wait before polling for completion. A duration string is a sequence of decimal numbers, each with optional fraction and a unit suffix, such as "300ms", "-1.5h" or "2h45m". Valid time units are "ns", "us" (or "µs"), "ms", "s", "m", "h". Time unit defaults to "ms".

.SS \fB--latest\fP, \fB-l\fP
.PP
Instead of providing the container name or ID, use the last created container.
Note: the last started container can be from other users of Podman on the host machine.
(This option is not available with the remote Podman client, including Mac and Windows
(excluding WSL2) machines)

.SH EXAMPLES
.EX
$ podman wait mywebserver
0

$ podman wait --latest
0

$ podman wait --interval 2s
0

$ podman wait 860a4b23
1

$ podman wait mywebserver myftpserver
0
125

$ podman wait --ignore does-not-exist
-1

.EE

.SH SEE ALSO
.PP
\fBpodman(1)\fP

.SH HISTORY
.PP
September 2017, Originally compiled by Brent Baudebbaude@redhat.com
\[la]mailto:bbaude@redhat.com\[ra]