pthread_join(3)
NAME
pthread_join - Causes the calling thread to wait for the termination of a specified thread
SYNOPSIS
#include <pthread.h> int pthread_join( pthread_t thread, pthread_addr_t *status);
PARAMETERS
threadThread whose termination is awaited by the caller of this routine.
statusStatus value of the terminating thread when that thread calls pthread_exit().
DESCRIPTION
The pthread_join() 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 is optionally returned from the thread’s start routine. If the function fails, errno may be set to one of the following values:
| Return | Error | Description |
| 0 | Successful completion. | |
| \-1 | [EINVAL] | The value specified by thread is invalid. |
| \-1 | [ESRCH] | The value specified by thread does not refer to a currently existing thread. |
| \-1 | [EDEADLK] | A deadlock is detected. |
RELATED INFORMATION
Functions: pthread_create(3), pthread_detach(3), pthread_exit(3).
Hewlett-Packard Company — OSF DCE 1.1/HP DCE 1.5