diff --git a/docs/reference/commandline/create.md b/docs/reference/commandline/create.md
index 756b2b4099..0fbe07fbe2 100644
--- a/docs/reference/commandline/create.md
+++ b/docs/reference/commandline/create.md
@@ -126,7 +126,8 @@ Options:
-v, --volume value Bind mount a volume (default []). The format
is `[host-src:]container-dest[:]`.
The comma-delimited `options` are [rw|ro],
- [z|Z], [[r]shared|[r]slave|[r]private], and
+ [z|Z], [[r]shared|[r]slave|[r]private],
+ [delegated|cached|consistent], and
[nocopy]. The 'host-src' is an absolute path
or a name value.
--volume-driver string Optional volume driver for the container
diff --git a/docs/reference/commandline/run.md b/docs/reference/commandline/run.md
index 09d7d21c49..6a9bbd5459 100644
--- a/docs/reference/commandline/run.md
+++ b/docs/reference/commandline/run.md
@@ -137,7 +137,8 @@ Options:
-v, --volume value Bind mount a volume (default []). The format
is `[host-src:]container-dest[:]`.
The comma-delimited `options` are [rw|ro],
- [z|Z], [[r]shared|[r]slave|[r]private], and
+ [z|Z], [[r]shared|[r]slave|[r]private],
+ [delegated|cached|consistent], and
[nocopy]. The 'host-src' is an absolute path
or a name value.
--volume-driver string Optional volume driver for the container
diff --git a/docs/reference/commandline/service_create.md b/docs/reference/commandline/service_create.md
index c2af3f8725..4c72b3ac6d 100644
--- a/docs/reference/commandline/service_create.md
+++ b/docs/reference/commandline/service_create.md
@@ -320,9 +320,22 @@ volumes in a service:
+
+ consistency |
+ |
+
+ The consistency requirements for the mount; one of
+
+ - default: Equivalent to consistent.
+ - consistent: Full consistency. The container runtime and the host maintain an identical view of the mount at all times.
+ - cached: The host's view of the mount is authoritative. There may be delays before updates made on the host are visible within a container.
+ - delegated: The container runtime's view of the mount is authoritative. There may be delays before updates made in a container are are visible on the host.
+
+
+ |
+
-
#### Bind Propagation
Bind propagation refers to whether or not mounts created within a given
diff --git a/man/docker-run.1.md b/man/docker-run.1.md
index 4d35b1ec40..66c6b6704b 100644
--- a/man/docker-run.1.md
+++ b/man/docker-run.1.md
@@ -625,6 +625,7 @@ any options, the systems uses the following options:
* [rw|ro]
* [z|Z]
* [`[r]shared`|`[r]slave`|`[r]private`]
+ * [`delegated`|`cached`|`consistent`]
* [nocopy]
The `CONTAINER-DIR` must be an absolute path such as `/src/docs`. The `HOST-DIR`
@@ -642,9 +643,12 @@ You can specify multiple **-v** options to mount one or more mounts to a
container. To use these same mounts in other containers, specify the
**--volumes-from** option also.
-You can add `:ro` or `:rw` suffix to a volume to mount it read-only or
-read-write mode, respectively. By default, the volumes are mounted read-write.
-See examples.
+You can supply additional options for each bind-mount following an additional
+colon. A `:ro` or `:rw` suffix mounts a volume in read-only or read-write
+mode, respectively. By default, volumes are mounted in read-write mode.
+You can also specify the consistency requirement for the mount, either
+`:consistent` (the default), `:cached`, or `:delegated`. Multiple options are
+separated by commas, e.g. `:ro,cached`.
Labeling systems like SELinux require that proper labels are placed on volume
content mounted into a container. Without a label, the security system might
diff --git a/man/src/container/create.md b/man/src/container/create.md
index 66068ff644..e47bb38db1 100644
--- a/man/src/container/create.md
+++ b/man/src/container/create.md
@@ -23,9 +23,12 @@ You can specify multiple **-v** options to mount one or more mounts to a
container. To use these same mounts in other containers, specify the
**--volumes-from** option also.
-You can add `:ro` or `:rw` suffix to a volume to mount it read-only or
-read-write mode, respectively. By default, the volumes are mounted read-write.
-See examples.
+You can supply additional options for each bind-mount following an additional
+colon. A `:ro` or `:rw` suffix mounts a volume in read-only or read-write
+mode, respectively. By default, volumes are mounted in read-write mode.
+You can also specify the consistency requirement for the mount, either
+`:consistent` (the default), `:cached`, or `:delegated`. Multiple options are
+separated by commas, e.g. `:ro,cached`.
Labeling systems like SELinux require that proper labels are placed on volume
content mounted into a container. Without a label, the security system might