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

개요

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

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_detach(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
                  attempts to wait for itself.


       EINVAL     The thread  corresponding  to  the  given  thread  ID  is  a
                  detached 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
       explicit  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