From f36522da5ffce1205ddfd9ac84d2cfef4807a9b0 Mon Sep 17 00:00:00 2001 From: Karel Zak Date: Thu, 21 May 2015 12:37:18 +0200 Subject: [PATCH] blkid: be more precise in the man page Signed-off-by: Karel Zak --- misc-utils/blkid.8 | 14 +++++++++----- 1 file changed, 9 insertions(+), 5 deletions(-) diff --git a/misc-utils/blkid.8 b/misc-utils/blkid.8 index 7a0b45c374..0c7769065d 100644 --- a/misc-utils/blkid.8 +++ b/misc-utils/blkid.8 @@ -57,9 +57,9 @@ library. It can determine the type of content (e.g. filesystem or swap) that a block device holds, and also the attributes (tokens, NAME=value pairs) from the content metadata (e.g. LABEL or UUID fields). .PP -It is recommended to use +.B It is recommended to use .BR lsblk (8) -command to get information about block devices rather than blkid. +.B command to get information about block devices rather than blkid. .BR lsblk (8) provides more information, better control on output formatting and it does not require root permissions to get actual information. @@ -210,7 +210,10 @@ used together with the \fB-i\fR option. Switch to low-level superblock probing mode (bypassing the cache). Note that low-level probing also returns information about partition table type -(PTTYPE tag) and partitions (PART_ENTRY_* tags). +(PTTYPE tag) and partitions (PART_ENTRY_* tags). The tag names produced by +low-level probing are based on names used internally by libblkid and it may be +different than when executed without \fB-p\fR (for example PART_ENTRY_UUID= vs +PARTUUID=). .TP .BI \-s " tag" For each (specified) device, show only the tags that match @@ -262,8 +265,9 @@ Look up the device that uses this filesystem \fIuuid\fR. For more details see t .B \-V Display version number and exit. .SH "RETURN CODE" -If the specified token was found, or if any tags were shown from (specified) -devices, 0 is returned. +If the specified device or device addressed by specified token (option +\fB-t\fR) was found, an exit code 0 is returned. Note the option \fB-s\fR filters +output tags, but it does not affect return code. If the specified token was not found, or no (specified) devices could be identified, an exit code of 2 is returned. -- 2.47.2