2 * Copyright (c) 1995-1998 John Birrell <jb@cimlogic.com.au>
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
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.
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
32 * $FreeBSD: src/lib/libpthread/thread/thr_exit.c,v 1.39 2004/10/23 23:37:54 davidxu Exp $
33 * $DragonFly: src/lib/libthread_xu/thread/thr_exit.c,v 1.5 2006/04/05 00:24:36 davidxu Exp $
36 #include <machine/tls.h>
45 #include "thr_private.h"
47 void _pthread_exit(void *status);
50 _thread_exit(char *fname, int lineno, char *msg)
53 /* Write an error message to the standard error file descriptor: */
55 "Fatal error '%s' at line %d in file %s (errno = %d)\n",
56 msg, lineno, fname, errno);
62 * Only called when a thread is cancelled. It may be more useful
63 * to call it from pthread_exit() if other ways of asynchronous or
64 * abnormal thread termination can be found.
67 _thr_exit_cleanup(void)
69 struct pthread *curthread = tls_get_curthread();
72 * POSIX states that cancellation/termination of a thread should
73 * not release any visible resources (such as mutexes) and that
74 * it is the applications responsibility. Resources that are
75 * internal to the threads library, including file and fd locks,
76 * are not visible to the application and need to be released.
78 /* Unlock all private mutexes: */
79 _mutex_unlock_private(curthread);
82 * This still isn't quite correct because we don't account
83 * for held spinlocks (see libc/stdlib/malloc.c).
88 _pthread_exit(void *status)
90 struct pthread *curthread = tls_get_curthread();
92 /* Check if this thread is already in the process of exiting: */
93 if ((curthread->cancelflags & THR_CANCEL_EXITING) != 0) {
95 snprintf(msg, sizeof(msg), "Thread %p has called "
96 "pthread_exit() from a destructor. POSIX 1003.1 "
97 "1996 s16.2.5.2 does not allow this!", curthread);
101 /* Flag this thread as exiting. */
102 atomic_set_int(&curthread->cancelflags, THR_CANCEL_EXITING);
106 /* Save the return value: */
107 curthread->ret = status;
108 while (curthread->cleanup != NULL) {
109 pthread_cleanup_pop(1);
111 if (curthread->attr.cleanup_attr != NULL) {
112 curthread->attr.cleanup_attr(curthread->attr.arg_attr);
114 /* Check if there is thread specific data: */
115 if (curthread->specific != NULL) {
116 /* Run the thread-specific data destructors: */
117 _thread_cleanupspecific();
120 if (!_thr_isthreaded())
123 THREAD_LIST_LOCK(curthread);
124 _thread_active_threads--;
125 if (_thread_active_threads == 0) {
126 THREAD_LIST_UNLOCK(curthread);
131 curthread->state = PS_DEAD;
132 THR_UNLOCK(curthread);
133 curthread->refcount--;
134 if (curthread->tlflags & TLFLAGS_DETACHED)
135 THR_GCLIST_ADD(curthread);
136 THREAD_LIST_UNLOCK(curthread);
137 if (curthread->joiner)
138 _thr_umtx_wake(&curthread->state, INT_MAX);
141 * All the code is incorrect on DragonFly.
142 * DragonFly has race condition here. it should provide
143 * an interface to tell userland that a thread is now
144 * in kernel, and userland stack can be safely recycled
145 * by userland GC code.
147 curthread->terminated = 1;
148 if (SHOULD_REPORT_EVENT(curthread, TD_DEATH))
149 _thr_report_death(curthread);
151 PANIC("thr_exit() returned");
155 __strong_reference(_pthread_exit, pthread_exit);