mirror of https://github.com/docker/docs.git
31 lines
796 B
Markdown
31 lines
796 B
Markdown
---
|
|
description: The pause command description and usage
|
|
keywords:
|
|
- cgroups, container, suspend, SIGSTOP
|
|
menu:
|
|
main:
|
|
parent: smn_cli
|
|
title: pause
|
|
---
|
|
|
|
# pause
|
|
|
|
```markdown
|
|
Usage: docker pause CONTAINER [CONTAINER...]
|
|
|
|
Pause all processes within one or more containers
|
|
|
|
Options:
|
|
--help Print usage
|
|
```
|
|
|
|
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/cgroup-v1/freezer-subsystem.txt)
|
|
for further details.
|