From f776a2354d94b3936173a028cc6ee1973e561fec Mon Sep 17 00:00:00 2001 From: Andreas Dilger Date: Sat, 19 Aug 2006 21:12:15 -0400 Subject: [PATCH] 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 --- lib/blkid/ChangeLog | 2 ++ misc/blkid.8.in | 28 +++++++--------------------- 2 files changed, 9 insertions(+), 21 deletions(-) diff --git a/lib/blkid/ChangeLog b/lib/blkid/ChangeLog index 7b8d1ed..cf46f09 100644 --- a/lib/blkid/ChangeLog +++ b/lib/blkid/ChangeLog @@ -1,5 +1,7 @@ 2006-08-19 Andreas Dilger + * 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 7050037..3257826 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 -- 1.8.3.1