aboutsummaryrefslogtreecommitdiffstats
path: root/lib/libc/sys/thr_new.2
diff options
context:
space:
mode:
authorJilles Tjoelker <jilles@FreeBSD.org>2016-06-01 21:58:13 +0000
committerJilles Tjoelker <jilles@FreeBSD.org>2016-06-01 21:58:13 +0000
commit9de9fa32c9545d044d1bc4e9337d8d22049d9bf7 (patch)
treea366562c494a22bd76b1f55c58571c6859e89f94 /lib/libc/sys/thr_new.2
parentcd9f4c599d8548997d609939fac2346c2393e3d5 (diff)
downloadsrc-9de9fa32c9545d044d1bc4e9337d8d22049d9bf7.tar.gz
src-9de9fa32c9545d044d1bc4e9337d8d22049d9bf7.zip
thr_*(2): Add xrefs to what libthr implements using each syscall.
Add text to thr_exit(2) and thr_new(2) discouraging their use in applications since calling these in a process with libthr loaded will confuse libthr and is likely to cause hangs or crashes. The thr_kill2(2) call is not used by libthr and may be useful in special applications. The other calls can be used in applications but it should not be necessary.
Notes
Notes: svn path=/head/; revision=301171
Diffstat (limited to 'lib/libc/sys/thr_new.2')
-rw-r--r--lib/libc/sys/thr_new.212
1 files changed, 10 insertions, 2 deletions
diff --git a/lib/libc/sys/thr_new.2 b/lib/libc/sys/thr_new.2
index 189ca7512e89..1de5f92ad56c 100644
--- a/lib/libc/sys/thr_new.2
+++ b/lib/libc/sys/thr_new.2
@@ -28,7 +28,7 @@
.\"
.\" $FreeBSD$
.\"
-.Dd May 5, 2016
+.Dd June 1, 2016
.Dt THR_NEW 2
.Os
.Sh NAME
@@ -41,6 +41,13 @@
.Ft int
.Fn thr_new "struct thr_param *param" "int param_size"
.Sh DESCRIPTION
+.Bf -symbolic
+This function is intended for implementing threading.
+Normal applications should call
+.Xr pthread_create 3
+instead.
+.Ef
+.Pp
The
.Fn thr_new
system call creates a new kernel-scheduled thread of execution in the context
@@ -220,7 +227,8 @@ No kernel memory to allocate for the new thread structures.
.Xr thr_kill2 2 ,
.Xr thr_self 2 ,
.Xr thr_set_name 2 ,
-.Xr _umtx_op 2
+.Xr _umtx_op 2 ,
+.Xr pthread_create 3
.Sh STANDARDS
The
.Fn thr_new