Wed Oct 8 10:11:11 2008 UTC ()
Clarifications for PTHREAD_DIAGASSERT.


(ad)
diff -r1.8 -r1.9 src/lib/libpthread/pthread.3
cvs diff -r1.8 -r1.9 src/lib/libpthread/pthread.3 (expand / switch to unified diff)

--- src/lib/libpthread/pthread.3 2008/05/09 08:31:13 1.8
+++ src/lib/libpthread/pthread.3 2008/10/08 10:11:11 1.9
@@ -1,14 +1,14 @@ @@ -1,14 +1,14 @@
1.\" $NetBSD: pthread.3,v 1.8 2008/05/09 08:31:13 wiz Exp $ 1.\" $NetBSD: pthread.3,v 1.9 2008/10/08 10:11:11 ad Exp $
2.\" 2.\"
3.\" Copyright (c) 2003, 2007 The NetBSD Foundation, Inc. 3.\" Copyright (c) 2003, 2007 The NetBSD Foundation, Inc.
4.\" All rights reserved. 4.\" All rights reserved.
5.\" 5.\"
6.\" This code is derived from software contributed to The NetBSD Foundation 6.\" This code is derived from software contributed to The NetBSD Foundation
7.\" by Hubert Feyrer <hubertf@NetBSD.org> and Thomas Klausner <wiz@NetBSD.org>. 7.\" by Hubert Feyrer <hubertf@NetBSD.org> and Thomas Klausner <wiz@NetBSD.org>.
8.\" 8.\"
9.\" Redistribution and use in source and binary forms, with or without 9.\" Redistribution and use in source and binary forms, with or without
10.\" modification, are permitted provided that the following conditions 10.\" modification, are permitted provided that the following conditions
11.\" are met: 11.\" are met:
12.\" 1. Redistributions of source code must retain the above copyright 12.\" 1. Redistributions of source code must retain the above copyright
13.\" notice, this list of conditions and the following disclaimer. 13.\" notice, this list of conditions and the following disclaimer.
14.\" 2. Redistributions in binary form must reproduce the above copyright 14.\" 2. Redistributions in binary form must reproduce the above copyright
@@ -17,27 +17,27 @@ @@ -17,27 +17,27 @@
17.\" 17.\"
18.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS 18.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
19.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 19.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
20.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 20.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
21.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS 21.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
22.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 22.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
23.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 23.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
24.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 24.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
25.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 25.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
26.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 26.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
27.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 27.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
28.\" POSSIBILITY OF SUCH DAMAGE. 28.\" POSSIBILITY OF SUCH DAMAGE.
29.\" 29.\"
30.Dd November 19, 2007 30.Dd October 8, 2008
31.Dt PTHREAD 3 31.Dt PTHREAD 3
32.Os 32.Os
33.Sh NAME 33.Sh NAME
34.Nm pthread 34.Nm pthread
35.Nd POSIX Threads Library 35.Nd POSIX Threads Library
36.Sh LIBRARY 36.Sh LIBRARY
37.Lb libpthread 37.Lb libpthread
38.Sh SYNOPSIS 38.Sh SYNOPSIS
39.In pthread.h 39.In pthread.h
40.Pp 40.Pp
41.Nm cc 41.Nm cc
42.Op Ar flags 42.Op Ar flags
43.Ar files 43.Ar files
@@ -59,42 +59,49 @@ releases, programs must be linked agains @@ -59,42 +59,49 @@ releases, programs must be linked agains
59thread library. 59thread library.
60Statically linked programs using the 60Statically linked programs using the
61.Tn POSIX 61.Tn POSIX
62threads framework may not work when run on a future version of the system. 62threads framework may not work when run on a future version of the system.
63.Sh ENVIRONMENT 63.Sh ENVIRONMENT
64.Bl -tag -width PTHREAD_DEBUGCOUNTERSXX 64.Bl -tag -width PTHREAD_DEBUGCOUNTERSXX
65.It Ev PTHREAD_CONCURRENCY 65.It Ev PTHREAD_CONCURRENCY
66The current version of the system does not inspect this variable. 66The current version of the system does not inspect this variable.
67It is reserved for use by the 67It is reserved for use by the
68.Nm 68.Nm
69library. 69library.
70.It Ev PTHREAD_DIAGASSERT 70.It Ev PTHREAD_DIAGASSERT
71Possible values are any combinations of: 71Possible values are any combinations of:
 72.Pp
72.Bl -tag -width ignoreXX -offset indent -compact 73.Bl -tag -width ignoreXX -offset indent -compact
73.It Sy A 74.It Sy A
74Ignore errors. 75Report errors to application by error return, but do not abort.
75.It Sy a 76.It Sy a
76Abort on errors, creating a core dump for further debugging. 77Abort on errors, creating a core dump for further debugging.
77.It Sy E 78.It Sy E
78Do not log errors to stdout. 79Do not log errors to stdout.
79.It Sy e 80.It Sy e
80Log errors to stdout. 81Log errors to stdout.
81.It Sy L 82.It Sy L
82Do not log errors via 83Do not log errors via
83.Xr syslogd 8 . 84.Xr syslogd 8 .
84.It Sy l 85.It Sy l
85Log errors via 86Log errors via
86.Xr syslogd 8 . 87.Xr syslogd 8 .
87.El 88.El
 89.Pp
 90If not set in the environment, the
 91.Nm
 92library behaves as if
 93.Sy AEL
 94has been specified.
88.It Ev PTHREAD_RRTIME 95.It Ev PTHREAD_RRTIME
89The current version of the system does not inspect this variable. 96The current version of the system does not inspect this variable.
90It is reserved for use by the 97It is reserved for use by the
91.Nm 98.Nm
92library. 99library.
93.It Ev PTHREAD_STACKSIZE 100.It Ev PTHREAD_STACKSIZE
94Integer value giving the stack size in kilobytes. 101Integer value giving the stack size in kilobytes.
95This allows to set a smaller stack size than the default stack size. 102This allows to set a smaller stack size than the default stack size.
96The default stack size is the current limit on the stack size as 103The default stack size is the current limit on the stack size as
97set with the shell's command to change limits 104set with the shell's command to change limits
98.Ic ( limit 105.Ic ( limit
99for 106for
100.Xr csh 1 , 107.Xr csh 1 ,