From: Karel Zak <kzak@redhat.com>
Date: Mon, 8 Apr 2024 08:19:56 +0000 (+0200)
Subject: findfs: (man) be more accurate in describing non-tags
X-Git-Tag: v2.42-start~441
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=07aacb371470b5561f13b95e399e5ff77e417b8f;p=thirdparty%2Futil-linux.git

findfs: (man) be more accurate in describing non-tags

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

diff --git a/libblkid/src/evaluate.c b/libblkid/src/evaluate.c
index cd2f3a377..26e556c08 100644
--- a/libblkid/src/evaluate.c
+++ b/libblkid/src/evaluate.c
@@ -224,6 +224,9 @@ static char *evaluate_by_scan(const char *token, const char *value,
  * @value: token data (e.g. "foo")
  * @cache: pointer to cache (or NULL when you don't want to re-use the cache)
  *
+* If the @value is NULL and @token is not in the NAME=value format, then return
+* a copy of the @token.
+ *
  * Returns: allocated string with a device name.
  */
 char *blkid_evaluate_tag(const char *token, const char *value, blkid_cache *cache)
diff --git a/misc-utils/findfs.8.adoc b/misc-utils/findfs.8.adoc
index 560a5bada..4ff6a14b8 100644
--- a/misc-utils/findfs.8.adoc
+++ b/misc-utils/findfs.8.adoc
@@ -32,7 +32,7 @@ Specifies partition UUID. This partition identifier is supported for example for
 *PARTLABEL*=_<label>_::
 Specifies partition label (name). The partition labels are supported for example for GUID Partition Table (GPT) or MAC partition tables.
 
-If the filesystem or partition is found, the device name will be printed on stdout.
+If the filesystem or partition is found, the device name will be printed on stdout. If the input is not in the format of NAME=value, then the input will be copied to the output without any modification.
 
 The complete overview about filesystems and partitions you can get for example by