668dab6911
Signed-off-by: Darren Stahl <darst@microsoft.com>
Upstream-commit: f7bfe86440
Component: cli
32 lines
903 B
Markdown
32 lines
903 B
Markdown
<!--[metadata]>
|
|
+++
|
|
title = "pause"
|
|
description = "The pause command description and usage"
|
|
keywords = ["cgroups, container, suspend, SIGSTOP"]
|
|
[menu.main]
|
|
parent = "smn_cli"
|
|
+++
|
|
<![end-metadata]-->
|
|
|
|
# pause
|
|
|
|
```markdown
|
|
Usage: docker pause CONTAINER [CONTAINER...]
|
|
|
|
Pause all processes within one or more containers
|
|
|
|
Options:
|
|
--help Print usage
|
|
```
|
|
|
|
The `docker pause` command suspends all processes in a container. On Linux,
|
|
this uses the cgroups freezer. 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. On Windows, only Hyper-V
|
|
containers can be paused.
|
|
|
|
See the
|
|
[cgroups freezer documentation](https://www.kernel.org/doc/Documentation/cgroup-v1/freezer-subsystem.txt)
|
|
for further details.
|