diff options
author | Alex Xu (Hello71) <alex_y_xu@yahoo.ca> | 2021-04-27 18:31:04 -0400 |
---|---|---|
committer | Alex Xu (Hello71) <alex_y_xu@yahoo.ca> | 2021-04-27 18:32:58 -0400 |
commit | 91356e1cee5329a898d79d45ee01a9c2fc208a3d (patch) | |
tree | ab64f3ea52e269fe27842051071d8458ce6266c6 | |
parent | 524152fc68617727be4a663160de80f3ebe7cef3 (diff) | |
download | tmpoverlay-91356e1cee5329a898d79d45ee01a9c2fc208a3d.tar.xz tmpoverlay-91356e1cee5329a898d79d45ee01a9c2fc208a3d.zip |
update README
-rw-r--r-- | README.rst | 19 |
1 files changed, 17 insertions, 2 deletions
@@ -17,8 +17,8 @@ Benefits over manually calling ``mkdir /tmp/x; mount ...`` - synchronizes owner, permissions, and xattrs (including lowerdir ACL) - autodetects optimization flags (redirect_dir, metacopy, index, volatile) -Overmounting notes ------------------- +Overmounting +------------ Like any other Linux mount, an overlayfs mount only affects new directory lookups. If a process has its current directory or has files open inside the @@ -31,6 +31,21 @@ tmpoverlay to overmount ``/``. .. _pivot_root(2): https://man7.org/linux/man-pages/man2/pivot_root.2.html .. _pivot_root(8): https://man7.org/linux/man-pages/man8/pivot_root.8.html +Changes to underlying filesystems +--------------------------------- + +Per `the kernel overlayfs documentation`_, changing underlying filesystems +while the overlay is mounted is not supported. + +.. _the kernel overlayfs documentation: https://www.kernel.org/doc/html/latest/filesystems/overlayfs.html#changes-to-underlying-filesystems + +Pseudo-filesystems +------------------ + +Pseudo-filesystems like procfs and sysfs are not intended to be used with +overlayfs. Therefore, running commands like ``tmpoverlay /proc`` may have +unexpected results. + POSIX compliance ---------------- |