github.com/containers/podman/v5@v5.1.0-rc1/docs/source/markdown/podman-pod-rm.1.md.in (about)

     1  % podman-pod-rm 1
     2  
     3  ## NAME
     4  podman\-pod\-rm - Remove one or more stopped pods and containers
     5  
     6  ## SYNOPSIS
     7  **podman pod rm** [*options*] *pod*
     8  
     9  ## DESCRIPTION
    10  **podman pod rm** removes one or more stopped pods and their containers from the host.  The pod name or ID can be used. The \-f option stops all containers and then removes them before removing the pod. If all containers added by the user are in an exited state, the pod is removed.
    11  
    12  ## OPTIONS
    13  
    14  #### **--all**, **-a**
    15  
    16  Remove all pods.  Can be used in conjunction with \-f as well.
    17  
    18  #### **--force**, **-f**
    19  
    20  Stop running containers and delete all stopped containers before removal of pod.
    21  
    22  @@option ignore
    23  
    24  @@option latest
    25  
    26  @@option pod-id-file.pod
    27  If specified, the pod-id-file is removed along with the pod.
    28  
    29  @@option time
    30  
    31  The --force option must be specified to use the --time option.
    32  
    33  ## EXAMPLE
    34  
    35  Remove pod with a given name:
    36  ```
    37  podman pod rm mywebserverpod
    38  ```
    39  
    40  Remove multiple pods with given names and/or IDs:
    41  ```
    42  podman pod rm mywebserverpod myflaskserverpod 860a4b23
    43  ```
    44  
    45  Forcefully remove pod with a given ID:
    46  ```
    47  podman pod rm -f 860a4b23
    48  ```
    49  
    50  Forcefully remove all pods:
    51  ```
    52  podman pod rm -f -a
    53  podman pod rm -fa
    54  ```
    55  
    56  Remove pod using ID specified in a given file:
    57  ```
    58  podman pod rm --pod-id-file /path/to/id/file
    59  ```
    60  
    61  ## Exit Status
    62    **0**   All specified pods removed
    63  
    64    **1**   One of the specified pods did not exist, and no other failures
    65  
    66    **2**   One of the specified pods is attached to a container
    67  
    68    **125** The command fails for any other reason
    69  
    70  ## SEE ALSO
    71  **[podman(1)](podman.1.md)**, **[podman-pod(1)](podman-pod.1.md)**
    72  
    73  ## HISTORY
    74  July 2018, Originally compiled by Peter Hunt <pehunt@redhat.com>