Bug 650937 - blockdev man page missing information
Summary: blockdev man page missing information
Keywords:
Status: CLOSED ERRATA
Alias: None
Product: Red Hat Enterprise Linux 5
Classification: Red Hat
Component: util-linux
Version: 5.6
Hardware: All
OS: Linux
low
low
Target Milestone: rc
: ---
Assignee: Karel Zak
QA Contact: qe-baseos-daemons
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2010-11-08 12:40 UTC by Juraj Marko
Modified: 2015-09-01 03:38 UTC (History)
3 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2012-02-21 03:20:07 UTC
Target Upstream Version:
Embargoed:


Attachments (Terms of Use)


Links
System ID Private Priority Status Summary Last Updated
Red Hat Product Errata RHSA-2012:0307 0 normal SHIPPED_LIVE Low: util-linux security, bug fix, and enhancement update 2012-02-21 07:24:56 UTC

Description Juraj Marko 2010-11-08 12:40:45 UTC
Description of problem:
There are options which are not documented within the man page.

Version-Release number of selected component (if applicable):
util-linux-2.13-0.56.el5

How reproducible:
always

Steps to Reproduce:
1. blockdev --help
2. man blockdev
3. ./compare-options.sh /sbin/blockdev

  
Actual results:
1.
# blockdev --help
Usage:
  blockdev -V
  blockdev --report [devices]
  blockdev [-v|-q] commands devices
Available commands:
	--getsz	(get size in 512-byte sectors)
	--setro	(set read-only)
	--setrw	(set read-write)
	--getro	(get read-only)
	--getss	(get sectorsize)
	--getbsz	(get blocksize)
	--setbsz BLOCKSIZE	(set blocksize)
	--getsize	(get 32-bit sector count)
	--getsize64	(get size in bytes)
	--setra READAHEAD	(set readahead)
	--getra	(get readahead)
	--flushbufs	(flush buffers)
	--rereadpt	(reread partition table)
	--rmpart PARTNO	(disable partition)
	--rmparts	(disable all partitions)

2.
# man blockdev
BLOCKDEV(8)                                                        BLOCKDEV(8)

NAME
       blockdev - call block device ioctls from the command line

SYNOPSIS
       blockdev [options] commands devices

DESCRIPTION
       The utility blockdev allows one to call block device ioctls from the command line.

OPTIONS
       -V     Print version and exit.

       -q     Be quiet.

       -v     Be verbose.

COMMANDS
       --setro
              Set read-only.

       --setrw
              Set read-write.

       --getro
              Get read-only. Print 1 if the device is read-only, 0 otherwise.

       --getss
             Print sectorsize in bytes - usually 512.  --getbsz Print blocksize in bytes.

       --setbsz N
              Set blocksize to N bytes.

       --getsize
              Print device size (in 512-byte sectors).

       --getsize64
              Print device size in bytes.

       --setra N
              Set readahead to N 512-byte sectors.

       --getra
              Print readahead (in 512-byte sectors).

       --flushbufs
              Flush buffers.

       --rereadpt
              Reread partition table.

       --rmparta N
              remove selected partition from kernel (DEPRECATED).

       --rmparts
              remove all device partitions from kernel (DEPRECATED).

                 May 2000                        BLOCKDEV(8)


3.
# ./compare-options.sh /sbin/blockdev
Program path:
	/sbin/blockdev
Man pages found:
	/usr/share/man/man8/blockdev.8.gz
The binary analysis was NOT done
Doing man page vs. usage message comparison

The program reported 19 option(s)
The man page reported 17 option(s)
16 COMMON option(s):
	--flushbufs
	--getbsz
	--getra
	--getro
	--getsize
	--getsize64
	--getss
	--rereadpt
	--rmparts
	--setbsz
	--setra
	--setro
	--setrw
	-V
	-q
	-v
3 option(s) reported by the program ONLY:
	--getsz
	--report
	--rmpart
1 option(s) reported by the man page ONLY:
	--rmparta


Expected results:
Same information in man and --help

Comment 1 RHEL Program Management 2011-05-31 14:28:35 UTC
This request was evaluated by Red Hat Product Management for
inclusion in the current release of Red Hat Enterprise Linux.
Because the affected component is not scheduled to be updated in the
current release, Red Hat is unfortunately unable to address this
request at this time. Red Hat invites you to ask your support
representative to propose this request, if appropriate and relevant,
in the next release of Red Hat Enterprise Linux.

Comment 5 errata-xmlrpc 2012-02-21 03:20:07 UTC
Since the problem described in this bug report should be
resolved in a recent advisory, it has been closed with a
resolution of ERRATA.

For information on the advisory, and where to find the updated
files, follow the link below.

If the solution does not work for you, open a new bug report.

http://rhn.redhat.com/errata/RHSA-2012-0307.html


Note You need to log in before you can comment on or make changes to this bug.