2015-06-21 16:41:38 -04:00
|
|
|
<!--[metadata]>
|
|
|
|
|
+++
|
|
|
|
|
title = "pause"
|
|
|
|
|
description = "The pause command description and usage"
|
|
|
|
|
keywords = ["cgroups, container, suspend, SIGSTOP"]
|
|
|
|
|
[menu.main]
|
|
|
|
|
parent = "smn_cli"
|
|
|
|
|
+++
|
|
|
|
|
<![end-metadata]-->
|
|
|
|
|
|
|
|
|
|
# pause
|
|
|
|
|
|
2015-10-03 11:56:41 -04:00
|
|
|
Usage: docker pause [OPTIONS] CONTAINER [CONTAINER...]
|
2015-06-21 16:41:38 -04:00
|
|
|
|
|
|
|
|
Pause all processes within a container
|
|
|
|
|
|
2015-10-03 11:56:41 -04:00
|
|
|
--help=false Print usage
|
|
|
|
|
|
2015-06-21 16:41:38 -04:00
|
|
|
The `docker pause` command uses the cgroups freezer to suspend all processes in
|
|
|
|
|
a container. Traditionally, when suspending a process the `SIGSTOP` signal is
|
|
|
|
|
used, which is observable by the process being suspended. With the cgroups freezer
|
|
|
|
|
the process is unaware, and unable to capture, that it is being suspended,
|
|
|
|
|
and subsequently resumed.
|
|
|
|
|
|
|
|
|
|
See the
|
|
|
|
|
[cgroups freezer documentation](https://www.kernel.org/doc/Documentation/cgroups/freezer-subsystem.txt)
|
|
|
|
|
for further details.
|
