summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorYuriy Belikov <yuriybelikov1@gmail.com>2024-09-04 19:54:29 +0300
committerAmir Goldstein <amir73il@gmail.com>2024-09-08 16:36:38 +0300
commit930b7c32ea2b514fb2c37aa3d4b946d954ee7fa2 (patch)
treeab223f2d619a53a4c29fab8f9166453e8bce145d
parent7d6899fb69d25e1bc6f4700b7c1d92e6b608593d (diff)
downloadlinux-930b7c32ea2b514fb2c37aa3d4b946d954ee7fa2.tar.xz
overlayfs.rst: update metacopy section in overlayfs documentation
- Provide info about trusted.overlay.metacopy extended attribute - Minor rephrasing regarding copy-up operation with metacopy=on Signed-off-by: Yuriy Belikov <yuriybelikov1@gmail.com> Signed-off-by: Amir Goldstein <amir73il@gmail.com>
-rw-r--r--Documentation/filesystems/overlayfs.rst7
1 files changed, 5 insertions, 2 deletions
diff --git a/Documentation/filesystems/overlayfs.rst b/Documentation/filesystems/overlayfs.rst
index 165514401441..343644712340 100644
--- a/Documentation/filesystems/overlayfs.rst
+++ b/Documentation/filesystems/overlayfs.rst
@@ -367,8 +367,11 @@ Metadata only copy up
When the "metacopy" feature is enabled, overlayfs will only copy
up metadata (as opposed to whole file), when a metadata specific operation
-like chown/chmod is performed. Full file will be copied up later when
-file is opened for WRITE operation.
+like chown/chmod is performed. An upper file in this state is marked with
+"trusted.overlayfs.metacopy" xattr which indicates that the upper file
+contains no data. The data will be copied up later when file is opened for
+WRITE operation. After the lower file's data is copied up,
+the "trusted.overlayfs.metacopy" xattr is removed from the upper file.
In other words, this is delayed data copy up operation and data is copied
up when there is a need to actually modify data.