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

     1  % podman-pod-stop(1)
     2  
     3  ## NAME
     4  podman\-pod\-stop - Stop one or more pods
     5  
     6  ## SYNOPSIS
     7  **podman pod stop** [*options*] *pod* ...
     8  
     9  ## DESCRIPTION
    10  Stop containers in one or more pods.  You may use pod IDs or names as input.
    11  
    12  ## OPTIONS
    13  
    14  #### **--all**, **-a**
    15  
    16  Stops all pods
    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, stop the last created pod. (This option is not available with the remote Podman client, including Mac and Windows (excluding WSL2) machines)
    27  
    28  #### **--pod-id-file**
    29  
    30  Read pod ID from the specified file and stop the pod.  Can be specified multiple times.
    31  
    32  #### **--time**, **-t**=*seconds*
    33  
    34  Seconds to wait before forcibly stopping the containers in the pod.
    35  
    36  ## EXAMPLE
    37  
    38  Stop a pod called *mywebserverpod*
    39  ```
    40  $ podman pod stop mywebserverpod
    41  cc8f0bea67b1a1a11aec1ecd38102a1be4b145577f21fc843c7c83b77fc28907
    42  ```
    43  
    44  Stop two pods by their short IDs.
    45  ```
    46  $ podman pod stop 490eb 3557fb
    47  490eb241aaf704d4dd2629904410fe4aa31965d9310a735f8755267f4ded1de5
    48  3557fbea6ad61569de0506fe037479bd9896603c31d3069a6677f23833916fab
    49  ```
    50  
    51  Stop the most recent pod
    52  ```
    53  $ podman pod stop --latest
    54  3557fbea6ad61569de0506fe037479bd9896603c31d3069a6677f23833916fab
    55  ```
    56  
    57  Stop all pods
    58  ```
    59  $ podman pod stop --all
    60  19456b4cd557eaf9629825113a552681a6013f8c8cad258e36ab825ef536e818
    61  3557fbea6ad61569de0506fe037479bd9896603c31d3069a6677f23833916fab
    62  490eb241aaf704d4dd2629904410fe4aa31965d9310a735f8755267f4ded1de5
    63  70c358daecf71ef9be8f62404f926080ca0133277ef7ce4f6aa2d5af6bb2d3e9
    64  cc8f0bea67b1a1a11aec1ecd38102a1be4b145577f21fc843c7c83b77fc28907
    65  ```
    66  
    67  Stop two pods via --pod-id-file
    68  ```
    69  $ podman pod stop --pod-id-file file1 --pod-id-file file2
    70  19456b4cd557eaf9629825113a552681a6013f8c8cad258e36ab825ef536e818
    71  cc8f0bea67b1a1a11aec1ecd38102a1be4b145577f21fc843c7c83b77fc28907
    72  ```
    73  
    74  Stop all pods with a timeout of 1 second.
    75  ```
    76  $ podman pod stop -a -t 1
    77  3557fbea6ad61569de0506fe037479bd9896603c31d3069a6677f23833916fab
    78  490eb241aaf704d4dd2629904410fe4aa31965d9310a735f8755267f4ded1de5
    79  70c358daecf71ef9be8f62404f926080ca0133277ef7ce4f6aa2d5af6bb2d3e9
    80  ```
    81  
    82  ## SEE ALSO
    83  **[podman(1)](podman.1.md)**, **[podman-pod(1)](podman-pod.1.md)**, **[podman-pod-start(1)](podman-pod-start.1.md)**
    84  
    85  ## HISTORY
    86  July 2018, Originally compiled by Peter Hunt <pehunt@redhat.com>