Module Name: src
Committed By: jruoho
Date: Wed May 19 08:02:46 UTC 2010
Modified Files:
src/share/man/man3: sigevent.3
Log Message:
Continue the discussion w.r.t. SIGEV_THREAD by nothing that pthread_join(3)
should be out of the question and that thread stack cannot be recovered.
To generate a diff of this commit:
cvs rdiff -u -r1.2 -r1.3 src/share/man/man3/sigevent.3
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/share/man/man3/sigevent.3
diff -u src/share/man/man3/sigevent.3:1.2 src/share/man/man3/sigevent.3:1.3
--- src/share/man/man3/sigevent.3:1.2 Wed May 19 06:59:44 2010
+++ src/share/man/man3/sigevent.3 Wed May 19 08:02:46 2010
@@ -1,4 +1,4 @@
-.\" $NetBSD: sigevent.3,v 1.2 2010/05/19 06:59:44 wiz Exp $
+.\" $NetBSD: sigevent.3,v 1.3 2010/05/19 08:02:46 jruoho Exp $
.\"
.\" Copyright (c) 2010 Jukka Ruohonen <[email protected]>
.\"
@@ -141,6 +141,23 @@
the type is
.Va pthread_attr_t
in practice.)
+.Pp
+The threads are created as detached,
+or in an unspecified way if
+.Xr pthread_attr_setdetachstate 3
+is used with
+.Va sigev_notify_attributes
+to set
+.Dv PTHREAD_CREATE_JOINABLE .
+It is not valid to call
+.Xr pthread_join 3
+in either case.
+Hence, it is also impossible to determine the lifetime of the created thread.
+This in turn means that it is neither possibly to recovery the memory nor
+the address of the memory possibly dedicated as thread stack via
+.Fn pthread_attr_setstack
+or
+.Fn pthread_attr_setstackaddr .
.El
.\"
.\" .Sh EXAMPLES
