From: Karel Zak Date: Tue, 14 Jul 2026 12:48:39 +0000 (+0200) Subject: docs: findmnt: clarify that --target returns one filesystem X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=2f7845b90a9d5d3e9832afc16e9b090009619385;p=thirdparty%2Futil-linux.git 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 --- diff --git a/misc-utils/findmnt.8.adoc b/misc-utils/findmnt.8.adoc index c57435002..0c28435f9 100644 --- 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).