github.com/brahmaroutu/docker@v1.2.1-0.20160809185609-eb28dde01f16/docs/reference/commandline/pause.md (about)

     1  <!--[metadata]>
     2  +++
     3  title = "pause"
     4  description = "The pause command description and usage"
     5  keywords = ["cgroups, container, suspend, SIGSTOP"]
     6  [menu.main]
     7  parent = "smn_cli"
     8  +++
     9  <![end-metadata]-->
    10  
    11  # pause
    12  
    13  ```markdown
    14  Usage:  docker pause CONTAINER [CONTAINER...]
    15  
    16  Pause all processes within one or more containers
    17  
    18  Options:
    19        --help   Print usage
    20  ```
    21  
    22  The `docker pause` command uses the cgroups freezer to suspend all processes in
    23  a container. Traditionally, when suspending a process the `SIGSTOP` signal is
    24  used, which is observable by the process being suspended. With the cgroups freezer
    25  the process is unaware, and unable to capture, that it is being suspended,
    26  and subsequently resumed.
    27  
    28  See the
    29  [cgroups freezer documentation](https://www.kernel.org/doc/Documentation/cgroup-v1/freezer-subsystem.txt)
    30  for further details.