*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->Tru64 Unix man pages -> pthread_join (3)              



NAME    [Toc]    [Back]

       pthread_join  -  Causes the calling thread to wait for the
       termination of the specified thread

SYNOPSIS    [Toc]    [Back]

       #include <pthread.h>

       int pthread_join(
               pthread_t thread,
               void **value_ptr );

LIBRARY    [Toc]    [Back]

       DECthreads POSIX 1003.1c Library (libpthread.so)

STANDARDS    [Toc]    [Back]

       Interfaces documented on this reference  page  conform  to
       industry standards as follows:

       IEEE  Std  1003.1c-1995,  POSIX System Application Program

PARAMETERS    [Toc]    [Back]

       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  from  its
       start routine).

DESCRIPTION    [Toc]    [Back]

       This  routine  suspends  execution  of  the calling thread
       until the specified 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 detached.

       If  more  than  one  thread attempts to join with the same
       thread, the results are unpredictable.

       A call to pthread_join(3) returns after the target  thread
       terminates. The pthread_join(3) routine is a deferred cancellation
 point: the target 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 deadlock 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    [Toc]    [Back]

       If an error condition  occurs,  this  routine  returns  an
       integer  value  indicating  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    [Toc]    [Back]


SEE ALSO    [Toc]    [Back]

       Functions:      pthread_cancel(3),      pthread_create(3),
       pthread_detach(3), pthread_exit(3)

       Manuals: Guide to DECthreads and Programmer's Guide

[ Back ]
 Similar pages
Name OS Title
pthread_join FreeBSD wait for thread termination
pthread_join OpenBSD wait for thread termination
pthread_join IRIX wait for thread termination
pthread_exit FreeBSD terminate the calling thread
pthread_exit OpenBSD terminate the calling thread
pthread_exit Tru64 Terminates the calling thread
pthread_exit IRIX terminate the calling thread
tis_self Tru64 Obtains the identifier of the calling thread
pthread_self Tru64 Obtains the identifier of the calling thread
pthread_cond_timedwait Tru64 Causes a thread to wait for the
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service