Browse code

document dirperm1 fix for #783 in known issues

Since `dirperm1` requires a more recent aufs patch than many current OS release,
we cant remove #783 completely. This documents that docker will apply `dirperm1`
automatically for systems that support it

Signed-off-by: Daniel, Dao Quang Minh <dqminh89@gmail.com>

Daniel, Dao Quang Minh authored on 2015/03/26 16:46:13
Showing 2 changed files
... ...
@@ -280,8 +280,14 @@ The cache for `RUN` instructions can be invalidated by `ADD` instructions. See
280 280
 
281 281
 - [Issue 783](https://github.com/docker/docker/issues/783) is about file
282 282
   permissions problems that can occur when using the AUFS file system. You
283
-  might notice it during an attempt to `rm` a file, for example. The issue
284
-  describes a workaround.
283
+  might notice it during an attempt to `rm` a file, for example.
284
+
285
+  For systems that have recent aufs version (i.e., `dirperm1` mount option can
286
+  be set), docker will attempt to fix the issue automatically by mounting
287
+  the layers with `dirperm1` option. More details on `dirperm1` option can be
288
+  found at [`aufs` man page](http://aufs.sourceforge.net/aufs3/man.html)
289
+
290
+  If your system doesnt have support for `dirperm1`, the issue describes a workaround.
285 291
 
286 292
 ## CMD
287 293
 
... ...
@@ -57,7 +57,14 @@ impact on users. This list will be updated as issues are resolved.
57 57
 * **Unexpected File Permissions in Containers**
58 58
 An idiosyncrasy in AUFS prevents permissions from propagating predictably
59 59
 between upper and lower layers. This can cause issues with accessing private
60
-keys, database instances, etc. For complete information and workarounds see
60
+keys, database instances, etc.
61
+
62
+For systems that have recent aufs version (i.e., `dirperm1` mount option can
63
+be set), docker will attempt to fix the issue automatically by mounting
64
+the layers with `dirperm1` option. More details on `dirperm1` option can be
65
+found at [`aufs` man page](http://aufs.sourceforge.net/aufs3/man.html)
66
+
67
+For complete information and workarounds see
61 68
 [Github Issue 783](https://github.com/docker/docker/issues/783).
62 69
 
63 70
 * **Docker Hub incompatible with Safari 8**