pthread_join(3-thr) — Reliant UNIX 5.44c4

pthread_join(3-thr)                                     pthread_join(3-thr)

NAME
     pthreadjoin - causes the calling thread to wait for the termination
     of a specified thread

SYNOPSIS
     #include <pthread.h>

     int pthreadjoin(
          pthreadt thread,
          pthreadaddrt *status);

PARAMETERS
     thread    Thread whose termination is awaited by the caller of this
               routine.

     status    Status value of the terminating thread when that thread
               calls pthreadexit().

DESCRIPTION
     The pthreadjoin() routine causes the calling thread to wait for the
     termination of a specified thread. A call to this routine returns
     after the specified thread has terminated.

     Any number of threads can call this routine. All threads are awakened
     when the specified thread terminates.

     If the current thread calls this routine to join with itself, an error
     is returned.

     The results of this routine are unpredictable if the value for thread
     refers to a thread object that no longer exists.

RETURN VALUES
     If the thread terminates normally, the exit status is the value that
     is optionally returned from the thread's start routine.

     If the function fails, errno may be set to one of the following
     values:

     EINVAL    The value specified by thread is invalid.

     ESRCH     The value specified by thread does not refer to a currently
               existing thread.

     EDEADLK   A deadlock is detected.

SEE ALSO
     pthreadcreate(3-thr), pthreaddetach(3-thr), pthreadexit(3-thr).







Page 1                       Reliant UNIX 5.44                Printed 11/98
Museum
