lib/libpthread/thread/thr_join.c

   1 /*
   2  * Copyright (c) 1995 John Birrell <jb@cimlogic.com.au>.
   3  * All rights reserved.
   4  *
   5  * Redistribution and use in source and binary forms, with or without
   6  * modification, are permitted provided that the following conditions
   7  * are met:
   8  * 1. Redistributions of source code must retain the above copyright
   9  *    notice, this list of conditions and the following disclaimer.
  10  * 2. Redistributions in binary form must reproduce the above copyright
  11  *    notice, this list of conditions and the following disclaimer in the
  12  *    documentation and/or other materials provided with the distribution.
  13  * 3. All advertising materials mentioning features or use of this software
  14  *    must display the following acknowledgement:
  15  *      This product includes software developed by John Birrell.
  16  * 4. Neither the name of the author nor the names of any co-contributors
  17  *    may be used to endorse or promote products derived from this software
  18  *    without specific prior written permission.
  19  *
  20  * THIS SOFTWARE IS PROVIDED BY JOHN BIRRELL AND CONTRIBUTORS ``AS IS'' AND
  21  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  22  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  23  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
  24  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  25  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  26  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  27  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  28  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  29  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  30  * SUCH DAMAGE.
  31  *
  32  * $Id: uthread_join.c,v 1.7 1999/06/20 08:28:29 jb Exp $
  33  */
  34 #include <errno.h>
  35 #ifdef _THREAD_SAFE
  36 #include <pthread.h>
  37 #include "pthread_private.h"
  38
  39 int
  40 pthread_join(pthread_t pthread, void **thread_return)
  41 {
  42         int ret = 0;
  43         pthread_t pthread1 = NULL;
  44
  45         /* Check if the caller has specified an invalid thread: */
  46         if (pthread == NULL || pthread->magic != PTHREAD_MAGIC)
  47                 /* Invalid thread: */
  48                 return(EINVAL);
  49
  50         /* Check if the caller has specified itself: */
  51         if (pthread == _thread_run)
  52                 /* Avoid a deadlock condition: */
  53                 return(EDEADLK);
  54
  55         /*
  56          * Find the thread in the list of active threads or in the
  57          * list of dead threads:
  58          */
  59         if (_find_thread(pthread) == 0 ||
  60             _find_dead_thread(pthread) == 0)
  61                 pthread1  = pthread;
  62
  63         if (pthread1 == NULL)
  64                 /* Return an error: */
  65                 ret = ESRCH;
  66
  67         /* Check if this thread has been detached: */
  68         else if ((pthread->attr.flags & PTHREAD_DETACHED) != 0)
  69                 /* Return an error: */
  70                 ret = ESRCH;
  71
  72         /* Check if the thread is not dead: */
  73         else if (pthread->state != PS_DEAD) {
  74                 /* Add the running thread to the join queue: */
  75                 TAILQ_INSERT_TAIL(&(pthread->join_queue), _thread_run, qe);
  76
  77                 /* Schedule the next thread: */
  78                 _thread_kern_sched_state(PS_JOIN, __FILE__, __LINE__);
  79
  80                 /* Check if the thread is not detached: */
  81                 if ((pthread->attr.flags & PTHREAD_DETACHED) == 0) {
  82                         /* Check if the return value is required: */
  83                         if (thread_return)
  84                                 /* Return the thread's return value: */
  85                                 *thread_return = pthread->ret;
  86                 }
  87                 else
  88                         /* Return an error: */
  89                         ret = ESRCH;
  90
  91         /* Check if the return value is required: */
  92         } else if (thread_return != NULL)
  93                 /* Return the thread's return value: */
  94                 *thread_return = pthread->ret;
  95
  96         /* Return the completion status: */
  97         return (ret);
  98 }
  99 #endif