]> git.ipfire.org Git - thirdparty/util-linux.git/commitdiff
mount: (man) add note about symlink over symlink
authorKarel Zak <kzak@redhat.com>
Thu, 26 Sep 2024 13:56:02 +0000 (15:56 +0200)
committerKarel Zak <kzak@redhat.com>
Tue, 1 Oct 2024 12:03:38 +0000 (14:03 +0200)
Signed-off-by: Karel Zak <kzak@redhat.com>
sys-utils/mount.8.adoc

index 28a84a86c24afdee16d6691c17bb4c53b6b1e09e..15b70cc4f4a47bb5704a4006a6cbe43802f08317 100644 (file)
@@ -715,9 +715,9 @@ ____
 Allow to make a target directory (mountpoint) if it does not exist yet. The optional argument _mode_ specifies the filesystem access mode used for *mkdir*(2) in octal notation. The default mode is 0755. This functionality is supported only for root users or when *mount* is executed without suid permissions. The option is also supported as *x-mount.mkdir*, but this notation is deprecated since v2.30. See also *--mkdir* command line option.
 
 *X-mount.nocanonicalize*[=_type_]::
-Allows disabling of canonicalization for mount source and target paths. By default, the `mount` command resolves all paths to their absolute paths without symlinks. However, this behavior may not be desired in certain situations, such as when bind-mounting over a symlink. The optional argument _type_ can be either "source" or "target" (mountpoint). If no _type_ is specified, then canonicalization is disabled for both types. This mount option does not affect the conversion of source tags (e.g. LABEL= or UUID=) and fstab processing.
+Allows disabling of canonicalization for mount source and target paths. By default, the `mount` command resolves all paths to their absolute paths without symlinks. However, this behavior may not be desired in certain situations, such as when binding a mount over a symlink, or a symlink over a directory or another symlink. The optional argument _type_ can be either "source" or "target" (mountpoint). If no _type_ is specified, then canonicalization is disabled for both types. This mount option does not affect the conversion of source tags (e.g. LABEL= or UUID=) and fstab processing.
 +
-The command line option *--no-canonicalize* overrides this mount option and affects all path and tag conversions in all situations.
+The command line option *--no-canonicalize* overrides this mount option and affects all path and tag conversions in all situations, but it does not modify flags for open_tree syscalls.
 +
 Note that *mount*(8) still sanitizes and canonicalizes the source and target paths specified on the command line by non-root users, regardless of the X-mount.nocanonicalize setting.