*** UNIX MANUAL PAGE BROWSER ***

pthread_join(3) Library Functions Manual pthread_join(3) NAME pthread_join - Causes the calling thread to wait for the termination of the specified thread. LIBRARY DECthreads POSIX 1003.1c Library (libpthread.so) SYNOPSIS #include <pthread.h> int pthread_join( pthread_t thread, void **value_ptr); STANDARDS Interfaces documented on this reference page conform to industry stan- dards as follows: IEEE Std 1003.1c-1995, POSIX System Application Program Interface PARAMETERS Thread whose termination is awaited by the calling routine. Return value of the terminating thread (when that thread either calls pthread_exit(3) or returns). DESCRIPTION This routine suspends execution of the calling thread until the speci- fied target thread thread terminates. On return from a successful pthread_join(3) call with a non-NULL value_ptr argument, the value passed to pthread_exit(3) is returned in the location referenced by value_ptr, and the terminating thread is de- tached. If more than one thread attempts to join with the same thread, the re- sults are unpredictable. A call to pthread_join(3) returns after the target thread terminates. The pthread_join(3) routine is a deferred cancelation point: the tar- get thread will not be detached if the thread blocked in pthread_join(3) is canceled. If a thread calls this routine and specifies its own pthread_t, a dead- lock can result. The pthread_join(3) (or pthread_detach(3)) routine should eventually be called for every thread that is created with the detachstate attribute of its thread attributes object set to PTHREAD_CREATE_JOINABLE, so that storage associated with the thread can be reclaimed. RETURN VALUES If an error condition occurs, this routine returns an integer value in- dicating the type of error. Possible return values are as follows: Successful completion. The value specified by thread does not refer to a joinable thread. The value specified by thread does not refer to an existing thread ID. A deadlock was detected, or thread specifies the calling thread. ERRORS None RELATED INFORMATION Functions: pthread_cancel(3), pthread_create(3), pthread_detach(3), pthread_exit(3) Manuals: Guide to DECthreads and Programmer's Guide delim off pthread_join(3)