Browse code

Merge pull request #26654 from thaJeztah/sync-api-docs

Synchronize API docs

Sebastiaan van Stijn authored on 2016/09/17 23:11:42
Showing 8 changed files
... ...
@@ -921,43 +921,43 @@ Attach to the container `id`
921 921
 -   **404** – no such container
922 922
 -   **500** – server error
923 923
 
924
-    **Stream details**:
924
+**Stream details**:
925 925
 
926
-    When using the TTY setting is enabled in
927
-    [`POST /containers/create`
928
-    ](#create-a-container),
929
-    the stream is the raw data from the process PTY and client's `stdin`.
930
-    When the TTY is disabled, then the stream is multiplexed to separate
931
-    `stdout` and `stderr`.
926
+When using the TTY setting is enabled in
927
+[`POST /containers/create`
928
+](#create-a-container),
929
+the stream is the raw data from the process PTY and client's `stdin`.
930
+When the TTY is disabled, then the stream is multiplexed to separate
931
+`stdout` and `stderr`.
932 932
 
933
-    The format is a **Header** and a **Payload** (frame).
933
+The format is a **Header** and a **Payload** (frame).
934 934
 
935
-    **HEADER**
935
+**HEADER**
936 936
 
937
-    The header contains the information which the stream writes (`stdout` or
938
-    `stderr`). It also contains the size of the associated frame encoded in the
939
-    last four bytes (`uint32`).
937
+The header contains the information which the stream writes (`stdout` or
938
+`stderr`). It also contains the size of the associated frame encoded in the
939
+last four bytes (`uint32`).
940 940
 
941
-    It is encoded on the first eight bytes like this:
941
+It is encoded on the first eight bytes like this:
942 942
 
943
-        header := [8]byte{STREAM_TYPE, 0, 0, 0, SIZE1, SIZE2, SIZE3, SIZE4}
943
+    header := [8]byte{STREAM_TYPE, 0, 0, 0, SIZE1, SIZE2, SIZE3, SIZE4}
944 944
 
945
-    `STREAM_TYPE` can be:
945
+`STREAM_TYPE` can be:
946 946
 
947 947
 -   0: `stdin` (is written on `stdout`)
948 948
 -   1: `stdout`
949 949
 -   2: `stderr`
950 950
 
951
-    `SIZE1, SIZE2, SIZE3, SIZE4` are the four bytes of
952
-    the `uint32` size encoded as big endian.
951
+`SIZE1, SIZE2, SIZE3, SIZE4` are the four bytes of
952
+the `uint32` size encoded as big endian.
953 953
 
954
-    **PAYLOAD**
954
+**PAYLOAD**
955 955
 
956
-    The payload is the raw stream.
956
+The payload is the raw stream.
957 957
 
958
-    **IMPLEMENTATION**
958
+**IMPLEMENTATION**
959 959
 
960
-    The simplest way to implement the Attach protocol is the following:
960
+The simplest way to implement the Attach protocol is the following:
961 961
 
962 962
     1.  Read eight bytes.
963 963
     2.  Choose `stdout` or `stderr` depending on the first byte.
... ...
@@ -1241,7 +1241,7 @@ Create an image either by pulling it from the registry or by importing it
1241 1241
 
1242 1242
 **Example request**:
1243 1243
 
1244
-    POST /images/create?fromImage=ubuntu HTTP/1.1
1244
+    POST /images/create?fromImage=busybox&tag=latest HTTP/1.1
1245 1245
 
1246 1246
 **Example response**:
1247 1247
 
... ...
@@ -1953,8 +1953,9 @@ interactive session with the `exec` command.
1953 1953
 -   **200** – no error
1954 1954
 -   **404** – no such exec instance
1955 1955
 
1956
-    **Stream details**:
1957
-    Similar to the stream behavior of `POST /containers/(id or name)/attach` API
1956
+**Stream details**:
1957
+
1958
+Similar to the stream behavior of `POST /containers/(id or name)/attach` API
1958 1959
 
1959 1960
 ### Exec Resize
1960 1961
 
... ...
@@ -958,43 +958,43 @@ Attach to the container `id`
958 958
 -   **404** – no such container
959 959
 -   **500** – server error
960 960
 
961
-    **Stream details**:
961
+**Stream details**:
962 962
 
963
-    When using the TTY setting is enabled in
964
-    [`POST /containers/create`
965
-    ](#create-a-container),
966
-    the stream is the raw data from the process PTY and client's `stdin`.
967
-    When the TTY is disabled, then the stream is multiplexed to separate
968
-    `stdout` and `stderr`.
963
+When using the TTY setting is enabled in
964
+[`POST /containers/create`
965
+](#create-a-container),
966
+the stream is the raw data from the process PTY and client's `stdin`.
967
+When the TTY is disabled, then the stream is multiplexed to separate
968
+`stdout` and `stderr`.
969 969
 
970
-    The format is a **Header** and a **Payload** (frame).
970
+The format is a **Header** and a **Payload** (frame).
971 971
 
972
-    **HEADER**
972
+**HEADER**
973 973
 
974
-    The header contains the information which the stream writes (`stdout` or
975
-    `stderr`). It also contains the size of the associated frame encoded in the
976
-    last four bytes (`uint32`).
974
+The header contains the information which the stream writes (`stdout` or
975
+`stderr`). It also contains the size of the associated frame encoded in the
976
+last four bytes (`uint32`).
977 977
 
978
-    It is encoded on the first eight bytes like this:
978
+It is encoded on the first eight bytes like this:
979 979
 
980
-        header := [8]byte{STREAM_TYPE, 0, 0, 0, SIZE1, SIZE2, SIZE3, SIZE4}
980
+    header := [8]byte{STREAM_TYPE, 0, 0, 0, SIZE1, SIZE2, SIZE3, SIZE4}
981 981
 
982
-    `STREAM_TYPE` can be:
982
+`STREAM_TYPE` can be:
983 983
 
984 984
 -   0: `stdin` (is written on `stdout`)
985 985
 -   1: `stdout`
986 986
 -   2: `stderr`
987 987
 
988
-    `SIZE1, SIZE2, SIZE3, SIZE4` are the four bytes of
989
-    the `uint32` size encoded as big endian.
988
+`SIZE1, SIZE2, SIZE3, SIZE4` are the four bytes of
989
+the `uint32` size encoded as big endian.
990 990
 
991
-    **PAYLOAD**
991
+**PAYLOAD**
992 992
 
993
-    The payload is the raw stream.
993
+The payload is the raw stream.
994 994
 
995
-    **IMPLEMENTATION**
995
+**IMPLEMENTATION**
996 996
 
997
-    The simplest way to implement the Attach protocol is the following:
997
+The simplest way to implement the Attach protocol is the following:
998 998
 
999 999
     1.  Read eight bytes.
1000 1000
     2.  Choose `stdout` or `stderr` depending on the first byte.
... ...
@@ -1285,7 +1285,7 @@ Create an image either by pulling it from the registry or by importing it
1285 1285
 
1286 1286
 **Example request**:
1287 1287
 
1288
-    POST /images/create?fromImage=ubuntu HTTP/1.1
1288
+    POST /images/create?fromImage=busybox&tag=latest HTTP/1.1
1289 1289
 
1290 1290
 **Example response**:
1291 1291
 
... ...
@@ -2031,8 +2031,9 @@ interactive session with the `exec` command.
2031 2031
 -   **200** – no error
2032 2032
 -   **404** – no such exec instance
2033 2033
 
2034
-    **Stream details**:
2035
-    Similar to the stream behavior of `POST /containers/(id or name)/attach` API
2034
+**Stream details**:
2035
+
2036
+Similar to the stream behavior of `POST /containers/(id or name)/attach` API
2036 2037
 
2037 2038
 ### Exec Resize
2038 2039
 
... ...
@@ -967,43 +967,43 @@ Attach to the container `id`
967 967
 -   **404** – no such container
968 968
 -   **500** – server error
969 969
 
970
-    **Stream details**:
970
+**Stream details**:
971 971
 
972
-    When using the TTY setting is enabled in
973
-    [`POST /containers/create`
974
-    ](#create-a-container),
975
-    the stream is the raw data from the process PTY and client's `stdin`.
976
-    When the TTY is disabled, then the stream is multiplexed to separate
977
-    `stdout` and `stderr`.
972
+When using the TTY setting is enabled in
973
+[`POST /containers/create`
974
+](#create-a-container),
975
+the stream is the raw data from the process PTY and client's `stdin`.
976
+When the TTY is disabled, then the stream is multiplexed to separate
977
+`stdout` and `stderr`.
978 978
 
979
-    The format is a **Header** and a **Payload** (frame).
979
+The format is a **Header** and a **Payload** (frame).
980 980
 
981
-    **HEADER**
981
+**HEADER**
982 982
 
983
-    The header contains the information which the stream writes (`stdout` or
984
-    `stderr`). It also contains the size of the associated frame encoded in the
985
-    last four bytes (`uint32`).
983
+The header contains the information which the stream writes (`stdout` or
984
+`stderr`). It also contains the size of the associated frame encoded in the
985
+last four bytes (`uint32`).
986 986
 
987
-    It is encoded on the first eight bytes like this:
987
+It is encoded on the first eight bytes like this:
988 988
 
989
-        header := [8]byte{STREAM_TYPE, 0, 0, 0, SIZE1, SIZE2, SIZE3, SIZE4}
989
+    header := [8]byte{STREAM_TYPE, 0, 0, 0, SIZE1, SIZE2, SIZE3, SIZE4}
990 990
 
991
-    `STREAM_TYPE` can be:
991
+`STREAM_TYPE` can be:
992 992
 
993 993
 -   0: `stdin` (is written on `stdout`)
994 994
 -   1: `stdout`
995 995
 -   2: `stderr`
996 996
 
997
-    `SIZE1, SIZE2, SIZE3, SIZE4` are the four bytes of
998
-    the `uint32` size encoded as big endian.
997
+`SIZE1, SIZE2, SIZE3, SIZE4` are the four bytes of
998
+the `uint32` size encoded as big endian.
999 999
 
1000
-    **PAYLOAD**
1000
+**PAYLOAD**
1001 1001
 
1002
-    The payload is the raw stream.
1002
+The payload is the raw stream.
1003 1003
 
1004
-    **IMPLEMENTATION**
1004
+**IMPLEMENTATION**
1005 1005
 
1006
-    The simplest way to implement the Attach protocol is the following:
1006
+The simplest way to implement the Attach protocol is the following:
1007 1007
 
1008 1008
     1.  Read eight bytes.
1009 1009
     2.  Choose `stdout` or `stderr` depending on the first byte.
... ...
@@ -1437,7 +1437,7 @@ Create an image either by pulling it from the registry or by importing it
1437 1437
 
1438 1438
 **Example request**:
1439 1439
 
1440
-    POST /images/create?fromImage=ubuntu HTTP/1.1
1440
+    POST /images/create?fromImage=busybox&tag=latest HTTP/1.1
1441 1441
 
1442 1442
 **Example response**:
1443 1443
 
... ...
@@ -2184,8 +2184,9 @@ interactive session with the `exec` command.
2184 2184
 -   **200** – no error
2185 2185
 -   **404** – no such exec instance
2186 2186
 
2187
-    **Stream details**:
2188
-    Similar to the stream behavior of `POST /containers/(id or name)/attach` API
2187
+**Stream details**:
2188
+
2189
+Similar to the stream behavior of `POST /containers/(id or name)/attach` API
2189 2190
 
2190 2191
 ### Exec Resize
2191 2192
 
... ...
@@ -1045,43 +1045,43 @@ Attach to the container `id`
1045 1045
 -   **404** – no such container
1046 1046
 -   **500** – server error
1047 1047
 
1048
-    **Stream details**:
1048
+**Stream details**:
1049 1049
 
1050
-    When using the TTY setting is enabled in
1051
-    [`POST /containers/create`
1052
-    ](#create-a-container),
1053
-    the stream is the raw data from the process PTY and client's `stdin`.
1054
-    When the TTY is disabled, then the stream is multiplexed to separate
1055
-    `stdout` and `stderr`.
1050
+When using the TTY setting is enabled in
1051
+[`POST /containers/create`
1052
+](#create-a-container),
1053
+the stream is the raw data from the process PTY and client's `stdin`.
1054
+When the TTY is disabled, then the stream is multiplexed to separate
1055
+`stdout` and `stderr`.
1056 1056
 
1057
-    The format is a **Header** and a **Payload** (frame).
1057
+The format is a **Header** and a **Payload** (frame).
1058 1058
 
1059
-    **HEADER**
1059
+**HEADER**
1060 1060
 
1061
-    The header contains the information which the stream writes (`stdout` or
1062
-    `stderr`). It also contains the size of the associated frame encoded in the
1063
-    last four bytes (`uint32`).
1061
+The header contains the information which the stream writes (`stdout` or
1062
+`stderr`). It also contains the size of the associated frame encoded in the
1063
+last four bytes (`uint32`).
1064 1064
 
1065
-    It is encoded on the first eight bytes like this:
1065
+It is encoded on the first eight bytes like this:
1066 1066
 
1067
-        header := [8]byte{STREAM_TYPE, 0, 0, 0, SIZE1, SIZE2, SIZE3, SIZE4}
1067
+    header := [8]byte{STREAM_TYPE, 0, 0, 0, SIZE1, SIZE2, SIZE3, SIZE4}
1068 1068
 
1069
-    `STREAM_TYPE` can be:
1069
+`STREAM_TYPE` can be:
1070 1070
 
1071 1071
 -   0: `stdin` (is written on `stdout`)
1072 1072
 -   1: `stdout`
1073 1073
 -   2: `stderr`
1074 1074
 
1075
-    `SIZE1, SIZE2, SIZE3, SIZE4` are the four bytes of
1076
-    the `uint32` size encoded as big endian.
1075
+`SIZE1, SIZE2, SIZE3, SIZE4` are the four bytes of
1076
+the `uint32` size encoded as big endian.
1077 1077
 
1078
-    **PAYLOAD**
1078
+**PAYLOAD**
1079 1079
 
1080
-    The payload is the raw stream.
1080
+The payload is the raw stream.
1081 1081
 
1082
-    **IMPLEMENTATION**
1082
+**IMPLEMENTATION**
1083 1083
 
1084
-    The simplest way to implement the Attach protocol is the following:
1084
+The simplest way to implement the Attach protocol is the following:
1085 1085
 
1086 1086
     1.  Read eight bytes.
1087 1087
     2.  Choose `stdout` or `stderr` depending on the first byte.
... ...
@@ -1521,7 +1521,7 @@ Create an image either by pulling it from the registry or by importing it
1521 1521
 
1522 1522
 **Example request**:
1523 1523
 
1524
-    POST /images/create?fromImage=ubuntu HTTP/1.1
1524
+    POST /images/create?fromImage=busybox&tag=latest HTTP/1.1
1525 1525
 
1526 1526
 **Example response**:
1527 1527
 
... ...
@@ -2338,8 +2338,9 @@ interactive session with the `exec` command.
2338 2338
 -   **404** – no such exec instance
2339 2339
 -   **409** - container is paused
2340 2340
 
2341
-    **Stream details**:
2342
-    Similar to the stream behavior of `POST /containers/(id or name)/attach` API
2341
+**Stream details**:
2342
+
2343
+Similar to the stream behavior of `POST /containers/(id or name)/attach` API
2343 2344
 
2344 2345
 ### Exec Resize
2345 2346
 
... ...
@@ -1219,43 +1219,43 @@ Attach to the container `id`
1219 1219
 -   **409** - container is paused
1220 1220
 -   **500** – server error
1221 1221
 
1222
-    **Stream details**:
1222
+**Stream details**:
1223 1223
 
1224
-    When using the TTY setting is enabled in
1225
-    [`POST /containers/create`
1226
-    ](#create-a-container),
1227
-    the stream is the raw data from the process PTY and client's `stdin`.
1228
-    When the TTY is disabled, then the stream is multiplexed to separate
1229
-    `stdout` and `stderr`.
1224
+When using the TTY setting is enabled in
1225
+[`POST /containers/create`
1226
+](#create-a-container),
1227
+the stream is the raw data from the process PTY and client's `stdin`.
1228
+When the TTY is disabled, then the stream is multiplexed to separate
1229
+`stdout` and `stderr`.
1230 1230
 
1231
-    The format is a **Header** and a **Payload** (frame).
1231
+The format is a **Header** and a **Payload** (frame).
1232 1232
 
1233
-    **HEADER**
1233
+**HEADER**
1234 1234
 
1235
-    The header contains the information which the stream writes (`stdout` or
1236
-    `stderr`). It also contains the size of the associated frame encoded in the
1237
-    last four bytes (`uint32`).
1235
+The header contains the information which the stream writes (`stdout` or
1236
+`stderr`). It also contains the size of the associated frame encoded in the
1237
+last four bytes (`uint32`).
1238 1238
 
1239
-    It is encoded on the first eight bytes like this:
1239
+It is encoded on the first eight bytes like this:
1240 1240
 
1241
-        header := [8]byte{STREAM_TYPE, 0, 0, 0, SIZE1, SIZE2, SIZE3, SIZE4}
1241
+    header := [8]byte{STREAM_TYPE, 0, 0, 0, SIZE1, SIZE2, SIZE3, SIZE4}
1242 1242
 
1243
-    `STREAM_TYPE` can be:
1243
+`STREAM_TYPE` can be:
1244 1244
 
1245 1245
 -   0: `stdin` (is written on `stdout`)
1246 1246
 -   1: `stdout`
1247 1247
 -   2: `stderr`
1248 1248
 
1249
-    `SIZE1, SIZE2, SIZE3, SIZE4` are the four bytes of
1250
-    the `uint32` size encoded as big endian.
1249
+`SIZE1, SIZE2, SIZE3, SIZE4` are the four bytes of
1250
+the `uint32` size encoded as big endian.
1251 1251
 
1252
-    **PAYLOAD**
1252
+**PAYLOAD**
1253 1253
 
1254
-    The payload is the raw stream.
1254
+The payload is the raw stream.
1255 1255
 
1256
-    **IMPLEMENTATION**
1256
+**IMPLEMENTATION**
1257 1257
 
1258
-    The simplest way to implement the Attach protocol is the following:
1258
+The simplest way to implement the Attach protocol is the following:
1259 1259
 
1260 1260
     1.  Read eight bytes.
1261 1261
     2.  Choose `stdout` or `stderr` depending on the first byte.
... ...
@@ -1699,7 +1699,7 @@ Create an image either by pulling it from the registry or by importing it
1699 1699
 
1700 1700
 **Example request**:
1701 1701
 
1702
-    POST /images/create?fromImage=ubuntu HTTP/1.1
1702
+    POST /images/create?fromImage=busybox&tag=latest HTTP/1.1
1703 1703
 
1704 1704
 **Example response**:
1705 1705
 
... ...
@@ -2731,8 +2731,9 @@ interactive session with the `exec` command.
2731 2731
 -   **404** – no such exec instance
2732 2732
 -   **409** - container is paused
2733 2733
 
2734
-    **Stream details**:
2735
-    Similar to the stream behavior of `POST /containers/(id or name)/attach` API
2734
+**Stream details**:
2735
+
2736
+Similar to the stream behavior of `POST /containers/(id or name)/attach` API
2736 2737
 
2737 2738
 ### Exec Resize
2738 2739
 
... ...
@@ -1252,43 +1252,43 @@ Attach to the container `id`
1252 1252
 -   **409** - container is paused
1253 1253
 -   **500** – server error
1254 1254
 
1255
-    **Stream details**:
1255
+**Stream details**:
1256 1256
 
1257
-    When using the TTY setting is enabled in
1258
-    [`POST /containers/create`
1259
-    ](#create-a-container),
1260
-    the stream is the raw data from the process PTY and client's `stdin`.
1261
-    When the TTY is disabled, then the stream is multiplexed to separate
1262
-    `stdout` and `stderr`.
1257
+When using the TTY setting is enabled in
1258
+[`POST /containers/create`
1259
+](#create-a-container),
1260
+the stream is the raw data from the process PTY and client's `stdin`.
1261
+When the TTY is disabled, then the stream is multiplexed to separate
1262
+`stdout` and `stderr`.
1263 1263
 
1264
-    The format is a **Header** and a **Payload** (frame).
1264
+The format is a **Header** and a **Payload** (frame).
1265 1265
 
1266
-    **HEADER**
1266
+**HEADER**
1267 1267
 
1268
-    The header contains the information which the stream writes (`stdout` or
1269
-    `stderr`). It also contains the size of the associated frame encoded in the
1270
-    last four bytes (`uint32`).
1268
+The header contains the information which the stream writes (`stdout` or
1269
+`stderr`). It also contains the size of the associated frame encoded in the
1270
+last four bytes (`uint32`).
1271 1271
 
1272
-    It is encoded on the first eight bytes like this:
1272
+It is encoded on the first eight bytes like this:
1273 1273
 
1274
-        header := [8]byte{STREAM_TYPE, 0, 0, 0, SIZE1, SIZE2, SIZE3, SIZE4}
1274
+    header := [8]byte{STREAM_TYPE, 0, 0, 0, SIZE1, SIZE2, SIZE3, SIZE4}
1275 1275
 
1276
-    `STREAM_TYPE` can be:
1276
+`STREAM_TYPE` can be:
1277 1277
 
1278 1278
 -   0: `stdin` (is written on `stdout`)
1279 1279
 -   1: `stdout`
1280 1280
 -   2: `stderr`
1281 1281
 
1282
-    `SIZE1, SIZE2, SIZE3, SIZE4` are the four bytes of
1283
-    the `uint32` size encoded as big endian.
1282
+`SIZE1, SIZE2, SIZE3, SIZE4` are the four bytes of
1283
+the `uint32` size encoded as big endian.
1284 1284
 
1285
-    **PAYLOAD**
1285
+**PAYLOAD**
1286 1286
 
1287
-    The payload is the raw stream.
1287
+The payload is the raw stream.
1288 1288
 
1289
-    **IMPLEMENTATION**
1289
+**IMPLEMENTATION**
1290 1290
 
1291
-    The simplest way to implement the Attach protocol is the following:
1291
+The simplest way to implement the Attach protocol is the following:
1292 1292
 
1293 1293
     1.  Read eight bytes.
1294 1294
     2.  Choose `stdout` or `stderr` depending on the first byte.
... ...
@@ -1733,7 +1733,7 @@ Create an image either by pulling it from the registry or by importing it
1733 1733
 
1734 1734
 **Example request**:
1735 1735
 
1736
-    POST /images/create?fromImage=ubuntu HTTP/1.1
1736
+    POST /images/create?fromImage=busybox&tag=latest HTTP/1.1
1737 1737
 
1738 1738
 **Example response**:
1739 1739
 
... ...
@@ -2279,7 +2279,7 @@ Show the docker version information
2279 2279
     Content-Type: application/json
2280 2280
 
2281 2281
     {
2282
-         "Version": "1.10.0",
2282
+         "Version": "1.11.0",
2283 2283
          "Os": "linux",
2284 2284
          "KernelVersion": "3.19.0-23-generic",
2285 2285
          "GoVersion": "go1.4.2",
... ...
@@ -2805,8 +2805,9 @@ interactive session with the `exec` command.
2805 2805
 -   **404** – no such exec instance
2806 2806
 -   **409** - container is paused
2807 2807
 
2808
-    **Stream details**:
2809
-    Similar to the stream behavior of `POST /containers/(id or name)/attach` API
2808
+**Stream details**:
2809
+
2810
+Similar to the stream behavior of `POST /containers/(id or name)/attach` API
2810 2811
 
2811 2812
 ### Exec Resize
2812 2813
 
... ...
@@ -1281,43 +1281,43 @@ Attach to the container `id`
1281 1281
 -   **409** - container is paused
1282 1282
 -   **500** – server error
1283 1283
 
1284
-    **Stream details**:
1284
+**Stream details**:
1285 1285
 
1286
-    When using the TTY setting is enabled in
1287
-    [`POST /containers/create`
1288
-    ](#create-a-container),
1289
-    the stream is the raw data from the process PTY and client's `stdin`.
1290
-    When the TTY is disabled, then the stream is multiplexed to separate
1291
-    `stdout` and `stderr`.
1286
+When using the TTY setting is enabled in
1287
+[`POST /containers/create`
1288
+](#create-a-container),
1289
+the stream is the raw data from the process PTY and client's `stdin`.
1290
+When the TTY is disabled, then the stream is multiplexed to separate
1291
+`stdout` and `stderr`.
1292 1292
 
1293
-    The format is a **Header** and a **Payload** (frame).
1293
+The format is a **Header** and a **Payload** (frame).
1294 1294
 
1295
-    **HEADER**
1295
+**HEADER**
1296 1296
 
1297
-    The header contains the information which the stream writes (`stdout` or
1298
-    `stderr`). It also contains the size of the associated frame encoded in the
1299
-    last four bytes (`uint32`).
1297
+The header contains the information which the stream writes (`stdout` or
1298
+`stderr`). It also contains the size of the associated frame encoded in the
1299
+last four bytes (`uint32`).
1300 1300
 
1301
-    It is encoded on the first eight bytes like this:
1301
+It is encoded on the first eight bytes like this:
1302 1302
 
1303
-        header := [8]byte{STREAM_TYPE, 0, 0, 0, SIZE1, SIZE2, SIZE3, SIZE4}
1303
+    header := [8]byte{STREAM_TYPE, 0, 0, 0, SIZE1, SIZE2, SIZE3, SIZE4}
1304 1304
 
1305
-    `STREAM_TYPE` can be:
1305
+`STREAM_TYPE` can be:
1306 1306
 
1307 1307
 -   0: `stdin` (is written on `stdout`)
1308 1308
 -   1: `stdout`
1309 1309
 -   2: `stderr`
1310 1310
 
1311
-    `SIZE1, SIZE2, SIZE3, SIZE4` are the four bytes of
1312
-    the `uint32` size encoded as big endian.
1311
+`SIZE1, SIZE2, SIZE3, SIZE4` are the four bytes of
1312
+the `uint32` size encoded as big endian.
1313 1313
 
1314
-    **PAYLOAD**
1314
+**PAYLOAD**
1315 1315
 
1316
-    The payload is the raw stream.
1316
+The payload is the raw stream.
1317 1317
 
1318
-    **IMPLEMENTATION**
1318
+**IMPLEMENTATION**
1319 1319
 
1320
-    The simplest way to implement the Attach protocol is the following:
1320
+The simplest way to implement the Attach protocol is the following:
1321 1321
 
1322 1322
     1.  Read eight bytes.
1323 1323
     2.  Choose `stdout` or `stderr` depending on the first byte.
... ...
@@ -1734,7 +1734,7 @@ Create an image either by pulling it from the registry or by importing it
1734 1734
 
1735 1735
 **Example request**:
1736 1736
 
1737
-    POST /images/create?fromImage=ubuntu HTTP/1.1
1737
+    POST /images/create?fromImage=busybox&tag=latest HTTP/1.1
1738 1738
 
1739 1739
 **Example response**:
1740 1740
 
... ...
@@ -2819,8 +2819,9 @@ interactive session with the `exec` command.
2819 2819
 -   **404** – no such exec instance
2820 2820
 -   **409** - container is paused
2821 2821
 
2822
-    **Stream details**:
2823
-    Similar to the stream behavior of `POST /containers/(id or name)/attach` API
2822
+**Stream details**:
2823
+
2824
+Similar to the stream behavior of `POST /containers/(id or name)/attach` API
2824 2825
 
2825 2826
 ### Exec Resize
2826 2827
 
... ...
@@ -4008,7 +4009,7 @@ Return low-level information on the node `id`
4008 4008
 ### Remove a node
4009 4009
 
4010 4010
 
4011
-`DELETE /nodes/<id>`
4011
+`DELETE /nodes/(id)`
4012 4012
 
4013 4013
 Remove a node [`id`] from the swarm.
4014 4014
 
... ...
@@ -4036,7 +4037,7 @@ Remove a node [`id`] from the swarm.
4036 4036
 ### Update a node
4037 4037
 
4038 4038
 
4039
-`POST /nodes/<id>/update`
4039
+`POST /nodes/(id)/update`
4040 4040
 
4041 4041
 Update the node `id`.
4042 4042
 
... ...
@@ -328,6 +328,7 @@ Create a container
328 328
              "AutoRemove": true,
329 329
              "NetworkMode": "bridge",
330 330
              "Devices": [],
331
+             "Sysctls": { "net.ipv4.ip_forward": "1" },
331 332
              "Ulimits": [{}],
332 333
              "LogConfig": { "Type": "json-file", "Config": {} },
333 334
              "SecurityOpt": [],
... ...
@@ -1325,7 +1326,7 @@ last four bytes (`uint32`).
1325 1325
 
1326 1326
 It is encoded on the first eight bytes like this:
1327 1327
 
1328
-header := [8]byte{STREAM_TYPE, 0, 0, 0, SIZE1, SIZE2, SIZE3, SIZE4}
1328
+    header := [8]byte{STREAM_TYPE, 0, 0, 0, SIZE1, SIZE2, SIZE3, SIZE4}
1329 1329
 
1330 1330
 `STREAM_TYPE` can be:
1331 1331
 
... ...
@@ -2854,6 +2855,7 @@ interactive session with the `exec` command.
2854 2854
 -   **409** - container is paused
2855 2855
 
2856 2856
 **Stream details**:
2857
+
2857 2858
 Similar to the stream behavior of `POST /containers/(id or name)/attach` API
2858 2859
 
2859 2860
 ### Exec Resize
... ...
@@ -4202,7 +4204,7 @@ Inspect swarm
4202 4202
 
4203 4203
 `POST /swarm/init`
4204 4204
 
4205
-Initialize a new swarm
4205
+Initialize a new swarm. The body of the HTTP response includes the node ID.
4206 4206
 
4207 4207
 **Example request**:
4208 4208
 
... ...
@@ -4224,8 +4226,12 @@ Initialize a new swarm
4224 4224
 **Example response**:
4225 4225
 
4226 4226
     HTTP/1.1 200 OK
4227
-    Content-Length: 0
4228
-    Content-Type: text/plain; charset=utf-8
4227
+    Content-Length: 28
4228
+    Content-Type: application/json
4229
+    Date: Thu, 01 Sep 2016 21:49:13 GMT
4230
+    Server: Docker/1.12.0 (linux)
4231
+
4232
+    "7v2t30z9blmxuhnyo6s4cpenp"
4229 4233
 
4230 4234
 **Status codes**:
4231 4235