summaryrefslogtreecommitdiff
path: root/Documentation/filesystems/overlayfs.txt
diff options
context:
space:
mode:
authorAmir Goldstein <amir73il@gmail.com>2017-04-25 17:28:31 +0300
committerMiklos Szeredi <mszeredi@redhat.com>2017-05-05 12:38:59 +0300
commit65f2673832d4647f6d46783d8d745d2b15d090c4 (patch)
tree858adbc941fbe715299aba8dc928e517bbad541e /Documentation/filesystems/overlayfs.txt
parent5b6c9053fb38a66fd5c6177fcf5022b24767811a (diff)
downloadlinux-65f2673832d4647f6d46783d8d745d2b15d090c4.tar.xz
ovl: update documentation w.r.t. constant inode numbers
Signed-off-by: Amir Goldstein <amir73il@gmail.com> Signed-off-by: Miklos Szeredi <mszeredi@redhat.com>
Diffstat (limited to 'Documentation/filesystems/overlayfs.txt')
-rw-r--r--Documentation/filesystems/overlayfs.txt9
1 files changed, 8 insertions, 1 deletions
diff --git a/Documentation/filesystems/overlayfs.txt b/Documentation/filesystems/overlayfs.txt
index 634d03e20c2d..c9e884b52698 100644
--- a/Documentation/filesystems/overlayfs.txt
+++ b/Documentation/filesystems/overlayfs.txt
@@ -21,12 +21,19 @@ from accessing the corresponding object from the original filesystem.
This is most obvious from the 'st_dev' field returned by stat(2).
While directories will report an st_dev from the overlay-filesystem,
-all non-directory objects will report an st_dev from the lower or
+non-directory objects may report an st_dev from the lower filesystem or
upper filesystem that is providing the object. Similarly st_ino will
only be unique when combined with st_dev, and both of these can change
over the lifetime of a non-directory object. Many applications and
tools ignore these values and will not be affected.
+In the special case of all overlay layers on the same underlying
+filesystem, all objects will report an st_dev from the overlay
+filesystem and st_ino from the underlying filesystem. This will
+make the overlay mount more compliant with filesystem scanners and
+overlay objects will be distinguishable from the corresponding
+objects in the original filesystem.
+
Upper and Lower
---------------