mirror of
https://github.com/containers/podman.git
synced 2025-05-31 15:42:48 +08:00
f4d0496b54
In the recent past, I met the frequent need to wait for a container to exist that, at the same time, may get removed (e.g., system tests in [1]). Add an `--ignore` option to podman-wait which will ignore errors when a specified container is missing and mark its exit code as -1. Also remove ID fields from the WaitReport. It is actually not used by callers and removing it makes the code simpler and faster. Once merged, we can go over the tests and simplify them. [1] github.com/containers/podman/pull/16852 Signed-off-by: Valentin Rothberg <vrothberg@redhat.com>
63 lines
1.5 KiB
Markdown
63 lines
1.5 KiB
Markdown
% 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 will wait on each consecutively.
|
|
After all specified containers are stopped, the containers' return codes are printed
|
|
separated by newline in the same order as they were given to the command.
|
|
|
|
## OPTIONS
|
|
|
|
#### **--condition**=*state*
|
|
Condition to wait on (default "stopped")
|
|
|
|
#### **--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 "µs"), "ms", "s", "m", "h". Time unit defaults to "ms".
|
|
|
|
@@option latest
|
|
|
|
## EXAMPLES
|
|
|
|
```
|
|
$ 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
|
|
```
|
|
|
|
## SEE ALSO
|
|
**[podman(1)](podman.1.md)**
|
|
|
|
## HISTORY
|
|
September 2017, Originally compiled by Brent Baude<bbaude@redhat.com>
|