aboutsummaryrefslogtreecommitdiffstats
path: root/sys-utils
diff options
context:
space:
mode:
authorKarel Zak <kzak@redhat.com>2025-04-16 13:21:47 +0200
committerKarel Zak <kzak@redhat.com>2025-04-16 13:21:47 +0200
commit75c7b312bf6c046c64095988e5331eaabd1220df (patch)
tree5253332903644ce6f9ecb3758a52e13230ea86bf /sys-utils
parentefb22a49e36f8ea74e8a2c5cf6f8fa6546d153d4 (diff)
parentae19f7546ccb038966fc121e287e1a1385ba94bb (diff)
downloadutil-linux-75c7b312bf6c046c64095988e5331eaabd1220df.tar.gz
Merge branch 'PR/libmount-subdir' of https://github.com/karelzak/util-linux-work
* 'PR/libmount-subdir' of https://github.com/karelzak/util-linux-work: libmount: (subdir) support detached open_tree() (>=6.15) libmount: (subdir) restrict for real mounts only libmount: (subdir) remove unused code
Diffstat (limited to 'sys-utils')
-rw-r--r--sys-utils/mount.8.adoc4
1 files changed, 3 insertions, 1 deletions
diff --git a/sys-utils/mount.8.adoc b/sys-utils/mount.8.adoc
index bb4151225a..95998ce2ad 100644
--- a/sys-utils/mount.8.adoc
+++ b/sys-utils/mount.8.adoc
@@ -767,7 +767,9 @@ Note that *mount*(8) still sanitizes and canonicalizes the source and target pat
Do not create and mount a loop device, even if the source of the mount is a regular file.
**X-mount.subdir=**_directory_::
-Allow mounting a sub-directory of a filesystem instead of the root directory. For now, this feature is implemented by a temporary filesystem root-directory mount in an unshared namespace and then binding the sub-directory to the final mount point and unmounting the root of the filesystem. The sub-directory mount shows up atomically for the rest of the system although it is implemented by multiple *mount*(2) syscalls.
+Allow mounting a subdirectory of a filesystem instead of the root directory. This is effective only when a new instance of a filesystem is attached to the system. The option is silently ignored for operations like remount, bind mount, or move.
++
+For now, this feature is implemented by a temporary filesystem root-directory mount in an unshared namespace and then binding the sub-directory to the final mount point and unmounting the root of the filesystem. The sub-directory mount shows up atomically for the rest of the system although it is implemented by multiple *mount*(2) syscalls.
+
Note that this feature will not work in session with an unshared private mount namespace (after *unshare --mount*) on old kernels or with *mount*(8) without support for file-descriptors-based mount kernel API. In this case, you need *unshare --mount --propagation shared*.
+