thr_exit (2)

Leading comments

Copyright (c) 2016 The FreeBSD Foundation, Inc.
All rights reserved.

This documentation was written by
Konstantin Belousov <kib@FreeBSD.org> under sponsorship
from the FreeBSD Foundation.

Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions
are met:
1. Redistributions of source code must retain the above copyright
   notice, this list of conditions and the following disclaimer.
2. Redistributions in binary form...

(The comments found at the beginning of the groff file "man2/thr_exit.2freebsd".)

NAME

thr_exit - terminate current thread

LIBRARY

Lb libc

SYNOPSIS

In sys/thr.h Ft void Fn thr_exit long *state

DESCRIPTION

Bf -symbolic This function is intended for implementing threading. Normal applications should call pthread_exit3 instead. Ef

The Fn thr_exit system call terminates the current kernel-scheduled thread.

If the Fa state argument is not NULL the location pointed to by the argument is updated with an arbitrary non-zero value, and an _umtx_op2 UMTX_OP_WAKE operation is consequently performed on the location.

Attempts to terminate the last thread in the process are silently ignored. Use _exit2 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

_exit2, thr_kill2, thr_kill22, thr_new2, thr_self2, thr_set_name2, _umtx_op2, pthread_exit3

STANDARDS

The Fn thr_exit system call is non-standard and is used by Lb libthr to implement St -p1003.1-2001 pthread(3) functionality.