Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
pthread_exit(3T)					      pthread_exit(3T)

NAME
       pthread_exit() -	cause the calling thread to terminate

SYNOPSIS
PARAMETERS
	      value_ptr	The calling thread's exit status.

DESCRIPTION
       terminates the calling thread.  The calling thread returns an exit sta-
       tus in value_ptr.  This value is	returned to a joining  thread  calling
       on  the	terminating thread.  Only threads created with the detachstate
       attribute value can return an exit status to The	exit status of	a  de-
       tached thread is	lost when the thread terminates.

       When  a	thread	terminates, process-shared resources are not released.
       Examples	of process-shared resources include mutexes,  condition	 vari-
       ables,  semaphores,  message  queue  descriptors, and file descriptors.
       The routines are	not called when	a  thread  terminates  as  this	 is  a
       process termination action.

       An  implicit  call to is	made when a thread returns from	its start rou-
       tine.  The function's return value serves as the	thread's  exit	status
       (see  pthread_create(3T)).   If	the  main  thread returns from without
       calling the process will	exit using the return value from as  the  exit
       status.	 If  the main thread calls the process will continue executing
       until the last thread terminates	or  a  thread  calls  After  the  last
       thread  in  the	process	terminates, the	process	will exit with an exit
       status of zero.

       Any installed cancellation cleanup handlers will	be popped and executed
       in  the reverse order that they were installed.	After the cancellation
       cleanup handlers	have been executed, if the thread has any  non-thread-
       specific	data values with associated destructor functions, the destruc-
       tor functions are called.  The order in which  these  destructor	 func-
       tions are called	is unspecified.

       Calling from a cancellation cleanup handler or destructor function that
       was invoked because of thread termination results in  undefined	behav-
       ior.

       After  a	 thread	 has  terminated, the result of	access to local	(auto)
       variables of the	thread is undefined.  The  terminating	thread	should
       not use local variables for the value_ptr parameter value.

RETURN VALUE
       None.

ERRORS
       None, this function does	not return.

AUTHOR
       was derived from	the IEEE POSIX P1003.1c	standard.

SEE ALSO
       pthread_create(3T), pthread_join(3T), exit(2), wait(2).

STANDARDS CONFORMANCE
				Pthread	Library		      pthread_exit(3T)

NAME | SYNOPSIS | PARAMETERS | DESCRIPTION | RETURN VALUE | ERRORS | AUTHOR | SEE ALSO | STANDARDS CONFORMANCE

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=pthread_exit&sektion=3t&manpath=HP-UX+11.22>

home | help