Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
podman-wait(1)		     General Commands Manual		  podman-wait(1)

NAME
     podman-wait  -  Wait on one or more containers to stop and print their exit
     codes

SYNOPSIS
     podman wait [options] container [...]

     podman container wait [options] container [...]

DESCRIPTION
     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  condi-
     tions other than "stopped" and "exited".

     When  waiting for containers with a restart policy of always or on-failure,
     such as those created by podman kube play, the containers may be repeatedly
     exiting and restarting, possibly with different  exit  codes.  podman  wait
     will  only  display  and  detect  the first exit after the wait command was
     started.

     When running a container with podman run --rm wait does not  wait	for  the
     container	to  be fully removed. To wait for the removal of a container use
     --condition=removing.

OPTIONS
   --condition=state
     Container state or condition to wait for.	Can be specified multiple  times
     where  at	least  one condition must match for the command to return.  Sup-
     ported values are "configured", "created", "exited",  "healthy",  "initial-
     ized",   "paused",  "removing",  "running",  "stopped",   "stopping",  "un-
     healthy".	The default condition is "stopped".

   --exit-first-match
     Wait for exit of first container which  matches  conditions,  ignore  other
     ones.

   --help, -h
     Print usage statement

   --ignore
     Ignore  errors  when  a  specified container is missing and mark its return
     code as -1.

   --interval, -i=duration
     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
     "A<micro>s"), "ms", "s", "m", "h". Time unit defaults to "ms".

   --latest, -l
     Instead  of  providing  the container name or ID, use the last created con-
     tainer.  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)

EXAMPLES
     Wait for the specified container to exit.

     $ podman wait mywebserver
     0

     Wait  for	the latest container to exit. (This option is not available with
     the remote Podman client, including Mac and Windows  (excluding  WSL2)  ma-
     chines)

     $ podman wait --latest
     0

     Wait for the container to exit, checking every two seconds.

     $ podman wait --interval 2s mywebserver
     0

     Wait for the container by ID. This container exits with error status 1:

     $ podman wait 860a4b23
     1

     Wait for both specified containers to exit.

     $ podman wait mywebserver myftpserver
     0
     125

     Wait for the named container to exit, but do not fail if the container does
     not exist.

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

SEE ALSO
     podman(1)

HISTORY
     September	 2017,	 Originally  compiled  by  Brent  Baudebbaude@redhat.com
     <mailto:bbaude@redhat.com>

								  podman-wait(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=podman-wait&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help