github.com/olljanat/moby@v1.13.1/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  <!-- This file is maintained within the docker/docker Github
     8       repository at https://github.com/docker/docker/. Make all
     9       pull requests against that repo. If you see this file in
    10       another repository, consider it read-only there, as it will
    11       periodically be overwritten by the definitive file. Pull
    12       requests which include edits to this file in other repositories
    13       will be rejected.
    14  -->
    15  
    16  # pause
    17  
    18  ```markdown
    19  Usage:  docker pause CONTAINER [CONTAINER...]
    20  
    21  Pause all processes within one or more containers
    22  
    23  Options:
    24        --help   Print usage
    25  ```
    26  
    27  The `docker pause` command suspends all processes in the specified containers.
    28  On Linux, this uses the cgroups freezer. Traditionally, when suspending a process
    29  the `SIGSTOP` signal is used, which is observable by the process being suspended.
    30  With the cgroups freezer the process is unaware, and unable to capture,
    31  that it is being suspended, and subsequently resumed. On Windows, only Hyper-V
    32  containers can be paused.
    33  
    34  See the
    35  [cgroups freezer documentation](https://www.kernel.org/doc/Documentation/cgroup-v1/freezer-subsystem.txt)
    36  for further details.
    37  
    38  ## Related information
    39  
    40  * [unpause](unpause.md)