github.com/hanks177/podman/v4@v4.1.3-0.20220613032544-16d90015bc83/docs/source/markdown/podman-pod-exists.1.md (about)

     1  % podman-pod-exists(1)
     2  
     3  ## NAME
     4  podman-pod-exists - Check if a pod exists in local storage
     5  
     6  ## SYNOPSIS
     7  **podman pod exists** *pod*
     8  
     9  ## DESCRIPTION
    10  **podman pod exists** checks if a pod exists in local storage. The **ID** or **Name**
    11  of the pod may be used as input.  Podman will return an exit code
    12  of `0` when the pod 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  ## EXAMPLES
    16  
    17  Check if a pod called `web` exists in local storage (the pod does actually exist).
    18  ```
    19  $ sudo podman pod exists web
    20  $ echo $?
    21  0
    22  $
    23  ```
    24  
    25  Check if a pod called `backend` exists in local storage (the pod does not actually exist).
    26  ```
    27  $ sudo podman pod exists backend
    28  $ echo $?
    29  1
    30  $
    31  ```
    32  
    33  ## SEE ALSO
    34  **[podman(1)](podman.1.md)**, **[podman-pod(1)](podman-pod.1.md)**
    35  
    36  ## HISTORY
    37  December 2018, Originally compiled by Brent Baude (bbaude at redhat dot com)