ovl: document copying layers restrictions with inodes index
authorAmir Goldstein <amir73il@gmail.com>
Thu, 25 May 2017 12:08:24 +0000 (15:08 +0300)
committerMiklos Szeredi <mszeredi@redhat.com>
Tue, 4 Jul 2017 20:03:19 +0000 (22:03 +0200)
commit9412812ef54861081904f24ddaf176b957b98d40
treed238e45b0867d5508cb0bfb73c44c1fad3287306
parentcaf70cb2ba5dff85ea90f494a30075af92df13b0
ovl: document copying layers restrictions with inodes index

The inodes index feature introduces a behavior change - on mount,
upper root origin file handle is verified to match the lower root dir.
This implies that copied layers cannot be mounted with the inodes index
feature enabled, without explicitly removing the upper dir origin xattr
and the index dir.

The inodes index feature is required to support:
- Prevent breaking hardlinks on copy up
- NFS export support (upcoming)
- Overlayfs snapshots (POC)

Signed-off-by: Amir Goldstein <amir73il@gmail.com>
Signed-off-by: Miklos Szeredi <mszeredi@redhat.com>
Documentation/filesystems/overlayfs.txt