Files
podman/docs/source/markdown/podman-image-exists.1.md
Daniel J Walsh 777b258a7a Fix up example description of podman-image commands
Signed-off-by: Daniel J Walsh <dwalsh@redhat.com>
2024-02-18 07:41:47 -05:00

42 lines
1001 B
Markdown

% podman-image-exists 1
## NAME
podman-image-exists - Check if an image exists in local storage
## SYNOPSIS
**podman image exists** *image*
## DESCRIPTION
**podman image exists** checks if an image exists in local storage. The **ID** or **Name**
of the image may be used as input. Podman returns an exit code
of `0` when the image is found. A `1` is returned otherwise. An exit code of `125` indicates there
was an issue accessing the local storage.
## OPTIONS
#### **--help**, **-h**
Print usage statement
## EXAMPLES
Check if an image called `webclient` exists in local storage (the image does actually exist):
```
$ podman image exists webclient
$ echo $?
0
```
Check if an image called `webbackend` exists in local storage (the image does not actually exist):
```
$ podman image exists webbackend
$ echo $?
1
```
## SEE ALSO
**[podman(1)](podman.1.md)**, **[podman-image(1)](podman-image.1.md)**
## HISTORY
November 2018, Originally compiled by Brent Baude (bbaude at redhat dot com)