Browse code

re-jig the info into all the places

Docker-DCO-1.1-Signed-off-by: SvenDowideit <SvenDowideit@home.org.au> (github: SvenDowideit)

SvenDowideit authored on 2014/07/15 09:02:29
Showing 3 changed files
... ...
@@ -8,6 +8,18 @@ docker-pause - Pause all processes within a container
8 8
 **docker pause**
9 9
 CONTAINER
10 10
 
11
+# DESCRIPTION
12
+
13
+The `docker pause` command uses the cgroups freezer to suspend all processes in
14
+a container.  Traditionally when suspending a process the `SIGSTOP` signal is
15
+used, which is observable by the process being suspended. With the cgroups freezer
16
+the process is unaware, and unable to capture, that it is being suspended,
17
+and subsequently resumed.
18
+
19
+See the [cgroups freezer documentation]
20
+(https://www.kernel.org/doc/Documentation/cgroups/freezer-subsystem.txt) for
21
+further details.
22
+
11 23
 # OPTIONS
12 24
 There are no available options.
13 25
 
... ...
@@ -8,6 +8,15 @@ docker-unpause - Unpause all processes within a container
8 8
 **docker unpause**
9 9
 CONTAINER
10 10
 
11
+# DESCRIPTION
12
+
13
+The `docker unpause` command uses the cgroups freezer to un-suspend all
14
+processes in a container.
15
+
16
+See the [cgroups freezer documentation]
17
+(https://www.kernel.org/doc/Documentation/cgroups/freezer-subsystem.txt) for
18
+further details.
19
+
11 20
 # OPTIONS
12 21
 There are no available options.
13 22
 
... ...
@@ -764,14 +764,17 @@ log entry.
764 764
 
765 765
     Usage: docker pause CONTAINER
766 766
 
767
-    Pause uses the cgroups freezer to suspend all processes in a container.
768
-    Traditionally when suspending a process the SIGSTOP signal is used,
769
-    which is observable by the process being suspended. With the cgroups freezer
770
-    the process is unaware, and unable to capture, that it is being suspended,
771
-    and subsequently resumed.
767
+    Pause all processes within a container
772 768
 
773
-    For for information on the cgroups freezer see:
774
-    https://www.kernel.org/doc/Documentation/cgroups/freezer-subsystem.txt
769
+The `docker pause` command uses the cgroups freezer to suspend all processes in
770
+a container.  Traditionally when suspending a process the `SIGSTOP` signal is
771
+used, which is observable by the process being suspended. With the cgroups freezer
772
+the process is unaware, and unable to capture, that it is being suspended,
773
+and subsequently resumed.
774
+
775
+See the [cgroups freezer documentation]
776
+(https://www.kernel.org/doc/Documentation/cgroups/freezer-subsystem.txt) for
777
+further details.
775 778
 
776 779
 ## ps
777 780
 
... ...
@@ -1282,6 +1285,13 @@ them to [*Share Images via Repositories*](
1282 1282
 
1283 1283
     Resumes a paused container.
1284 1284
 
1285
+The `docker unpause` command uses the cgroups freezer to un-suspend all
1286
+processes in a container.
1287
+
1288
+See the [cgroups freezer documentation]
1289
+(https://www.kernel.org/doc/Documentation/cgroups/freezer-subsystem.txt) for
1290
+further details.
1291
+
1285 1292
 ## version
1286 1293
 
1287 1294
     Usage: docker version