pthread_join(3c) 맨 페이지 - 윈디하나의 솔라나라

개요

섹션
맨 페이지 이름
검색(S)

pthread_join(3c)

pthread_join(3C)         Standard C Library Functions         pthread_join(3C)

NAME
       pthread_join - wait for thread termination

SYNOPSIS
       #include <pthread.h>

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

DESCRIPTION
       The  pthread_join()  function suspends processing of the calling thread
       until the target thread completes. thread must be a member of the  cur‐
       rent  process  and  it  cannot  be  a detached thread. See pthread_cre‐
       ate(3C).


       If two or more threads wait for the same thread to complete,  all  will
       suspend processing until the thread has terminated, and then one thread
       will  return  successfully  and the others will return with an error of
       ESRCH. The pthread_join() function will not  block  processing  of  the
       calling thread if the target thread has already terminated.


       If  a  pthread_join()  call returns successfully with a non-null status
       argument, the value  passed  to  pthread_exit(3C)  by  the  terminating
       thread will be placed in the location referenced by status.


       If  the  pthread_join()  calling  thread  is cancelled, then the target
       thread will remain joinable by  pthread_join().  However,  the  calling
       thread may set up a cancellation cleanup handler on thread prior to the
       join  call,  which  may detach the target thread by calling pthread_de‐
       tach(3C). See pthread_detach(3C) and pthread_cancel(3C).

RETURN VALUES
       If successful, pthread_join() returns 0. Otherwise, an error number  is
       returned to indicate the error.

ERRORS
       EDEADLK    A  joining  deadlock  would occur, such as when a thread at‐
                  tempts to wait for itself.


       EINVAL     The thread corresponding to the given thread  ID  is  a  de‐
                  tached thread.


       ESRCH      No  thread  could be found corresponding to the given thread
                  ID.


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:

       tab() box; cw(2.75i) |cw(2.75i) lw(2.75i) |lw(2.75i) ATTRIBUTE  TYPEAT‐
       TRIBUTE  VALUE _ Interface StabilityCommitted _ MT-LevelMT-Safe _ Stan‐
       dardSee standards(7).


SEE ALSO
       pthread_cancel(3C),       pthread_create(3C),       pthread_detach(3C),
       pthread_exit(3C), wait(3C), attributes(7), standards(7)

NOTES
       The  pthread_join() function must specify the thread  ID for whose ter‐
       mination it will wait.


       Calling  pthread_join()  also   "detaches"   the   thread;   that   is,
       pthread_join() includes the effect of the pthread_detach() function. If
       a  thread  were  to be cancelled when blocked in pthread_join(), an ex‐
       plicit detach would have to be performed in  the  cancellation  cleanup
       handler.  The  pthread_detach() function exists primarily for this pur‐
       pose.

Oracle Solaris 11.4               16 May 2014                 pthread_join(3C)
맨 페이지 내용의 저작권은 맨 페이지 작성자에게 있습니다.
RSS ATOM XHTML 5 CSS3