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: