2003-04-01 05:46:29 +02:00
|
|
|
/*
|
|
|
|
* Copyright (c) 1995-1998 John Birrell <jb@cimlogic.com.au>
|
|
|
|
* All rights reserved.
|
|
|
|
*
|
|
|
|
* Redistribution and use in source and binary forms, with or without
|
|
|
|
* modification, are permitted provided that the following conditions
|
|
|
|
* are met:
|
|
|
|
* 1. Redistributions of source code must retain the above copyright
|
|
|
|
* notice, this list of conditions and the following disclaimer.
|
|
|
|
* 2. Redistributions in binary form must reproduce the above copyright
|
|
|
|
* notice, this list of conditions and the following disclaimer in the
|
|
|
|
* documentation and/or other materials provided with the distribution.
|
2007-01-12 08:26:21 +01:00
|
|
|
* 3. Neither the name of the author nor the names of any co-contributors
|
2003-04-01 05:46:29 +02:00
|
|
|
* may be used to endorse or promote products derived from this software
|
|
|
|
* without specific prior written permission.
|
|
|
|
*
|
|
|
|
* THIS SOFTWARE IS PROVIDED BY JOHN BIRRELL AND CONTRIBUTORS ``AS IS'' AND
|
|
|
|
* ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
|
|
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
|
|
|
* ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
|
|
|
|
* FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
|
|
|
* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
|
|
|
* OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
|
|
|
* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
|
|
|
* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
|
|
|
|
* OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
|
|
|
* SUCH DAMAGE.
|
|
|
|
*
|
|
|
|
* $FreeBSD$
|
|
|
|
*/
|
2005-04-02 03:20:00 +02:00
|
|
|
|
2003-04-01 05:46:29 +02:00
|
|
|
#include <errno.h>
|
|
|
|
#include <stdio.h>
|
|
|
|
#include <stdlib.h>
|
|
|
|
#include <pthread.h>
|
2005-04-02 03:20:00 +02:00
|
|
|
|
2003-04-01 05:46:29 +02:00
|
|
|
#include "thr_private.h"
|
|
|
|
|
2005-04-02 03:20:00 +02:00
|
|
|
void _pthread_exit(void *status);
|
2003-04-01 05:46:29 +02:00
|
|
|
|
2005-04-02 03:20:00 +02:00
|
|
|
__weak_reference(_pthread_exit, pthread_exit);
|
2004-03-28 16:05:28 +02:00
|
|
|
|
2003-04-01 05:46:29 +02:00
|
|
|
void
|
2006-04-04 04:57:49 +02:00
|
|
|
_thread_exit(const char *fname, int lineno, const char *msg)
|
2003-04-01 05:46:29 +02:00
|
|
|
{
|
|
|
|
|
2005-04-02 03:20:00 +02:00
|
|
|
/* Write an error message to the standard error file descriptor: */
|
|
|
|
_thread_printf(2,
|
2003-04-01 05:46:29 +02:00
|
|
|
"Fatal error '%s' at line %d in file %s (errno = %d)\n",
|
2005-04-02 03:20:00 +02:00
|
|
|
msg, lineno, fname, errno);
|
2003-04-01 05:46:29 +02:00
|
|
|
|
|
|
|
abort();
|
|
|
|
}
|
|
|
|
|
|
|
|
/*
|
|
|
|
* Only called when a thread is cancelled. It may be more useful
|
|
|
|
* to call it from pthread_exit() if other ways of asynchronous or
|
|
|
|
* abnormal thread termination can be found.
|
|
|
|
*/
|
|
|
|
void
|
2005-04-02 03:20:00 +02:00
|
|
|
_thr_exit_cleanup(void)
|
2003-04-01 05:46:29 +02:00
|
|
|
{
|
2005-04-02 03:20:00 +02:00
|
|
|
struct pthread *curthread = _get_curthread();
|
|
|
|
|
2003-04-01 05:46:29 +02:00
|
|
|
/*
|
|
|
|
* POSIX states that cancellation/termination of a thread should
|
|
|
|
* not release any visible resources (such as mutexes) and that
|
|
|
|
* it is the applications responsibility. Resources that are
|
|
|
|
* internal to the threads library, including file and fd locks,
|
|
|
|
* are not visible to the application and need to be released.
|
|
|
|
*/
|
|
|
|
/* Unlock all private mutexes: */
|
|
|
|
_mutex_unlock_private(curthread);
|
|
|
|
|
|
|
|
/*
|
|
|
|
* This still isn't quite correct because we don't account
|
|
|
|
* for held spinlocks (see libc/stdlib/malloc.c).
|
|
|
|
*/
|
|
|
|
}
|
|
|
|
|
|
|
|
void
|
|
|
|
_pthread_exit(void *status)
|
|
|
|
{
|
2005-04-02 03:20:00 +02:00
|
|
|
struct pthread *curthread = _get_curthread();
|
Make libthr async-signal-safe without costly signal masking. The guidlines I
followed are: Only 3 functions (pthread_cancel, pthread_setcancelstate,
pthread_setcanceltype) are required to be async-signal-safe by POSIX. None of
the rest of the pthread api is required to be async-signal-safe. This means
that only the three mentioned functions are safe to use from inside
signal handlers.
However, there are certain system/libc calls that are
cancellation points that a caller may call from within a signal handler,
and since they are cancellation points calls have to be made into libthr
to test for cancellation and exit the thread if necessary. So, the
cancellation test and thread exit code paths must be async-signal-safe
as well. A summary of the changes follows:
o Almost all of the code paths that masked signals, as well as locking the
pthread structure now lock only the pthread structure.
o Signals are masked (and left that way) as soon as a thread enters
pthread_exit().
o The active and dead threads locks now explicitly require that signals
are masked.
o Access to the isdead field of the pthread structure is protected by both
the active and dead list locks for writing. Either one is sufficient for
reading.
o The thread state and type fields have been combined into one three-state
switch to make it easier to read without requiring a lock. It doesn't need
a lock for writing (and therefore for reading either) because only the
current thread can write to it and it is an integer value.
o The thread state field of the pthread structure has been eliminated. It
was an unnecessary field that mostly duplicated the flags field, but
required additional locking that would make a lot more code paths require
signal masking. Any truly unique values (such as PS_DEAD) have been
reborn as separate members of the pthread structure.
o Since the mutex and condvar pthread functions are not async-signal-safe
there is no need to muck about with the wait queues when handling
a signal ...
o ... which also removes the need for wrapping signal handlers and sigaction(2).
o The condvar and mutex async-cancellation code had to be revised as a result
of some of these changes, which resulted in semi-unrelated changes which
would have been difficult to work on as a separate commit, so they are
included as well.
The only part of the changes I am worried about is related to locking for
the pthread joining fields. But, I will take a closer look at them once this
mega-patch is committed.
2004-05-20 14:06:16 +02:00
|
|
|
|
2003-04-01 05:46:29 +02:00
|
|
|
/* Check if this thread is already in the process of exiting: */
|
2006-11-24 10:57:38 +01:00
|
|
|
if (curthread->cancelling) {
|
2003-04-01 05:46:29 +02:00
|
|
|
char msg[128];
|
2005-04-02 03:20:00 +02:00
|
|
|
snprintf(msg, sizeof(msg), "Thread %p has called "
|
|
|
|
"pthread_exit() from a destructor. POSIX 1003.1 "
|
|
|
|
"1996 s16.2.5.2 does not allow this!", curthread);
|
2003-04-01 05:46:29 +02:00
|
|
|
PANIC(msg);
|
|
|
|
}
|
|
|
|
|
2005-04-02 03:20:00 +02:00
|
|
|
/* Flag this thread as exiting. */
|
2006-11-24 10:57:38 +01:00
|
|
|
curthread->cancelling = 1;
|
2005-04-02 03:20:00 +02:00
|
|
|
|
|
|
|
_thr_exit_cleanup();
|
2003-04-01 05:46:29 +02:00
|
|
|
|
|
|
|
/* Save the return value: */
|
|
|
|
curthread->ret = status;
|
|
|
|
while (curthread->cleanup != NULL) {
|
|
|
|
pthread_cleanup_pop(1);
|
|
|
|
}
|
2006-04-04 04:57:49 +02:00
|
|
|
|
2003-04-01 05:46:29 +02:00
|
|
|
/* Check if there is thread specific data: */
|
|
|
|
if (curthread->specific != NULL) {
|
|
|
|
/* Run the thread-specific data destructors: */
|
|
|
|
_thread_cleanupspecific();
|
|
|
|
}
|
|
|
|
|
2005-04-02 03:20:00 +02:00
|
|
|
if (!_thr_isthreaded())
|
2003-05-23 10:13:24 +02:00
|
|
|
exit(0);
|
2003-05-21 05:29:18 +02:00
|
|
|
|
2005-04-02 03:20:00 +02:00
|
|
|
THREAD_LIST_LOCK(curthread);
|
|
|
|
_thread_active_threads--;
|
|
|
|
if (_thread_active_threads == 0) {
|
|
|
|
THREAD_LIST_UNLOCK(curthread);
|
|
|
|
exit(0);
|
|
|
|
/* Never reach! */
|
2004-03-28 16:05:28 +02:00
|
|
|
}
|
2006-01-05 14:51:22 +01:00
|
|
|
THR_LOCK(curthread);
|
|
|
|
curthread->state = PS_DEAD;
|
|
|
|
THR_UNLOCK(curthread);
|
|
|
|
/*
|
|
|
|
* Thread was created with initial refcount 1, we drop the
|
|
|
|
* reference count to allow it to be garbage collected.
|
|
|
|
*/
|
|
|
|
curthread->refcount--;
|
2005-04-02 03:20:00 +02:00
|
|
|
if (curthread->tlflags & TLFLAGS_DETACHED)
|
|
|
|
THR_GCLIST_ADD(curthread);
|
|
|
|
THREAD_LIST_UNLOCK(curthread);
|
2005-04-12 05:00:28 +02:00
|
|
|
if (SHOULD_REPORT_EVENT(curthread, TD_DEATH))
|
|
|
|
_thr_report_death(curthread);
|
2005-10-26 09:11:43 +02:00
|
|
|
|
|
|
|
/*
|
|
|
|
* Kernel will do wakeup at the address, so joiner thread
|
|
|
|
* will be resumed if it is sleeping at the address.
|
|
|
|
*/
|
2005-04-12 05:00:28 +02:00
|
|
|
thr_exit(&curthread->tid);
|
2005-04-02 03:20:00 +02:00
|
|
|
PANIC("thr_exit() returned");
|
|
|
|
/* Never reach! */
|
2004-03-28 16:05:28 +02:00
|
|
|
}
|