github.com/pwn-term/docker@v0.0.0-20210616085119-6e977cce2565/cli/docs/reference/commandline/pause.md (about)

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