Home | History | Annotate | Download | only in pthreads-win32 
      1 /*
      2  * pthread_detach.c
      3  *
      4  * Description:
      5  * This translation unit implements functions related to thread
      6  * synchronisation.
      7  *
      8  * --------------------------------------------------------------------------
      9  *
     10  *      Pthreads-win32 - POSIX Threads Library for Win32
     11  *      Copyright(C) 1998 John E. Bossom
     12  *      Copyright(C) 1999,2005 Pthreads-win32 contributors
     13  *
     14  *      Contact Email: rpj (at) callisto.canberra.edu.au
     15  *
     16  *      The current list of contributors is contained
     17  *      in the file CONTRIBUTORS included with the source
     18  *      code distribution. The list can also be seen at the
     19  *      following World Wide Web location:
     20  *      http://sources.redhat.com/pthreads-win32/contributors.html
     21  *
     22  *      This library is free software; you can redistribute it and/or
     23  *      modify it under the terms of the GNU Lesser General Public
     24  *      License as published by the Free Software Foundation; either
     25  *      version 2 of the License, or (at your option) any later version.
     26  *
     27  *      This library is distributed in the hope that it will be useful,
     28  *      but WITHOUT ANY WARRANTY; without even the implied warranty of
     29  *      MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
     30  *      Lesser General Public License for more details.
     31  *
     32  *      You should have received a copy of the GNU Lesser General Public
     33  *      License along with this library in the file COPYING.LIB;
     34  *      if not, write to the Free Software Foundation, Inc.,
     35  *      59 Temple Place - Suite 330, Boston, MA 02111-1307, USA
     36  */
     37 
     38 #include "pthread.h"
     39 #include "implement.h"
     40 
     41 /*
     42  * Not needed yet, but defining it should indicate clashes with build target
     43  * environment that should be fixed.
     44  */
     45 #if !defined(WINCE)
     46 #  include <signal.h>
     47 #endif
     48 
     49 
     50 int
     51 pthread_detach (pthread_t thread)
     52      /*
     53       * ------------------------------------------------------
     54       * DOCPUBLIC
     55       *      This function detaches the given thread.
     56       *
     57       * PARAMETERS
     58       *      thread
     59       *              an instance of a pthread_t
     60       *
     61       *
     62       * DESCRIPTION
     63       *      This function detaches the given thread. You may use it to
     64       *      detach the main thread or to detach a joinable thread.
     65       *      NOTE:   detached threads cannot be joined;
     66       *              storage is freed immediately on termination.
     67       *
     68       * RESULTS
     69       *              0               successfully detached the thread,
     70       *              EINVAL          thread is not a joinable thread,
     71       *              ENOSPC          a required resource has been exhausted,
     72       *              ESRCH           no thread could be found for 'thread',
     73       *
     74       * ------------------------------------------------------
     75       */
     76 {
     77   int result;
     78   BOOL destroyIt = PTW32_FALSE;
     79   ptw32_thread_t * tp = (ptw32_thread_t *) thread.p;
     80   ptw32_mcs_local_node_t node;
     81 
     82   ptw32_mcs_lock_acquire(&ptw32_thread_reuse_lock, &node);
     83 
     84   if (NULL == tp
     85       || thread.x != tp->ptHandle.x)
     86     {
     87       result = ESRCH;
     88     }
     89   else if (PTHREAD_CREATE_DETACHED == tp->detachState)
     90     {
     91       result = EINVAL;
     92     }
     93   else
     94     {
     95       ptw32_mcs_local_node_t stateLock;
     96       /*
     97        * Joinable ptw32_thread_t structs are not scavenged until
     98        * a join or detach is done. The thread may have exited already,
     99        * but all of the state and locks etc are still there.
    100        */
    101       result = 0;
    102 
    103       ptw32_mcs_lock_acquire (&tp->stateLock, &stateLock);
    104       if (tp->state != PThreadStateLast)
    105         {
    106           tp->detachState = PTHREAD_CREATE_DETACHED;
    107         }
    108       else if (tp->detachState != PTHREAD_CREATE_DETACHED)
    109         {
    110           /*
    111            * Thread is joinable and has exited or is exiting.
    112            */
    113           destroyIt = PTW32_TRUE;
    114         }
    115       ptw32_mcs_lock_release (&stateLock);
    116     }
    117 
    118   ptw32_mcs_lock_release(&node);
    119 
    120   if (result == 0)
    121     {
    122       /* Thread is joinable */
    123 
    124       if (destroyIt)
    125 	{
    126 	  /* The thread has exited or is exiting but has not been joined or
    127 	   * detached. Need to wait in case it's still exiting.
    128 	   */
    129 	  (void) WaitForSingleObject(tp->threadH, INFINITE);
    130 	  ptw32_threadDestroy (thread);
    131 	}
    132     }
    133 
    134   return (result);
    135 
    136 }				/* pthread_detach */
    137