Blame SOURCES/0136-blkid-update-man-page-about-lsblk-and-ambivalent-pro.patch

5f5089
From d7725fb45fe8d4fcb67cb9fbc117bc1cf66fcd56 Mon Sep 17 00:00:00 2001
5f5089
From: Karel Zak <kzak@redhat.com>
5f5089
Date: Tue, 17 Oct 2017 10:44:01 +0200
5f5089
Subject: [PATCH 136/141] blkid: update man page about lsblk and ambivalent
5f5089
 probing
5f5089
5f5089
Upstream: http://github.com/karelzak/util-linux/commit/12786a901520d7b30ff75ee8727221bf8a3089cb
5f5089
Upstream: http://github.com/karelzak/util-linux/commit/27fbfef33c1f23b5448b6cee856bcb3500b33c42
5f5089
Addresses: https://bugzilla.redhat.com/show_bug.cgi?id=1501953
5f5089
Signed-off-by: Karel Zak <kzak@redhat.com>
5f5089
---
5f5089
 misc-utils/blkid.8 | 39 +++++++++++++++++++++++++++------------
5f5089
 1 file changed, 27 insertions(+), 12 deletions(-)
5f5089
5f5089
diff --git a/misc-utils/blkid.8 b/misc-utils/blkid.8
5f5089
index a974b8e99..1f12d202a 100644
5f5089
--- a/misc-utils/blkid.8
5f5089
+++ b/misc-utils/blkid.8
5f5089
@@ -61,6 +61,23 @@ library.  It can determine the type of content (e.g. filesystem or swap)
5f5089
 that a block device holds, and also the attributes (tokens, NAME=value pairs)
5f5089
 from the content metadata (e.g. LABEL or UUID fields).
5f5089
 .PP
5f5089
+.B It is recommended to use
5f5089
+.BR lsblk (8)
5f5089
+.B command to get information about block devices, or lsblk --fs to get an overview of filesystems, or
5f5089
+.BR findmnt (8)
5f5089
+.B to search in already mounted filesystems.
5f5089
+.PP
5f5089
+.RS
5f5089
+.BR lsblk (8)
5f5089
+provides more information, better control on output formatting, easy to use in
5f5089
+scripts and it does not require root permissions to get actual information.
5f5089
+.B blkid
5f5089
+reads information directly from devices and for non-root users
5f5089
+it returns cached unverified information.
5f5089
+.B blkid
5f5089
+is mostly designed for system services and to test libblkid functionality.
5f5089
+.RE
5f5089
+.PP
5f5089
 When
5f5089
 .I device
5f5089
 is specified, tokens from only this device are displayed.
5f5089
@@ -71,21 +88,19 @@ If none is given, all devices which appear in
5f5089
 .I /proc/partitions
5f5089
 are shown, if they are recognized.
5f5089
 .PP
5f5089
-Note that
5f5089
-.B blkid
5f5089
-reads information directly from devices and for non-root users
5f5089
-it returns cached unverified information.  It is better to use
5f5089
-.B lsblk --fs
5f5089
-to get a user-friendly overview of filesystems and devices.
5f5089
-.BR lsblk (8)
5f5089
-is also easy to use in scripts.
5f5089
-.B blkid
5f5089
-is mostly designed for system services and to test libblkid functionality.
5f5089
-.PP
5f5089
 .B blkid
5f5089
 has two main forms of operation: either searching for a device with a
5f5089
 specific NAME=value pair, or displaying NAME=value pairs for one or
5f5089
 more specified devices.
5f5089
+.PP
5f5089
+For security reasons
5f5089
+.B blkid
5f5089
+silently ignores all devices where the probing result is ambivalent (multiple
5f5089
+colliding filesystems are detected).  The low-level probing mode (\fB-p\fR)
5f5089
+provides more information and extra return code in this case.
5f5089
+It's recommended to use
5f5089
+.BR wipefs (8)
5f5089
+to get a detailed overview and to erase obsolete stuff (magic strings) from the device.
5f5089
 .SH OPTIONS
5f5089
 The \fIsize\fR and \fIoffset\fR arguments may be followed by the multiplicative
5f5089
 suffixes like KiB (=1024), MiB (=1024*1024), and so on for GiB, TiB, PiB, EiB, ZiB and YiB
5f5089
@@ -264,7 +279,7 @@ identified, an exit code of 2 is returned.
5f5089
 
5f5089
 For usage or other errors, an exit code of 4 is returned.
5f5089
 
5f5089
-If an ambivalent low-level probing result was detected, an exit code of 8 is
5f5089
+If an ambivalent probing result was detected by low-level probing mode (\fB\-p\fR), an exit code of 8 is
5f5089
 returned.
5f5089
 .SH CONFIGURATION FILE
5f5089
 The standard location of the
5f5089
-- 
5f5089
2.13.6
5f5089