NetBSD Problem Report #41605

From jukka+moray@salmi.ch  Tue Jun 16 16:35:56 2009
Return-Path: <jukka+moray@salmi.ch>
Received: from mail.netbsd.org (mail.netbsd.org [204.152.190.11])
	by www.NetBSD.org (Postfix) with ESMTP id 3FDEA63B8BA
	for <gnats-bugs@gnats.NetBSD.org>; Tue, 16 Jun 2009 16:35:56 +0000 (UTC)
Message-Id: <20090616161910.527BD5364@moray.salmi.ch>
Date: Tue, 16 Jun 2009 18:19:10 +0200 (CEST)
From: Jukka Salmi <j+nbsd@salmi.ch>
Reply-To: Jukka Salmi <j+nbsd@salmi.ch>
To: gnats-bugs@gnats.NetBSD.org
Subject: some copy'n'pastoes in semctl(2) and shmctl(2) man pages
X-Send-Pr-Version: 3.95

>Number:         41605
>Category:       lib
>Synopsis:       some copy'n'pastoes in semctl(2) and shmctl(2) man pages
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    dholland
>State:          closed
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Tue Jun 16 16:40:00 +0000 2009
>Closed-Date:    Tue Aug 18 15:18:24 +0000 2009
>Last-Modified:  Tue Aug 18 15:18:24 +0000 2009
>Originator:     Jukka Salmi
>Release:        NetBSD 5.99.12
>Organization:
>Environment:
System: NetBSD moray.salmi.ch 5.99.12 NetBSD 5.99.12 (MORAY) #0: Mon May 25 17:09:01 CEST 2009 root@moray.salmi.ch:/b/build/nbsd/c/i386/sys/arch/i386/compile/MORAY i386
Architecture: i386
Machine: i386
>Description:
There are some (probably copy'n'paste related) errors in the semctl(2) and
shmctl(2) man pages: sometimes the text references message queues when it
should reference semaphores and shared memory segments respectively.
>How-To-Repeat:
n/a
>Fix:
The following patch is also available from
http://salmi.ch/~jukka/patches/nbsd/HEAD/lib/libc/sys/sysvipc_man.diff

Index: lib/libc/sys/semctl.2
===================================================================
RCS file: /cvsroot/src/lib/libc/sys/semctl.2,v
retrieving revision 1.17
diff -u -p -r1.17 semctl.2
--- lib/libc/sys/semctl.2	6 May 2008 20:25:09 -0000	1.17
+++ lib/libc/sys/semctl.2	16 Jun 2009 16:11:51 -0000
@@ -150,7 +150,7 @@ has an effective user id equal to either
 .Va sem_perm.cuid
 or
 .Va sem_perm.uid
-in the data structure associated with the message queue.
+in the data structure associated with the semaphore.
 .It Dv IPC_RMID
 Remove the semaphores associated with
 .Fa semid
@@ -162,7 +162,7 @@ or
 values in the data structure associated with the semaphore can do this.
 .El
 .Pp
-The permission to read or change a message queue (see
+The permission to read or change a semaphore (see
 .Xr semop 2 )
 is determined by the
 .Va sem_perm.mode
@@ -209,7 +209,7 @@ the effective uid match either the
 .Va sem_perm.uid
 or
 .Va sem_perm.cuid
-fields of the data structure associated with the message queue.
+fields of the data structure associated with the semaphore.
 .It Bq Er EACCES
 The caller has no operation permission for this semaphore.
 .It Bq Er EINVAL
Index: lib/libc/sys/shmctl.2
===================================================================
RCS file: /cvsroot/src/lib/libc/sys/shmctl.2,v
retrieving revision 1.19
diff -u -p -r1.19 shmctl.2
--- lib/libc/sys/shmctl.2	31 Dec 2006 03:17:52 -0000	1.19
+++ lib/libc/sys/shmctl.2	16 Jun 2009 16:11:52 -0000
@@ -112,7 +112,7 @@ Only the super-user or a process with an
 .Va shm_perm.cuid
 or
 .Va shm_perm.uid
-values in the data structure associated with the queue can do this.
+values in the data structure associated with the shared memory segment can do this.
 .It Dv SHM_LOCK
 Lock the shared memory segment specified by
 .Fa shmid

>Release-Note:

>Audit-Trail:
From: "David A. Holland" <dholland@netbsd.org>
To: gnats-bugs@gnats.NetBSD.org
Cc: 
Subject: PR/41605 CVS commit: src/lib/libc/sys
Date: Sun, 21 Jun 2009 17:52:42 +0000

 Module Name:	src
 Committed By:	dholland
 Date:		Sun Jun 21 17:52:42 UTC 2009

 Modified Files:
 	src/lib/libc/sys: semctl.2 shmctl.2

 Log Message:
 Fix pastos. From Jukka Salmi in PR 41605, with a very minor adjustment.


 To generate a diff of this commit:
 cvs rdiff -u -r1.17 -r1.18 src/lib/libc/sys/semctl.2
 cvs rdiff -u -r1.19 -r1.20 src/lib/libc/sys/shmctl.2

 Please note that diffs are not public domain; they are subject to the
 copyright notices on the relevant files.

Responsible-Changed-From-To: lib-bug-people->dholland
Responsible-Changed-By: dholland@NetBSD.org
Responsible-Changed-When: Sun, 21 Jun 2009 17:56:35 +0000
Responsible-Changed-Why:
I applied the patch, will handle pullups


State-Changed-From-To: open->closed
State-Changed-By: dsl@NetBSD.org
State-Changed-When: Mon, 03 Aug 2009 20:29:19 +0000
State-Changed-Why:
dh applied the changes but forgot to close the PR


State-Changed-From-To: closed->pending-pullups
State-Changed-By: dholland@NetBSD.org
State-Changed-When: Tue, 04 Aug 2009 05:43:19 +0000
State-Changed-Why:
nope, I don't forget things like that :-) the issue was that I hadn't
gotten around to filing pullups yet. they are now filed:
   pullup-5 #894
   pullup-4 #1351


From: Soren Jacobsen <snj@netbsd.org>
To: gnats-bugs@gnats.NetBSD.org
Cc: 
Subject: PR/41605 CVS commit: [netbsd-5-0] src/lib/libc/sys
Date: Fri, 14 Aug 2009 21:18:29 +0000

 Module Name:	src
 Committed By:	snj
 Date:		Fri Aug 14 21:18:29 UTC 2009

 Modified Files:
 	src/lib/libc/sys [netbsd-5-0]: semctl.2 shmctl.2

 Log Message:
 Pull up following revision(s) (requested by dholland in ticket #894):
 	lib/libc/sys/semctl.2: revision 1.18
 	lib/libc/sys/shmctl.2: revision 1.20
 Fix pastos. From Jukka Salmi in PR 41605, with a very minor adjustment.


 To generate a diff of this commit:
 cvs rdiff -u -r1.17 -r1.17.12.1 src/lib/libc/sys/semctl.2
 cvs rdiff -u -r1.19 -r1.19.24.1 src/lib/libc/sys/shmctl.2

 Please note that diffs are not public domain; they are subject to the
 copyright notices on the relevant files.

From: Soren Jacobsen <snj@netbsd.org>
To: gnats-bugs@gnats.NetBSD.org
Cc: 
Subject: PR/41605 CVS commit: [netbsd-5] src/lib/libc/sys
Date: Fri, 14 Aug 2009 21:18:54 +0000

 Module Name:	src
 Committed By:	snj
 Date:		Fri Aug 14 21:18:54 UTC 2009

 Modified Files:
 	src/lib/libc/sys [netbsd-5]: semctl.2 shmctl.2

 Log Message:
 Pull up following revision(s) (requested by dholland in ticket #894):
 	lib/libc/sys/semctl.2: revision 1.18
 	lib/libc/sys/shmctl.2: revision 1.20
 Fix pastos. From Jukka Salmi in PR 41605, with a very minor adjustment.


 To generate a diff of this commit:
 cvs rdiff -u -r1.17 -r1.17.6.1 src/lib/libc/sys/semctl.2
 cvs rdiff -u -r1.19 -r1.19.18.1 src/lib/libc/sys/shmctl.2

 Please note that diffs are not public domain; they are subject to the
 copyright notices on the relevant files.

From: Manuel Bouyer <bouyer@netbsd.org>
To: gnats-bugs@gnats.NetBSD.org
Cc: 
Subject: PR/41605 CVS commit: [netbsd-4] src/lib/libc/sys
Date: Tue, 18 Aug 2009 10:53:45 +0000

 Module Name:	src
 Committed By:	bouyer
 Date:		Tue Aug 18 10:53:45 UTC 2009

 Modified Files:
 	src/lib/libc/sys [netbsd-4]: semctl.2 shmctl.2

 Log Message:
 Pull up following revision(s) (requested by dholland in ticket #1351):
 	lib/libc/sys/shmctl.2: revision 1.20
 	lib/libc/sys/semctl.2: revision 1.18
 Fix pastos. From Jukka Salmi in PR 41605, with a very minor adjustment.


 To generate a diff of this commit:
 cvs rdiff -u -r1.16 -r1.16.10.1 src/lib/libc/sys/semctl.2
 cvs rdiff -u -r1.17 -r1.17.2.1 src/lib/libc/sys/shmctl.2

 Please note that diffs are not public domain; they are subject to the
 copyright notices on the relevant files.

From: Manuel Bouyer <bouyer@netbsd.org>
To: gnats-bugs@gnats.NetBSD.org
Cc: 
Subject: PR/41605 CVS commit: [netbsd-4-0] src/lib/libc/sys
Date: Tue, 18 Aug 2009 10:53:52 +0000

 Module Name:	src
 Committed By:	bouyer
 Date:		Tue Aug 18 10:53:52 UTC 2009

 Modified Files:
 	src/lib/libc/sys [netbsd-4-0]: semctl.2 shmctl.2

 Log Message:
 Pull up following revision(s) (requested by dholland in ticket #1351):
 	lib/libc/sys/shmctl.2: revision 1.20
 	lib/libc/sys/semctl.2: revision 1.18
 Fix pastos. From Jukka Salmi in PR 41605, with a very minor adjustment.


 To generate a diff of this commit:
 cvs rdiff -u -r1.16 -r1.16.20.1 src/lib/libc/sys/semctl.2
 cvs rdiff -u -r1.17 -r1.17.6.1 src/lib/libc/sys/shmctl.2

 Please note that diffs are not public domain; they are subject to the
 copyright notices on the relevant files.

State-Changed-From-To: pending-pullups->closed
State-Changed-By: dholland@NetBSD.org
State-Changed-When: Tue, 18 Aug 2009 15:18:24 +0000
State-Changed-Why:
Pullups completed.


>Unformatted:

Home	PR Database Search