github.com/containers/podman/v5@v5.1.0-rc1/docs/source/markdown/podman-image-exists.1.md (about)

     1  % podman-image-exists 1
     2  
     3  ## NAME
     4  podman-image-exists - Check if an image exists in local storage
     5  
     6  ## SYNOPSIS
     7  **podman image exists** *image*
     8  
     9  ## DESCRIPTION
    10  **podman image exists** checks if an image exists in local storage. The **ID** or **Name**
    11  of the image may be used as input.  Podman returns an exit code
    12  of `0` when the image is found.  A `1` is returned otherwise. An exit code of `125` indicates there
    13  was an issue accessing the local storage.
    14  
    15  ## OPTIONS
    16  
    17  #### **--help**, **-h**
    18  
    19  Print usage statement
    20  
    21  ## EXAMPLES
    22  
    23  Check if an image called `webclient` exists in local storage (the image does actually exist):
    24  ```
    25  $ podman image exists webclient
    26  $ echo $?
    27  0
    28  ```
    29  
    30  Check if an image called `webbackend` exists in local storage (the image does not actually exist):
    31  ```
    32  $ podman image exists webbackend
    33  $ echo $?
    34  1
    35  ```
    36  
    37  ## SEE ALSO
    38  **[podman(1)](podman.1.md)**, **[podman-image(1)](podman-image.1.md)**
    39  
    40  ## HISTORY
    41  November 2018, Originally compiled by Brent Baude (bbaude at redhat dot com)