mirror of https://github.com/docker/cli.git
35 lines
837 B
Markdown
35 lines
837 B
Markdown
# pause
|
|
|
|
<!---MARKER_GEN_START-->
|
|
Pause all processes within one or more containers
|
|
|
|
### Aliases
|
|
|
|
`docker container pause`, `docker pause`
|
|
|
|
|
|
<!---MARKER_GEN_END-->
|
|
|
|
## 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
|
|
|
|
```console
|
|
$ docker pause my_container
|
|
```
|
|
|
|
## Related commands
|
|
|
|
* [unpause](unpause.md)
|