github.com/containers/podman/v2@v2.2.2-0.20210501105131-c1e07d070c4c/docs/source/markdown/podman-pod-rm.1.md (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** will remove 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.
    11  
    12  ## OPTIONS
    13  
    14  #### **--all**, **-a**
    15  
    16  Remove all pods.  Can be used in conjunction with \-f as well.
    17  
    18  #### **--ignore**, **-i**
    19  
    20  Ignore errors when specified pods are not in the container store.  A user might
    21  have decided to manually remove a pod which would lead to a failure during the
    22  ExecStop directive of a systemd service referencing that pod.
    23  
    24  #### **--latest**, **-l**
    25  
    26  Instead of providing the pod name or ID, remove the last created pod.
    27  
    28  The latest option is not supported on the remote client.
    29  
    30  #### **--force**, **-f**
    31  
    32  Stop running containers and delete all stopped containers before removal of pod.
    33  
    34  #### **--pod-id-file**
    35  
    36  Read pod ID from the specified file and remove the pod.  Can be specified multiple times.
    37  
    38  ## EXAMPLE
    39  
    40  podman pod rm mywebserverpod
    41  
    42  podman pod rm mywebserverpod myflaskserverpod 860a4b23
    43  
    44  podman pod rm -f 860a4b23
    45  
    46  podman pod rm -f -a
    47  
    48  podman pod rm -fa
    49  
    50  podman pod rm --pod-id-file /path/to/id/file
    51  
    52  ## Exit Status
    53    **0**   All specified pods removed
    54  
    55    **1**   One of the specified pods did not exist, and no other failures
    56  
    57    **2**   One of the specified pods is attached to a container
    58  
    59    **125** The command fails for any other reason
    60  
    61  ## SEE ALSO
    62  podman-pod(1)
    63  
    64  ## HISTORY
    65  July 2018, Originally compiled by Peter Hunt <pehunt@redhat.com>