diff options
| author | jilles <jilles@FreeBSD.org> | 2016-06-01 21:58:13 +0000 |
|---|---|---|
| committer | jilles <jilles@FreeBSD.org> | 2016-06-01 21:58:13 +0000 |
| commit | 534c9c78f3e1ea966e0301afe836cf70c7c61e3b (patch) | |
| tree | a366562c494a22bd76b1f55c58571c6859e89f94 /lib/libc/sys/thr_new.2 | |
| parent | f402b7a826a4f12953487b45e0de71ce57280dbe (diff) | |
| download | FreeBSD-src-534c9c78f3e1ea966e0301afe836cf70c7c61e3b.zip FreeBSD-src-534c9c78f3e1ea966e0301afe836cf70c7c61e3b.tar.gz | |
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.
Diffstat (limited to 'lib/libc/sys/thr_new.2')
| -rw-r--r-- | lib/libc/sys/thr_new.2 | 12 |
1 files changed, 10 insertions, 2 deletions
diff --git a/lib/libc/sys/thr_new.2 b/lib/libc/sys/thr_new.2 index 189ca75..1de5f92 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 |
