Bug 650937
| Summary: | blockdev man page missing information | ||
|---|---|---|---|
| Product: | Red Hat Enterprise Linux 5 | Reporter: | Juraj Marko <jmarko> |
| Component: | util-linux | Assignee: | Karel Zak <kzak> |
| Status: | CLOSED ERRATA | QA Contact: | qe-baseos-daemons |
| Severity: | low | Docs Contact: | |
| Priority: | low | ||
| Version: | 5.6 | CC: | azelinka, nlevinki, rvokal |
| Target Milestone: | rc | ||
| Target Release: | --- | ||
| Hardware: | All | ||
| OS: | Linux | ||
| Whiteboard: | |||
| Fixed In Version: | Doc Type: | Bug Fix | |
| Doc Text: | Story Points: | --- | |
| Clone Of: | Environment: | ||
| Last Closed: | 2012-02-21 03:20:07 UTC | Type: | --- |
| Regression: | --- | Mount Type: | --- |
| Documentation: | --- | CRM: | |
| Verified Versions: | Category: | --- | |
| oVirt Team: | --- | RHEL 7.3 requirements from Atomic Host: | |
| Cloudforms Team: | --- | Target Upstream Version: | |
| Embargoed: | |||
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. 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 |
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