github.com/khulnasoft/cli@v0.0.0-20240402070845-01bcad7beefa/docs/reference/commandline/container_pause.md (about)

     1  # pause
     2  
     3  <!---MARKER_GEN_START-->
     4  Pause all processes within one or more containers
     5  
     6  ### Aliases
     7  
     8  `docker container pause`, `docker pause`
     9  
    10  
    11  <!---MARKER_GEN_END-->
    12  
    13  ## Description
    14  
    15  The `docker pause` command suspends all processes in the specified containers.
    16  On Linux, this uses the freezer cgroup. Traditionally, when suspending a process
    17  the `SIGSTOP` signal is used, which is observable by the process being suspended.
    18  With the freezer cgroup the process is unaware, and unable to capture,
    19  that it is being suspended, and subsequently resumed. On Windows, only Hyper-V
    20  containers can be paused.
    21  
    22  See the
    23  [freezer cgroup documentation](https://www.kernel.org/doc/Documentation/cgroup-v1/freezer-subsystem.txt)
    24  for further details.
    25  
    26  ## Examples
    27  
    28  ```console
    29  $ docker pause my_container
    30  ```
    31  
    32  ## Related commands
    33  
    34  * [unpause](unpause.md)