From 02a8a21a26fa8fbbf54b1264dada1dcd4735c87c Mon Sep 17 00:00:00 2001
From: Karel Zak <kzak@redhat.com>
Date: Thu, 29 Jan 2009 17:56:09 +0100
Subject: [PATCH] blkid: add new options to blkid.8 and help output

Signed-off-by: Karel Zak <kzak@redhat.com>
---
 libs/blkid/bin/blkid.c |   9 ++--
 libs/blkid/blkid.8.in  | 104 ++++++++++++++++++++++++-----------------
 2 files changed, 67 insertions(+), 46 deletions(-)

diff --git a/libs/blkid/bin/blkid.c b/libs/blkid/bin/blkid.c
index f7b43a496..87ee4a9fb 100644
--- a/libs/blkid/bin/blkid.c
+++ b/libs/blkid/bin/blkid.c
@@ -56,20 +56,23 @@ static void usage(int error)
 		"Usage:\n"
 		"  %1$s [-c <file>] [-ghlLv] [-o format] [-s <tag>] \n"
 		"         [-t <token>] [-w <file>] [dev ...]\n\n"
-		"  %1$s -p [-O <offset>] [-S <size>] <dev> [dev ...]\n\n"
+		"  %1$s -p [-O <offset>] [-S <size>] [-o format] <dev> [dev ...]\n\n"
 		"Options:\n"
 		"  -c <file>   cache file (default: /etc/blkid.tab, /dev/null = none)\n"
 		"  -h          print this usage message and exit\n"
 		"  -g          garbage collect the blkid cache\n"
 		"  -o <format> output format; can be one of:\n"
 		"              value, device, list, udev or full; (default: full)\n"
-		"  -p          switch to low-probe mode (bypass cache)\n"
 		"  -s <tag>    show specified tag(s) (default show all tags)\n"
 		"  -t <token>  find device with a specific token (NAME=value pair)\n"
 		"  -l          lookup the the first device with arguments specified by -t\n"
 		"  -v          print version and exit\n"
 		"  -w <file>   write cache to different file (/dev/null = no write)\n"
-		"  <dev>       specify device(s) to probe (default: all devices)\n\n",
+		"  <dev>       specify device(s) to probe (default: all devices)\n\n"
+		"Low-level probing options:\n"
+		"  -p          switch to low-level mode (bypass cache)\n"
+		"  -S <bytes>  overwrite device size\n"
+		"  -O <bytes>  probe at the given offset\n\n"
 				progname);
 
 	exit(error);
diff --git a/libs/blkid/blkid.8.in b/libs/blkid/blkid.8.in
index 9c42686e9..e7eaf51e4 100644
--- a/libs/blkid/blkid.8.in
+++ b/libs/blkid/blkid.8.in
@@ -10,32 +10,33 @@
 blkid \- command\-line utility to locate/print block device attributes
 .SH SYNOPSIS
 .B blkid
-[
-.B \-ghlLv
-]
-[
-[
-.B \-c
-.I cachefile
-]
-.B \-w
-.I writecachefile
-]
-[
-.B \-o
-.I format
-]
-[
-.B \-s
-.I tag
-]
-[
-.B \-t
-.IR NAME = value
-]
-[
-.I device ...
-]
+.RB [ \-ghlLv ]
+.RB [ \-c
+.IR file ]
+.RB [ \-w
+.IR file ]
+.RB [ \-o
+.IR format ]
+.in +6
+.RB [ \-s
+.IR tag ]
+.RB [ \-t
+.IR NAME=value ]
+.I device
+[\fIdevice\fR ...]
+.in -6
+
+.B blkid
+.RB -p
+.RB [ \-O
+.IR offset ]
+.RB [ \-S
+.IR size ]
+.RB [ \-o
+.IR format ]
+.I device
+[\fIdevice\fR ...]
+
 .SH DESCRIPTION
 The
 .B blkid
@@ -79,25 +80,39 @@ block devices.  If this option is not specified,
 .B blkid
 will print all of the devices that match the search parameter.
 .TP
+.B \-L
+Print the devices in a user-friendly list format.  This is the
+equivalent of using the option \fB-o list\fR.
+.TP
 .BI \-o " format"
 Display
 .BR blkid 's
 output using the specified format.  The
 .I format
-parameter may be
-.I full
-(the default),
-.I value
-(only print the value of the tags),
-.I list
-(print the devices in a user-friendly format),
-or
-.I device
-(only print the device name).
+parameter may be:
+.RS
 .TP
-.B \-L
-Print the devices in a user-friendly list format.  This is the
-equivalent of using the option \fB-o list\fR.
+.B full
+print all tags (the default)
+.TP
+.B value
+print the value of the tags
+.TP
+.B list
+print the devices in a user-friendly format
+.TP
+.B device
+print the device name only
+.TP
+.B udev
+vol_id compatible mode; usable in udev rules
+.RE
+.TP
+.BI \-O " bytes"
+Probe at the given offset (only useful with \fB-p\fR).
+.TP
+.BI \-p
+Switch to low-level probing mode (bypass cache)"
 .TP
 .BI \-s " tag"
 For each (specified) device, show only the tags that match
@@ -110,6 +125,9 @@ In order to just refresh the cache without showing any tokens, use
 .B "-s none"
 with no other options.
 .TP
+.BI \-S " bytes"
+Ooverwrite device/file size (only useful with \fB-p\fR).
+.TP
 .BI \-t " NAME" = "value"
 Search for block devices with tokens named
 .I NAME
@@ -155,10 +173,10 @@ devices, 0 is returned.  If the specified token was not found, or no
 For usage or other errors, an exit code of 4 is returned.
 .SH AUTHOR
 .B blkid
-was written by Andreas Dilger for libblkid.
+was written by Andreas Dilger for libblkid and improved by Theodore Ts'o
+and Karel Zak.
 .SH AVAILABILITY
-.B blkid
-is part the e2fsprogs package since version 1.26 and is available from
-http://e2fsprogs.sourceforge.net.
+The blkid command is part of the util-linux-ng package and is available from
+ftp://ftp.kernel.org/pub/linux/utils/util-linux-ng/.
 .SH "SEE ALSO"
 .BR libblkid (3)