[PATCH v2] overlayfs.rst: remove mention of workdir needing to be empty

From: Jesse Van Gavere via B4 Relay

Date: Thu Jul 16 2026 - 02:25:02 EST


From: Jesse Van Gavere <jesse.vangavere@xxxxxxxxxxxx>

This requirement has not been true since v4.8 when automatic cleanup was
added in commit eea2fb4851e9 ("ovl: proper cleanup of workdir")

Signed-off-by: Jesse Van Gavere <jesse.vangavere@xxxxxxxxxxxx>
---
Changes in v2:
- Handle remark from Amir Goldstein to drop workdir cleanup reference
- Link to v1: https://patch.msgid.link/20260715-overlayfs-rst-update-v1-1-70625a67880e@xxxxxxxxxxxx

To: Miklos Szeredi <miklos@xxxxxxxxxx>
To: Amir Goldstein <amir73il@xxxxxxxxx>
To: Jonathan Corbet <corbet@xxxxxxx>
To: Shuah Khan <skhan@xxxxxxxxxxxxxxxxxxx>
Cc: linux-unionfs@xxxxxxxxxxxxxxx
Cc: linux-doc@xxxxxxxxxxxxxxx
Cc: linux-kernel@xxxxxxxxxxxxxxx
---
Documentation/filesystems/overlayfs.rst | 3 +--
1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/Documentation/filesystems/overlayfs.rst b/Documentation/filesystems/overlayfs.rst
index eb846518e6ac..ba41c0694e62 100644
--- a/Documentation/filesystems/overlayfs.rst
+++ b/Documentation/filesystems/overlayfs.rst
@@ -123,8 +123,7 @@ At mount time, the two directories given as mount options "lowerdir" and
mount -t overlay overlay -olowerdir=/lower,upperdir=/upper,\
workdir=/work /merged

-The "workdir" needs to be an empty directory on the same filesystem
-as upperdir.
+The "workdir" needs to be a directory on the same filesystem as upperdir.

Then whenever a lookup is requested in such a merged directory, the
lookup is performed in each actual directory and the combined result

---
base-commit: 58717b2a1365d06c8c64b72aa948541b53fe31eb
change-id: 20260715-overlayfs-rst-update-750d58792f79

Best regards,
--
Jesse Van Gavere <jesse.vangavere@xxxxxxxxxxxx>