summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorAndreas Dilger <adilger@clusterfs.com>2006-08-19 21:12:15 -0400
committerTheodore Ts'o <tytso@mit.edu>2006-08-19 21:12:15 -0400
commitf776a2354d94b3936173a028cc6ee1973e561fec (patch)
tree6039365726eccbfb7212f546f60c59e65a9c76cb
parentcc6d1a9ef73a1165aa541da0ab856617f7f02fb0 (diff)
downloade2fsprogs-f776a2354d94b3936173a028cc6ee1973e561fec.tar.gz
blkid.8.in: Fix description of the -l option to be more accurate
This patch fixes the blkid.8.in description of the "-l" option. The man page gives the impression that the first match is the one that is returned. However, the blkid_find_dev_with_tag() function returns the device with the highest priority (which is good, because that is what people really want). Signed-off-by: Andreas Dilger <adilger@clusterfs.com>
-rw-r--r--lib/blkid/ChangeLog2
-rw-r--r--misc/blkid.8.in28
2 files changed, 9 insertions, 21 deletions
diff --git a/lib/blkid/ChangeLog b/lib/blkid/ChangeLog
index 7b8d1ed5..cf46f096 100644
--- a/lib/blkid/ChangeLog
+++ b/lib/blkid/ChangeLog
@@ -1,5 +1,7 @@
2006-08-19 Andreas Dilger <adilger@clusterfs.com>
+ * blkid.8.in: Make the description of the -l option more accurate.
+
* Makefile.in (clean): Avoid removing the tst_*.c files, but
instead list each of the tst_* binaries explicitly.
diff --git a/misc/blkid.8.in b/misc/blkid.8.in
index 70500374..32578264 100644
--- a/misc/blkid.8.in
+++ b/misc/blkid.8.in
@@ -64,30 +64,16 @@ scanned but not necessarily available at this time), specify
Display a usage message and exit.
.TP
.B \-l
-Look up the device that matches the search parameter specified using
+Look up one device that matches the search parameter specified using
the
.B \-t
-option, assuming that there is only one matching the search parameter.
-For a system with a large number of disks, this will be more
-efficient by avoiding the need to revalidate devices unless absolutely
-necessary. If this option is not specified,
+option. If there are multiple devices that match the specified search
+parameter, then the device with the highest priority is returned, and/or
+the first device found at a given priority. Device types in order of
+decreasing priority are Device Mapper, EVMS, LVM, MD, and finally regular
+block devices. If this option is not specified,
.B blkid
-will use a less efficient approach, which allows
-.B blkid
-to print all of the devices that match the search parameter.
-.IP
-This option is best used for tag searches such as
-.I LABEL=data_vol
-or
-.IR UUID=e280469a-d06f-4c0b-b068-44f3b576029e .
-If you want
-.B blkid
-to print all of the ext3 filesystems using a search parameter
-such as
-.IR TYPE=ext3 ,
-then this option should
-.I not
-be used.
+will print all of the devices that match the search parameter.
.TP
.B \-o
Display