Browse code

Fixing the volume options doc Fixes #15896 Signed-off-by: Kai Qiang Wu(Kennan) <wkqwu@cn.ibm.com>

Kai Qiang Wu(Kennan) authored on 2015/11/12 11:23:49
Showing 4 changed files
... ...
@@ -70,7 +70,12 @@ Creates a new container.
70 70
       -u, --user=""                 Username or UID
71 71
       --ulimit=[]                   Ulimit options
72 72
       --uts=""                      UTS namespace to use
73
-      -v, --volume=[]               Bind mount a volume
73
+      -v, --volume=[]               Bind mount a volume with: [host-src:]container-dest[:<options>], where
74
+                                    options are comma delimited and selected from [rw|ro] and [z|Z].
75
+                                    The 'host-src' can either be an absolute path or a name value.
76
+                                    If 'host-src' is missing, then docker creates a new volume.
77
+                                    If neither 'rw' or 'ro' is specified then the volume is mounted
78
+                                    in read-write mode.
74 79
       --volumes-from=[]             Mount volumes from the specified container(s)
75 80
       -w, --workdir=""              Working directory inside the container
76 81
 
... ...
@@ -76,7 +76,12 @@ parent = "smn_cli"
76 76
       -u, --user=""                 Username or UID (format: <name|uid>[:<group|gid>])
77 77
       --ulimit=[]                   Ulimit options
78 78
       --uts=""                      UTS namespace to use
79
-      -v, --volume=[]               Bind mount a volume
79
+      -v, --volume=[]               Bind mount a volume with: [host-src:]container-dest[:<options>], where
80
+                                    options are comma delimited and selected from [rw|ro] and [z|Z].
81
+                                    The 'host-src' can either be an absolute path or a name value.
82
+                                    If 'host-src' is missing, then docker creates a new volume.
83
+                                    If neither 'rw' or 'ro' is specified then the volume is mounted
84
+                                    in read-write mode.
80 85
       --volumes-from=[]             Mount volumes from the specified container(s)
81 86
       -w, --workdir=""              Working directory inside the container
82 87
 
... ...
@@ -1300,9 +1300,9 @@ Similarly the operator can set the **hostname** with `-h`.
1300 1300
 
1301 1301
 ### VOLUME (shared filesystems)
1302 1302
 
1303
-    -v=[]: Create a bind mount with: [host-dir:]container-dir[:<options>], where
1303
+    -v=[]: Create a bind mount with: [host-src:]container-dest[:<options>], where
1304 1304
     options are comma delimited and selected from [rw|ro] and [z|Z].
1305
-           If 'host-dir' is missing, then docker creates a new volume.
1305
+           If 'host-src' is missing, then docker creates a new volume.
1306 1306
 		   If neither 'rw' or 'ro' is specified then the volume is mounted
1307 1307
 		   in read-write mode.
1308 1308
     --volumes-from="": Mount all volumes from the given container(s)
... ...
@@ -1317,8 +1317,8 @@ one or more `VOLUME`'s associated with an image, but only the operator
1317 1317
 can give access from one container to another (or from a container to a
1318 1318
 volume mounted on the host).
1319 1319
 
1320
-The `container-dir` must always be an absolute path such as `/src/docs`.
1321
-The `host-dir` can either be an absolute path or a `name` value. If you
1320
+The `container-dest` must always be an absolute path such as `/src/docs`.
1321
+The `host-src` can either be an absolute path or a `name` value. If you
1322 1322
 supply an absolute path for the `host-dir`, Docker bind-mounts to the path
1323 1323
 you specify. If you supply a `name`, Docker creates a named volume by that `name`.
1324 1324
 
... ...
@@ -1326,7 +1326,7 @@ A `name` value must start with start with an alphanumeric character,
1326 1326
 followed by `a-z0-9`, `_` (underscore), `.` (period) or `-` (hyphen).
1327 1327
 An absolute path starts with a `/` (forward slash).
1328 1328
 
1329
-For example, you can specify either `/foo` or `foo` for a `host-dir` value.
1329
+For example, you can specify either `/foo` or `foo` for a `host-src` value.
1330 1330
 If you supply the `/foo` value, Docker creates a bind-mount. If you supply
1331 1331
 the `foo` specification, Docker creates a named volume.
1332 1332
 
... ...
@@ -215,8 +215,10 @@ then mounting the volumes from the `dbstore` container hides the
215 215
 `/dbdata` files from the `postgres` image. The result is only the files
216 216
 from the `dbstore` container are visible.
217 217
 
218
-You can use multiple `--volumes-from` parameters to bring together multiple data
219
-volumes from multiple containers.
218
+You can use multiple `--volumes-from` parameters to combine data volumes from
219
+several containers. To find detailed information about `--volumes-from` see the
220
+[Mount volumes from container](../reference/commandline/run.md#mount-volumes-from-container-volumes-from)
221
+in the `run` command reference.
220 222
 
221 223
 You can also extend the chain by mounting the volume that came from the
222 224
 `dbstore` container in yet another container via the `db1` or `db2` containers.