Bugzilla will be upgraded to version 5.0. The upgrade date is tentatively scheduled for 2 December 2018, pending final testing and feedback.
Bug 678407 - [RHEL 5] ipcs and ipcrm in wrong man section
[RHEL 5] ipcs and ipcrm in wrong man section
Status: CLOSED ERRATA
Product: Red Hat Enterprise Linux 5
Classification: Red Hat
Component: util-linux (Show other bugs)
5.6
All Linux
low Severity low
: rc
: ---
Assigned To: Karel Zak
qe-baseos-daemons
:
Depends On:
Blocks:
  Show dependency treegraph
 
Reported: 2011-02-17 15:38 EST by John Ruemker
Modified: 2012-02-20 22:20 EST (History)
3 users (show)

See Also:
Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of:
Environment:
Last Closed: 2012-02-20 22:20:18 EST
Type: ---
Regression: ---
Mount Type: ---
Documentation: ---
CRM:
Verified Versions:
Category: ---
oVirt Team: ---
RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: ---


Attachments (Terms of Use)


External Trackers
Tracker ID Priority Status Summary Last Updated
Red Hat Product Errata RHSA-2012:0307 normal SHIPPED_LIVE Low: util-linux security, bug fix, and enhancement update 2012-02-21 02:24:56 EST

  None (edit)
Description John Ruemker 2011-02-17 15:38:43 EST
Description of problem: The ipcs manpage states:

       The ipcs utility accepts the following options:
       [...]

       If -q, -m, or -s are specified, only information about those facilities shall be written. If none of these three are specified, information about all three shall be written subject to the following options:
       [...]         

       -a     Use all print options. (This is a shorthand notation for -b, -c, -o, -p, and -t.)

       -b     Write  information on maximum allowable size. (Maximum number of bytes in messages on queue for message queues, size of segments  for  shared  memory,  and  number  of  semaphores  in  each  set  for semaphores.)

However the -b option does not appear to be valid:

   # ipcs -b
   ipcs: invalid option -- b
   usage : ipcs -asmq -tclup 
	ipcs [-s -m -q] -i id
	ipcs -h for help.

This reference should be removed from the man page.  

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

How reproducible: Always

Steps to Reproduce:
# man ipcs
# ipcs -b

Actual results: Manpage lists an option that does not work

Expected results: Manpage lists only valid options
Comment 1 RHEL Product and Program Management 2011-05-31 10:28:21 EDT
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 3 Karel Zak 2011-10-24 13:47:33 EDT
(In reply to comment #0)
>        The ipcs utility accepts the following options:
>        [...]
> 
>        If -q, -m, or -s are specified, only information about those facilities
> shall be written. If none of these three are specified, information about all
> three shall be written subject to the following options:

This text is from POSIX ipcs(1p) from man-pages package, not from ipcs(8) from util-linux package. Try  "man 8 ipcs" and "man 1p ipcs".

The util-linux man page does not contain any information about the -b option. 

Anyway, util-linux upstream solution is to move the ipcs and ipcrm man pages from section 8 to the section 1.
Comment 6 errata-xmlrpc 2012-02-20 22:20:18 EST
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.