docs: findmnt: clarify that --target returns one filesystem

The --target option identifies the filesystem for a given path, and a
file always resides on exactly one filesystem. Document that --target
returns at most one entry and skips over-mounted entries.

Addresses: https://github.com/util-linux/util-linux/issues/4424
Signed-off-by: Karel Zak <kzak@redhat.com>

diff --git a/misc-utils/findmnt.8.adoc b/misc-utils/findmnt.8.adoc
index c57435002d9f1c37fb3d44db364f1614166da907..0c28435f9a4203793d34e6a5b483b0774f75f7d1 100644 (file)
--- a/misc-utils/findmnt.8.adoc
+++ b/misc-utils/findmnt.8.adoc
@@ -175,6 +175,8 @@ Print only filesystems that are over-mounted by another filesystem.
 
 *-T*, *--target* _path_::
 Define the mount target. If _path_ is not a mountpoint file or directory, then *findmnt* checks the _path_ elements in reverse order to get the mountpoint (this feature is supported only when searching in kernel files and unsupported for *--fstab*). It's recommended to use the option *--mountpoint* when checks of _path_ elements are unwanted and _path_ is a strictly specified mountpoint.
++
+The _path_ is always on one filesystem only, so *--target* always returns at most one filesystem entry. Over-mounted entries for the same mountpoint are skipped.
 
 *-t*, *--types* _list_::
 Limit the set of printed filesystems. More than one type may be specified in a comma-separated list. The list of filesystem types can be prefixed with *no* to specify the filesystem types on which no action should be taken. For more details see *mount*(8).