d/freebsd-nq
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

thr_*(2): Add xrefs to what libthr implements using each syscall.

Browse Source 
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.
This commit is contained in:
Jilles Tjoelker 2016-06-01 21:58:13 +00:00
parent cd9f4c599d
commit 9de9fa32c9
5 changed files with 29 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
lib/libc/sys/thr_exit.2
View File

@ -28,7 +28,7 @@
.\"
.\" $FreeBSD$
.\"
.Dd May 5, 2016
.Dd June 1, 2016
.Dt THR_EXIT 2
.Os
.Sh NAME
@ -41,6 +41,13 @@
.Ft void
.Fn thr_exit "long *state"
.Sh DESCRIPTION
.Bf -symbolic
This function is intended for implementing threading.
Normal applications should call
.Xr pthread_exit 3
instead.
.Ef
.Pp
The
.Fn thr_exit
system call terminates the current kernel-scheduled thread.
@ -70,7 +77,8 @@ last one in the process.
.Xr thr_new 2 ,
.Xr thr_self 2 ,
.Xr thr_set_name 2 ,
.Xr _umtx_op 2
.Xr _umtx_op 2 ,
.Xr pthread_exit 3
.Sh STANDARDS
The
.Fn thr_exit

4
lib/libc/sys/thr_kill.2
View File

@ -28,7 +28,7 @@
.\"
.\" $FreeBSD$
.\"
.Dd May 5, 2016
.Dd June 1, 2016
.Dt THR_kill 2
.Os
.Sh NAME
@ -112,11 +112,13 @@ The current process does not have sufficient privilege to check existence or
send a signal to the specified process.
.El
.Sh SEE ALSO
.Xr kill 2 ,
.Xr thr_exit 2 ,
.Xr thr_new 2 ,
.Xr thr_self 2 ,
.Xr thr_set_name 2 ,
.Xr _umtx_op 2 ,
.Xr pthread_kill 3 ,
.Xr signal 3
.Sh STANDARDS
The

12
lib/libc/sys/thr_new.2
View File

@ -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

6
lib/libc/sys/thr_self.2
View File

@ -28,7 +28,7 @@
.\"
.\" $FreeBSD$
.\"
.Dd May 5, 2016
.Dd June 1, 2016
.Dt THR_SELF 2
.Os
.Sh NAME
@ -76,7 +76,9 @@ argument is not valid.
.Xr thr_kill2 2 ,
.Xr thr_new 2 ,
.Xr thr_set_name 2 ,
.Xr _umtx_op 2
.Xr _umtx_op 2 ,
.Xr pthread_getthreadid_np 3 ,
.Xr pthread_self 3
.Sh STANDARDS
The
.Fn thr_self

3
lib/libc/sys/thr_set_name.2
View File

@ -28,7 +28,7 @@
.\"
.\" $FreeBSD$
.\"
.Dd May 5, 2016
.Dd June 1, 2016
.Dt THR_SET_NAME 2
.Os
.Sh NAME
@ -87,6 +87,7 @@ does not exist in the current process.
.Xr thr_new 2 ,
.Xr thr_self 2 ,
.Xr _umtx_op 2 ,
.Xr pthread_set_name_np 3 ,
.Xr ddb 4 ,
.Xr ktr 9
.Sh STANDARDS