PTHREADJOIN(3) BSD Library Functions Manual PTHREADJOIN(3)

NAME
     pptthhrreeaaddjjooiinn - wait for thread termination

SYNOPSIS
     ##iinncclluuddee <>

     int
     pptthhrreeaaddjjooiinn(pthreadt thread, void **valueptr);

DESCRIPTION
     The pptthhrreeaaddjjooiinn() function suspends execution of the calling thread
     until the target thread terminates unless the target thread has already
     terminated.

     On return from a successful pptthhrreeaaddjjooiinn() call with a non-NULL valueptr
     argument, the value passed to pptthhrreeaaddeexxiitt() by the terminating thread is
     stored in the location referenced by valueptr.  When a pptthhrreeaaddjjooiinn()
     returns successfully, the target thread has been terminated.  The results
     of multiple simultaneous calls to pptthhrreeaaddjjooiinn() specifying the same tar-
     get thread are undefined.  If the thread calling pptthhrreeaaddjjooiinn() is can-
     celled, then the target thread is not detached.

RETURN VALUES
     If successful,  the pptthhrreeaaddjjooiinn() function will return zero.  Otherwise
     an error number will be returned to indicate the error.

EERRRROORRSS
     pptthhrreeaaddjjooiinn() will fail if:

     [EINVAL]           The implementation has detected that the value speci-
                        fied by thread does not refer to a joinable thread.

     [ESRCH]            No thread could be found corresponding to that speci-
                        fied by the given thread ID, thread.

     [EDEADLK]          A deadlock was detected or the value of thread speci-
                        fies the calling thread.

SEE ALSO
     wait(2), pthreadcreate(3)

STANDARDS
     pptthhrreeaaddjjooiinn() conforms to ISO/IEC 9945-1:1996 (``POSIX.1'').

BSD                              April 4, 1996                             BSD