summaryrefslogtreecommitdiff
path: root/devdocs/docker/engine%2Freference%2Fcommandline%2Fpause%2Findex.html
blob: 27a21f98c4f8e2404af133fcd91f1b856f87031c (plain)
1
2
3
4
5
6
7
8
<h1>docker pause</h1>  <p><br></p> <p>Pause all processes within one or more containers</p> <h2 id="usage">Usage</h2> <div class="highlight"><pre class="highlight" data-language="">$ docker pause CONTAINER [CONTAINER...]
</pre></div> <h2 id="description">Description</h2> <p name="extended-description">The <code class="language-plaintext highlighter-rouge">docker pause</code> command suspends all processes in the specified containers. On Linux, this uses the freezer cgroup. Traditionally, when suspending a process the <code class="language-plaintext highlighter-rouge">SIGSTOP</code> 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.</p> <p>See the <a href="https://www.kernel.org/doc/Documentation/cgroup-v1/freezer-subsystem.txt">freezer cgroup documentation</a> for further details.</p> <p>For example uses of this command, refer to the <a href="#examples">examples section</a> below.</p>  <h2 id="examples">Examples</h2> <div class="highlight"><pre class="highlight" data-language="">$ docker pause my_container
</pre></div> <div class="_attribution">
  <p class="_attribution-p">
    &copy; 2019 Docker, Inc.<br>Licensed under the Apache License, Version 2.0.<br>Docker and the Docker logo are trademarks or registered trademarks of Docker, Inc. in the United States and/or other countries.<br>Docker, Inc. and other parties may also have trademark rights in other terms used herein.<br>
    <a href="https://docs.docker.com/engine/reference/commandline/pause/" class="_attribution-link">https://docs.docker.com/engine/reference/commandline/pause/</a>
  </p>
</div>