mirror of
https://github.com/containers/podman.git
synced 2025-05-21 17:16:22 +08:00
9d883d2032
Add an exists subcommand to podman container and podman image that allows users to verify the existence of a container or image by ID or name. The return code can be 0 (success), 1 (failed to find), or 125 (failed to work with runtime). Issue #1845 Signed-off-by: baude <bbaude@redhat.com>
41 lines
1007 B
Markdown
41 lines
1007 B
Markdown
% PODMAN(1) Podman Man Pages
|
|
% Brent Baude
|
|
% November 2018
|
|
# NAME
|
|
podman-container-exists- Check if a container exists in local storage
|
|
|
|
# SYNOPSIS
|
|
**podman container exists**
|
|
[**-h**|**--help**]
|
|
CONTAINER
|
|
|
|
# DESCRIPTION
|
|
**podman container exists** checks if a container exists in local storage. The **ID** or **Name**
|
|
of the container may be used as input. Podman will return an exit code
|
|
of `0` when the container is found. A `1` will be returned otherwise. An exit code of `125` indicates there
|
|
was an issue accessing the local storage.
|
|
|
|
## Examples ##
|
|
|
|
Check if an container called `webclient` exists in local storage (the container does actually exist).
|
|
```
|
|
$ sudo podman container exists webclient
|
|
$ echo $?
|
|
0
|
|
$
|
|
```
|
|
|
|
Check if an container called `webbackend` exists in local storage (the container does not actually exist).
|
|
```
|
|
$ sudo podman container exists webbackend
|
|
$ echo $?
|
|
1
|
|
$
|
|
```
|
|
|
|
## SEE ALSO
|
|
podman(1)
|
|
|
|
# HISTORY
|
|
November 2018, Originally compiled by Brent Baude (bbaude at redhat dot com)
|