Bug 678407 - [RHEL 5] ipcs and ipcrm in wrong man section
Summary: [RHEL 5] ipcs and ipcrm in wrong man section
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: 2011-02-17 20:38 UTC by John Ruemker
Modified: 2018-11-26 19:22 UTC (History)
3 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2012-02-21 03:20:18 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 John Ruemker 2011-02-17 20:38:43 UTC
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 Program Management 2011-05-31 14:28:21 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 3 Karel Zak 2011-10-24 17:47:33 UTC
(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-21 03:20:18 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.