2016-10-14 22:30:36 +00:00
|
|
|
---
|
|
|
|
title: "pause"
|
|
|
|
description: "The pause command description and usage"
|
|
|
|
keywords: ["cgroups, container, suspend, SIGSTOP"]
|
|
|
|
---
|
2015-06-21 20:41:38 +00:00
|
|
|
|
2016-10-19 17:25:45 +00:00
|
|
|
<!-- This file is maintained within the docker/docker Github
|
|
|
|
repository at https://github.com/docker/docker/. Make all
|
|
|
|
pull requests against that repo. If you see this file in
|
|
|
|
another repository, consider it read-only there, as it will
|
|
|
|
periodically be overwritten by the definitive file. Pull
|
|
|
|
requests which include edits to this file in other repositories
|
|
|
|
will be rejected.
|
|
|
|
-->
|
|
|
|
|
2015-06-21 20:41:38 +00:00
|
|
|
# pause
|
|
|
|
|
2016-07-07 18:43:18 +00:00
|
|
|
```markdown
|
|
|
|
Usage: docker pause CONTAINER [CONTAINER...]
|
2015-06-21 20:41:38 +00:00
|
|
|
|
2016-07-07 18:43:18 +00:00
|
|
|
Pause all processes within one or more containers
|
2015-06-21 20:41:38 +00:00
|
|
|
|
2016-07-07 18:43:18 +00:00
|
|
|
Options:
|
|
|
|
--help Print usage
|
|
|
|
```
|
2015-10-03 15:56:41 +00:00
|
|
|
|
2016-09-09 00:31:04 +00:00
|
|
|
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.
|
2015-06-21 20:41:38 +00:00
|
|
|
|
|
|
|
See the
|
2016-05-27 00:28:46 +00:00
|
|
|
[cgroups freezer documentation](https://www.kernel.org/doc/Documentation/cgroup-v1/freezer-subsystem.txt)
|
2015-06-21 20:41:38 +00:00
|
|
|
for further details.
|