mirror of
https://github.com/docker/cli.git
synced 2025-07-07 06:41:09 +03:00
f30bde6adb
these markdown files are not consumed directly in the docs, but only their content is included through the YAML does, so there's no need to have these comments in them Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
40 lines
957 B
Markdown
40 lines
957 B
Markdown
---
|
|
title: "pause"
|
|
description: "The pause command description and usage"
|
|
keywords: "cgroups, container, suspend, SIGSTOP"
|
|
---
|
|
|
|
# pause
|
|
|
|
```markdown
|
|
Usage: docker pause CONTAINER [CONTAINER...]
|
|
|
|
Pause all processes within one or more containers
|
|
|
|
Options:
|
|
--help Print usage
|
|
```
|
|
|
|
## Description
|
|
|
|
The `docker pause` command suspends all processes in the specified containers.
|
|
On Linux, this uses the freezer cgroup. Traditionally, when suspending a process
|
|
the `SIGSTOP` signal is used, which is observable by the process being suspended.
|
|
With the freezer cgroup 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
|
|
[freezer cgroup documentation](https://www.kernel.org/doc/Documentation/cgroup-v1/freezer-subsystem.txt)
|
|
for further details.
|
|
|
|
## Examples
|
|
|
|
```bash
|
|
$ docker pause my_container
|
|
```
|
|
|
|
## Related commands
|
|
|
|
* [unpause](unpause.md)
|