Bug 156397

Summary: ipcs mans are not in sync with utility options.
Product: [openSUSE] SUSE LINUX 10.0 Reporter: Olli Artemjev <grey-olli>
Component: BasesystemAssignee: Mads Martin Joergensen <mmj>
Status: RESOLVED WONTFIX QA Contact: E-mail List <qa-bugs>
Severity: Enhancement    
Priority: P3 - Medium Keywords: documentation, UI
Version: Final   
Target Milestone: ---   
Hardware: i686   
OS: SuSE Linux 10.0   
Whiteboard:
Found By: Customer Services Priority:
Business Priority: Blocker: ---
Marketing QA Status: --- IT Deployment: ---

Description Olli Artemjev 2006-03-09 11:12:52 UTC
Manual page ipcs(1p):
------------------------------------
SYNOPSIS
       ipcs [-qms][-a | -bcopt]
------------------------------------


----------------- [ 14:13:20, root@skylab, /usr/src/2Install/CURRENT/ZoneMinder-1.22.0  ]
# ipcs -b
ipcs: invalid option -- b
usage : ipcs -asmq -tclup
        ipcs [-s -m -q] -i id
        ipcs -h for help.
----------------- [ 14:17:48, root@skylab, /usr/src/2Install/CURRENT/ZoneMinder-1.22.0  ]
# ipcs -o
ipcs: invalid option -- o
usage : ipcs -asmq -tclup
        ipcs [-s -m -q] -i id
        ipcs -h for help.
----------------- [ 14:17:51, root@skylab, /usr/src/2Install/CURRENT/ZoneMinder-1.22.0  ]
# ipcs -p


For me it's major, since w/o -b option ipcs is useless in case of getting a 
clue why the getshm() returns error within zoneminder.
Comment 1 Olli Artemjev 2006-03-09 11:22:45 UTC
oops.. man pages are not in sync - next man shows '-l'.
-l helps.
Changing subject and priority.
Comment 2 Michael Gross 2006-03-09 11:42:42 UTC
Where is the exact problem/enhancement here?
Comment 3 Olli Artemjev 2006-03-09 17:38:12 UTC
man 1p ipcs should get in sync with man 8 ipcs .

----------------- [ 20:41:25, root@skylab, /usr/src/Installed/ZoneMinder-1.22.0  ]
# apropos ipcs
ipcs (1p)            - report XSI interprocess communication facilities status
ipcs (8)             - provide information on ipc facilities
----------------- [ 20:41:45, root@skylab, /usr/src/Installed/ZoneMinder-1.22.0  ]
#

the 1st declares options that are not supported by ipcs utility. The man pages on the same command are not in sync, the enhancement is to get them in sync, so that man 1p ipcs and man 8 ipcs both will provide correct options.



Comment 4 Mads Martin Joergensen 2006-05-10 18:05:46 UTC
Thorsten, the one from util-linux is fine--I don't know if we even need ipcs in man-pages then?
Comment 5 Thorsten Kukuk 2006-05-10 18:10:13 UTC
"man 1p ipcs" gives you, as clearly stated, the documentation of the POSIX version of ipcs.
So our ipcs should try to get compatible with POSIX, we will not modify or delete the POSIX documentation.
Comment 6 Mads Martin Joergensen 2006-05-10 18:18:26 UTC
Oh, I agree. This is not something I'll fix though, please talk to the upstream ipcs maintainer.