NetBSD Problem Report #41831

From Wolfgang.Stukenbrock@nagler-company.com  Thu Aug  6 13:43:16 2009
Return-Path: <Wolfgang.Stukenbrock@nagler-company.com>
Received: from mail.netbsd.org (mail.netbsd.org [204.152.190.11])
	by www.NetBSD.org (Postfix) with ESMTP id 1F5E563BDF9
	for <gnats-bugs@gnats.NetBSD.org>; Thu,  6 Aug 2009 13:43:16 +0000 (UTC)
Message-Id: <20090806134311.2FDE54EA9FE@s012.nagler-company.com>
Date: Thu,  6 Aug 2009 15:43:11 +0200 (CEST)
From: Wolfgang.Stukenbrock@nagler-company.com
Reply-To: Wolfgang.Stukenbrock@nagler-company.com
To: gnats-bugs@gnats.NetBSD.org
Subject: pthread library functions pthread_attr_getscope and pthread_attr_setscope has no manual.
X-Send-Pr-Version: 3.95

>Number:         41831
>Category:       lib
>Synopsis:       pthread library functions pthread_attr_getscope and pthread_attr_setscope has no manual.
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    jruoho
>State:          closed
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Thu Aug 06 13:45:00 +0000 2009
>Closed-Date:    Wed Jul 07 08:30:42 +0000 2010
>Last-Modified:  Wed Jul 07 08:30:42 +0000 2010
>Originator:     Wolfgang Stukenbrock
>Release:        NetBSD 5.0
>Organization:
Dr. Nagler & Company

>Environment:


System: NetBSD s012 4.0 NetBSD 4.0 (NSW-S012) #9: Fri Mar 13 12:31:52 CET 2009 wgstuken@s012:/usr/src/sys/arch/amd64/compile/NSW-S012 amd64
Architecture: x86_64
Machine: amd64
>Description:
	The functions pthread_attr_getscope() and pthread_attr_setscope() are defined in the headerfile and supported by libpthread,
	but they are missing in the manuals.
	Even if the flag value that they maintain, there should be a manual for them.
	Some manual fragments seems to be in the pthread_attr.3 manual, but they are commented out.
	The interesting question why I've started searching for it is the behaviour - including the default setup for this flag.
	It looks to me like that all threads are mapped to lwp's and so are of SCOPE_SYSTEM, but it should be stated somewhere.
>How-To-Repeat:
	Try to find a manual for theese function - you will be out of luck.
>Fix:
	Add the missing manual-parts to pthread_attr.3 manual.
	I cannot give you a patch here, because I don't know the exact behaviour of the threads in NetBSD - sorry.

>Release-Note:

>Audit-Trail:

Responsible-Changed-From-To: lib-bug-people->jruoho
Responsible-Changed-By: jruoho@NetBSD.org
Responsible-Changed-When: Tue, 06 Jul 2010 17:27:58 +0000
Responsible-Changed-Why:

Agreed. Even though links are build for all functions in pthread_attr(3),
the few sentences therein hardly qualify as documentation. I will try to do
something about this.



From: Jukka Ruohonen <jruoho@netbsd.org>
To: gnats-bugs@gnats.NetBSD.org
Cc: 
Subject: PR/41831 CVS commit: src/lib/libpthread
Date: Wed, 7 Jul 2010 08:22:54 +0000

 Module Name:	src
 Committed By:	jruoho
 Date:		Wed Jul  7 08:22:54 UTC 2010

 Modified Files:
 	src/lib/libpthread: Makefile
 Added Files:
 	src/lib/libpthread: pthread_attr_getscope.3

 Log Message:
 Move pthread_attr_{g,s}etscope() to a separate page and try to document
 these better. Should fix PR lib/41831 from Wolfgang Stukenbrock.

 XXX: Please proofread.


 To generate a diff of this commit:
 cvs rdiff -u -r1.58 -r1.59 src/lib/libpthread/Makefile
 cvs rdiff -u -r0 -r1.1 src/lib/libpthread/pthread_attr_getscope.3

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

State-Changed-From-To: open->closed
State-Changed-By: jruoho@NetBSD.org
State-Changed-When: Wed, 07 Jul 2010 08:30:42 +0000
State-Changed-Why:

Fixed (hopefully adequately).

I will keep moving functions from pthread_attr(3) to separate pages
(in order to say more than "the pthread_attr_set*() functions set the
attribute that corresponds to each function name").



>Unformatted:

Home	PR Database Search