1062c5bc4SJason Schmidlapp /*
2062c5bc4SJason Schmidlapp * pthread_detach.c
3062c5bc4SJason Schmidlapp *
4062c5bc4SJason Schmidlapp * Description:
5062c5bc4SJason Schmidlapp * This translation unit implements functions related to thread
6062c5bc4SJason Schmidlapp * synchronisation.
7062c5bc4SJason Schmidlapp *
8062c5bc4SJason Schmidlapp * --------------------------------------------------------------------------
9062c5bc4SJason Schmidlapp *
10062c5bc4SJason Schmidlapp * Pthreads-embedded (PTE) - POSIX Threads Library for embedded systems
11062c5bc4SJason Schmidlapp * Copyright(C) 2008 Jason Schmidlapp
12062c5bc4SJason Schmidlapp *
13062c5bc4SJason Schmidlapp * Contact Email: jschmidlapp@users.sourceforge.net
14062c5bc4SJason Schmidlapp *
15062c5bc4SJason Schmidlapp *
16062c5bc4SJason Schmidlapp * Based upon Pthreads-win32 - POSIX Threads Library for Win32
17062c5bc4SJason Schmidlapp * Copyright(C) 1998 John E. Bossom
18062c5bc4SJason Schmidlapp * Copyright(C) 1999,2005 Pthreads-win32 contributors
19062c5bc4SJason Schmidlapp *
20062c5bc4SJason Schmidlapp * Contact Email: rpj@callisto.canberra.edu.au
21062c5bc4SJason Schmidlapp *
22062c5bc4SJason Schmidlapp * The original list of contributors to the Pthreads-win32 project
23062c5bc4SJason Schmidlapp * is contained in the file CONTRIBUTORS.ptw32 included with the
24062c5bc4SJason Schmidlapp * source code distribution. The list can also be seen at the
25062c5bc4SJason Schmidlapp * following World Wide Web location:
26062c5bc4SJason Schmidlapp * http://sources.redhat.com/pthreads-win32/contributors.html
27062c5bc4SJason Schmidlapp *
28062c5bc4SJason Schmidlapp * This library is free software; you can redistribute it and/or
29062c5bc4SJason Schmidlapp * modify it under the terms of the GNU Lesser General Public
30062c5bc4SJason Schmidlapp * License as published by the Free Software Foundation; either
31062c5bc4SJason Schmidlapp * version 2 of the License, or (at your option) any later version.
32062c5bc4SJason Schmidlapp *
33062c5bc4SJason Schmidlapp * This library is distributed in the hope that it will be useful,
34062c5bc4SJason Schmidlapp * but WITHOUT ANY WARRANTY; without even the implied warranty of
35062c5bc4SJason Schmidlapp * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
36062c5bc4SJason Schmidlapp * Lesser General Public License for more details.
37062c5bc4SJason Schmidlapp *
38062c5bc4SJason Schmidlapp * You should have received a copy of the GNU Lesser General Public
39062c5bc4SJason Schmidlapp * License along with this library in the file COPYING.LIB;
40062c5bc4SJason Schmidlapp * if not, write to the Free Software Foundation, Inc.,
41062c5bc4SJason Schmidlapp * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA
42062c5bc4SJason Schmidlapp */
43062c5bc4SJason Schmidlapp
44062c5bc4SJason Schmidlapp #include <pte_osal.h>
45062c5bc4SJason Schmidlapp
46062c5bc4SJason Schmidlapp #include "pthread.h"
47062c5bc4SJason Schmidlapp #include "implement.h"
48062c5bc4SJason Schmidlapp
49062c5bc4SJason Schmidlapp int
pthread_detach(pthread_t thread)50062c5bc4SJason Schmidlapp pthread_detach (pthread_t thread)
51062c5bc4SJason Schmidlapp /*
52062c5bc4SJason Schmidlapp * ------------------------------------------------------
53062c5bc4SJason Schmidlapp * DOCPUBLIC
54062c5bc4SJason Schmidlapp * This function detaches the given thread.
55062c5bc4SJason Schmidlapp *
56062c5bc4SJason Schmidlapp * PARAMETERS
57062c5bc4SJason Schmidlapp * thread
58062c5bc4SJason Schmidlapp * an instance of a pthread_t
59062c5bc4SJason Schmidlapp *
60062c5bc4SJason Schmidlapp *
61062c5bc4SJason Schmidlapp * DESCRIPTION
62062c5bc4SJason Schmidlapp * This function detaches the given thread. You may use it to
63062c5bc4SJason Schmidlapp * detach the main thread or to detach a joinable thread.
64062c5bc4SJason Schmidlapp * NOTE: detached threads cannot be joined;
65062c5bc4SJason Schmidlapp * storage is freed immediately on termination.
66062c5bc4SJason Schmidlapp *
67062c5bc4SJason Schmidlapp * RESULTS
68062c5bc4SJason Schmidlapp * 0 successfully detached the thread,
69062c5bc4SJason Schmidlapp * EINVAL thread is not a joinable thread,
70062c5bc4SJason Schmidlapp * ENOSPC a required resource has been exhausted,
71062c5bc4SJason Schmidlapp * ESRCH no thread could be found for 'thread',
72062c5bc4SJason Schmidlapp *
73062c5bc4SJason Schmidlapp * ------------------------------------------------------
74062c5bc4SJason Schmidlapp */
75062c5bc4SJason Schmidlapp {
76062c5bc4SJason Schmidlapp int result;
77062c5bc4SJason Schmidlapp unsigned char destroyIt = PTE_FALSE;
78*a12978ccSJeremy Soller pte_thread_t * tp = (pte_thread_t *) thread;
79062c5bc4SJason Schmidlapp
80062c5bc4SJason Schmidlapp
81062c5bc4SJason Schmidlapp pte_osMutexLock (pte_thread_reuse_lock);
82062c5bc4SJason Schmidlapp
83*a12978ccSJeremy Soller if (NULL == tp)
84062c5bc4SJason Schmidlapp {
85062c5bc4SJason Schmidlapp result = ESRCH;
86062c5bc4SJason Schmidlapp }
87062c5bc4SJason Schmidlapp else if (PTHREAD_CREATE_DETACHED == tp->detachState)
88062c5bc4SJason Schmidlapp {
89062c5bc4SJason Schmidlapp result = EINVAL;
90062c5bc4SJason Schmidlapp }
91062c5bc4SJason Schmidlapp else
92062c5bc4SJason Schmidlapp {
93062c5bc4SJason Schmidlapp /*
94062c5bc4SJason Schmidlapp * Joinable pte_thread_t structs are not scavenged until
95062c5bc4SJason Schmidlapp * a join or detach is done. The thread may have exited already,
96062c5bc4SJason Schmidlapp * but all of the state and locks etc are still there.
97062c5bc4SJason Schmidlapp */
98062c5bc4SJason Schmidlapp result = 0;
99062c5bc4SJason Schmidlapp
100062c5bc4SJason Schmidlapp if (pthread_mutex_lock (&tp->cancelLock) == 0)
101062c5bc4SJason Schmidlapp {
102062c5bc4SJason Schmidlapp if (tp->state != PThreadStateLast)
103062c5bc4SJason Schmidlapp {
104062c5bc4SJason Schmidlapp tp->detachState = PTHREAD_CREATE_DETACHED;
105062c5bc4SJason Schmidlapp }
106062c5bc4SJason Schmidlapp else if (tp->detachState != PTHREAD_CREATE_DETACHED)
107062c5bc4SJason Schmidlapp {
108062c5bc4SJason Schmidlapp /*
109062c5bc4SJason Schmidlapp * Thread is joinable and has exited or is exiting.
110062c5bc4SJason Schmidlapp */
111062c5bc4SJason Schmidlapp destroyIt = PTE_TRUE;
112062c5bc4SJason Schmidlapp }
113062c5bc4SJason Schmidlapp (void) pthread_mutex_unlock (&tp->cancelLock);
114062c5bc4SJason Schmidlapp }
115062c5bc4SJason Schmidlapp else
116062c5bc4SJason Schmidlapp {
117062c5bc4SJason Schmidlapp /* cancelLock shouldn't fail, but if it does ... */
118062c5bc4SJason Schmidlapp result = ESRCH;
119062c5bc4SJason Schmidlapp }
120062c5bc4SJason Schmidlapp }
121062c5bc4SJason Schmidlapp
122062c5bc4SJason Schmidlapp pte_osMutexUnlock(pte_thread_reuse_lock);
123062c5bc4SJason Schmidlapp
124062c5bc4SJason Schmidlapp if (result == 0)
125062c5bc4SJason Schmidlapp {
126062c5bc4SJason Schmidlapp /* Thread is joinable */
127062c5bc4SJason Schmidlapp
128062c5bc4SJason Schmidlapp if (destroyIt)
129062c5bc4SJason Schmidlapp {
130062c5bc4SJason Schmidlapp /* The thread has exited or is exiting but has not been joined or
131062c5bc4SJason Schmidlapp * detached. Need to wait in case it's still exiting.
132062c5bc4SJason Schmidlapp */
133062c5bc4SJason Schmidlapp pte_osThreadWaitForEnd(tp->threadId);
134062c5bc4SJason Schmidlapp
135062c5bc4SJason Schmidlapp pte_threadDestroy (thread);
136062c5bc4SJason Schmidlapp }
137062c5bc4SJason Schmidlapp }
138062c5bc4SJason Schmidlapp
139062c5bc4SJason Schmidlapp return (result);
140062c5bc4SJason Schmidlapp
141062c5bc4SJason Schmidlapp } /* pthread_detach */
142