pthread_join man page on DigitalUNIX

Man page or keyword search:  
man Server   12896 pages
apropos Keyword Search (all sections)
Output format
DigitalUNIX logo
[printable version]

pthread_join(3)						       pthread_join(3)

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

SYNOPSIS
       #include <pthread.h>

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

LIBRARY
       DECthreads POSIX 1003.1c Library (libpthread.so)

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

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
       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 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
       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
       None

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

       Manuals: Guide to DECthreads and Programmer's Guide

							       pthread_join(3)
[top]

List of man pages available for DigitalUNIX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net