linuxthreads/man/pthread_exit.man

   1 .TH PTHREAD_EXIT 3 LinuxThreads
   2
   3 .SH NAME
   4 pthread_exit \- terminate the calling thread
   5
   6 .SH SYNOPSIS
   7 #include <pthread.h>
   8
   9 void pthread_exit(void *retval);
  10
  11 .SH DESCRIPTION
  12 !pthread_exit! terminates the execution of the calling thread.
  13 All cleanup handlers that have been set for the calling thread with
  14 !pthread_cleanup_push!(3) are executed in reverse order (the most
  15 recently pushed handler is executed first). Finalization functions for
  16 thread-specific data are then called for all keys that have non-!NULL!
  17 values associated with them in the calling thread (see
  18 !pthread_key_create!(3)). Finally, execution of the calling thread is
  19 stopped.
  20
  21 The |retval| argument is the return value of the thread. It can be
  22 consulted from another thread using !pthread_join!(3).
  23
  24 .SH "RETURN VALUE"
  25 The !pthread_exit! function never returns.
  26
  27 .SH AUTHOR
  28 Xavier Leroy <Xavier.Leroy@inria.fr>
  29
  30 .SH "SEE ALSO"
  31 !pthread_create!(3),
  32 !pthread_join!(3).