FreeBSD manual
download PDF document: thr_exit.2.pdf
THR_EXIT(2) FreeBSD System Calls Manual THR_EXIT(2)
NAME
thr_exit - terminate current thread
LIBRARY
Standard C Library (libc, -lc)
SYNOPSIS
#include <sys/thr.h>
void
thr_exit(long *state);
DESCRIPTION
This function is intended for implementing threading. Normal
applications should call pthread_exit(3) instead.
The thr_exit() system call terminates the current kernel-scheduled
thread.
If the state argument is not NULL, the location pointed to by the
argument is updated with an arbitrary non-zero value, and an _umtx_op(2)
UMTX_OP_WAKE operation is consequently performed on the location.
Attempts to terminate the last thread in the process are silently
ignored. Use _exit(2) syscall to terminate the process.
RETURN VALUES
The function does not return a value. A return from the function
indicates that the calling thread was the last one in the process.
SEE ALSO
_exit(2), _umtx_op(2), thr_kill(2), thr_kill2(2), thr_new(2),
thr_self(2), thr_set_name(2), pthread_exit(3)
STANDARDS
The thr_exit() system call is non-standard and is used by 1:1 Threading
Library (libthr, -lthr) to implement IEEE Std 1003.1-2001 ("POSIX.1")
pthread(3) functionality.
HISTORY
The thr_exit() system call first appeared in FreeBSD 5.2.
FreeBSD 14.0-RELEASE-p6 May 5, 2020 FreeBSD 14.0-RELEASE-p6