summaryrefslogtreecommitdiffstats
path: root/misc-utils/blkid.8
diff options
context:
space:
mode:
authorKarel Zak2009-10-14 02:17:27 +0200
committerKarel Zak2009-10-14 02:51:30 +0200
commit2d71a929413c7afc25a836560243881b81e922c4 (patch)
treed1183200766ccd3891fa2cd6d1f2a2e241358da6 /misc-utils/blkid.8
parentlib: import whole ismounted.c code from e2fsprogs (diff)
downloadkernel-qcow2-util-linux-2d71a929413c7afc25a836560243881b81e922c4.tar.gz
kernel-qcow2-util-linux-2d71a929413c7afc25a836560243881b81e922c4.tar.xz
kernel-qcow2-util-linux-2d71a929413c7afc25a836560243881b81e922c4.zip
blkid: add pretty output, document -L incompatibility with e2fsprogs
... sad story, I have temporary disabled pretty-output code in very early version of blkid.c in u-l-ng. (It was also in time when pretty-output was very new feature in e2fsprogs.) Unfortunately, the -L option (shortcut to "-o list") in u-l-ng version was reused for for any other functionality few months later.... this stupid thing was released in u-l-ng 2.15 and 2.16 without any negative feedback from users. It means the blkid from u-l-ng is not backwardly compatible with the original version from e2fsprogs. The -L option has a different meaning there. I'm sorry about this bug... This patch: * enable pretty-output (-o line) * add a note about incompatibility between u-l-ng and e2fsprogs to blkid.8 man page Signed-off-by: Karel Zak <kzak@redhat.com>
Diffstat (limited to 'misc-utils/blkid.8')
-rw-r--r--misc-utils/blkid.814
1 files changed, 11 insertions, 3 deletions
diff --git a/misc-utils/blkid.8 b/misc-utils/blkid.8
index 9fc83937a..9419da0f8 100644
--- a/misc-utils/blkid.8
+++ b/misc-utils/blkid.8
@@ -96,7 +96,13 @@ Look up one device that uses the label (same as: -l -o device -t
LABEL=<label>). This look up method is able to reliable use /dev/disk/by-label
udev symlinks (depends on setting in /etc/blkid.conf). Avoid to use the
symlinks directly. It is not reliable to use the symlinks without verification.
-The \fB-L\fR option is portable and works on systems with and without udev.
+The \fB-L\fR option works on systems with and without udev.
+
+Unfortunately, the original
+.B blkid(8)
+from e2fsprogs use the \fB-L\fR option as a
+synonym to the \fB-o list\fR option. For better portability use "-l -o device
+-t LABEL=<label>" and "-o list" in your scripts rather than -L option.
.TP
.B \-u " list "
Restrict probing functions to defined (comma separated) list of "usage" types.
@@ -130,10 +136,12 @@ print all tags (the default)
print the value of the tags
.TP
.B list
-print the devices in a user-friendly format
+print the devices in a user-friendly format, this output format is unsupported
+for low-level probing (\fB-p\fR)
.TP
.B device
-print the device name only
+print the device name only, this output format is always enabled for \fB-L\fR
+and \fB-U\fR options
.TP
.B udev
vol_id compatible mode; usable in udev rules