From: Masatake YAMATO <yamato@redhat.com>
Date: Tue, 18 Jun 2024 15:14:05 +0000 (+0900)
Subject: findmnt: (man) write about -Q,--filter option
X-Git-Tag: v2.42-start~231^2~1
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=4c91a8e14d95f11004a17e124815dbd7a558655c;p=thirdparty%2Futil-linux.git

findmnt: (man) write about -Q,--filter option

Signed-off-by: Masatake YAMATO <yamato@redhat.com>
---

diff --git a/misc-utils/findmnt.8.adoc b/misc-utils/findmnt.8.adoc
index 941eb6c2c..f29f96542 100644
--- a/misc-utils/findmnt.8.adoc
+++ b/misc-utils/findmnt.8.adoc
@@ -131,6 +131,15 @@ Print only pseudo filesystems.
 *--shadow*::
 Print only filesystems over-mounted by another filesystem.
 
+*-Q*, *--filter* _expr_::
+Print only the filesystems that meet the conditions specified by the expr.
++
+This feature is EXPERIMENTAL. See also *scols-filter*(5).
+For example, include xfs having more than 50% free space:
+____
+ findmnt -Q 'INO.USED < INO.AVAIL && FSTYPE == "xfs"'
+____
+
 *-R*, *--submounts*::
 Print recursively all submounts for the selected filesystems. The restrictions defined by options *-t*, *-O*, *-S*, *-T* and *--direction* are not applied to submounts. All submounts are always printed in tree-like order. The option enables the tree-like output format by default. This option has no effect for *--mtab* or *--fstab*.
 
@@ -243,6 +252,7 @@ mailto:kzak@redhat.com[Karel Zak]
 
 *fstab*(5),
 *mount*(8)
+*scols-filter*(5)
 
 include::man-common/bugreports.adoc[]