github.com/containers/podman/v2@v2.2.2-0.20210501105131-c1e07d070c4c/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 will return an exit code
    12  of `0` when the image is found.  A `1` will be 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  
    31  Check if an image called `webbackend` exists in local storage (the image does not actually exist).
    32  ```
    33  $ podman image exists webbackend
    34  $ echo $?
    35  1
    36  $
    37  ```
    38  
    39  ## SEE ALSO
    40  podman(1)
    41  
    42  ## HISTORY
    43  November 2018, Originally compiled by Brent Baude (bbaude at redhat dot com)