Subject: standards/13034: shmget(2) documents IPC_[RWM] for shmflg argument, which is wrong
To: None <gnats-bugs@gnats.netbsd.org>
From: Klaus Klein <kleink@uni-trier.de>
List: netbsd-bugs
Date: 05/25/2001 00:03:08
>Number:         13034
>Category:       standards
>Synopsis:       shmget(2) documents IPC_[RWM] for shmflg argument, which is wrong
>Confidential:   no
>Severity:       serious
>Priority:       medium
>Responsible:    standards-manager
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Thu May 24 15:02:01 PDT 2001
>Closed-Date:
>Last-Modified:
>Originator:     Klaus Klein
>Release:        2001-05-24
>Organization:
Frobozz Magic Standards Company
>Environment:
System: NetBSD jornada-del-muerto.er.reziprozitaet.de 1.5V NetBSD 1.5V (JORNADA-DEL-MUERTO) #28: Wed May 23 00:56:56 CEST 2001 kleink@jornada-del-muerto.er.reziprozitaet.de:/vol/space/kernels/JORNADA-DEL-MUERTO sparc
Architecture: sparc
Machine: sparc

>Description:
	In rev. 1.9 of shmget(2) documentation on the shmflg argument
	was added, which exposes the IPC_[RWM] identifiers defined in
	<sys/ipc.h>.  However, these identifiers are made available in
	_KERNEL environments only.

>How-To-Repeat:
	man shmget

>Fix:
	1) Remove reference to those identifiers.

	2) As for adding real documentation on the access bits, the
	   situation is currently unclear; while common sense suggests
	   that S_I[RW]{USR,GRP,OTH} from <sys/stat.h> should be used
	   (ipc_perm.mode is a mode_t, after all), the current 1003.1-200xD6
	   documents numerical (but congruent) values for XSI IPC only.

>Release-Note:
>Audit-Trail:
>Unformatted: