1996-01-22 00:23:58 +00:00
|
|
|
/*
|
1998-04-29 09:59:34 +00:00
|
|
|
* Copyright (c) 1995-1998 John Birrell <jb@cimlogic.com.au>
|
1996-01-22 00:23:58 +00:00
|
|
|
* 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.
|
|
|
|
* 3. All advertising materials mentioning features or use of this software
|
|
|
|
* must display the following acknowledgement:
|
|
|
|
* This product includes software developed by John Birrell.
|
|
|
|
* 4. Neither the name of the author nor the names of any co-contributors
|
|
|
|
* 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
|
1999-08-05 12:15:30 +00:00
|
|
|
* ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
|
1996-01-22 00:23:58 +00:00
|
|
|
* 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.
|
|
|
|
*
|
1999-08-28 00:22:10 +00:00
|
|
|
* $FreeBSD$
|
1996-01-22 00:23:58 +00:00
|
|
|
*/
|
|
|
|
#include <errno.h>
|
|
|
|
#include <stdlib.h>
|
|
|
|
#include <string.h>
|
|
|
|
#include <fcntl.h>
|
|
|
|
#include <unistd.h>
|
|
|
|
#include <sys/time.h>
|
1999-07-05 00:35:19 +00:00
|
|
|
#include <sys/types.h>
|
|
|
|
#include <sys/mman.h>
|
1996-01-22 00:23:58 +00:00
|
|
|
#ifdef _THREAD_SAFE
|
|
|
|
#include <machine/reg.h>
|
|
|
|
#include <pthread.h>
|
|
|
|
#include "pthread_private.h"
|
1998-04-11 07:47:22 +00:00
|
|
|
#include "libc_private.h"
|
1996-01-22 00:23:58 +00:00
|
|
|
|
|
|
|
int
|
1998-04-29 09:59:34 +00:00
|
|
|
pthread_create(pthread_t * thread, const pthread_attr_t * attr,
|
|
|
|
void *(*start_routine) (void *), void *arg)
|
1996-01-22 00:23:58 +00:00
|
|
|
{
|
1998-09-30 06:36:56 +00:00
|
|
|
int f_gc = 0;
|
1996-01-22 00:23:58 +00:00
|
|
|
int ret = 0;
|
1998-09-30 06:36:56 +00:00
|
|
|
pthread_t gc_thread;
|
1996-01-22 00:23:58 +00:00
|
|
|
pthread_t new_thread;
|
1996-08-20 08:22:01 +00:00
|
|
|
pthread_attr_t pattr;
|
1996-01-22 00:23:58 +00:00
|
|
|
void *stack;
|
|
|
|
|
1998-04-29 09:59:34 +00:00
|
|
|
/*
|
|
|
|
* Locking functions in libc are required when there are
|
|
|
|
* threads other than the initial thread.
|
|
|
|
*/
|
|
|
|
__isthreaded = 1;
|
1996-01-22 00:23:58 +00:00
|
|
|
|
|
|
|
/* Allocate memory for the thread structure: */
|
|
|
|
if ((new_thread = (pthread_t) malloc(sizeof(struct pthread))) == NULL) {
|
|
|
|
/* Insufficient memory to create a thread: */
|
|
|
|
ret = EAGAIN;
|
|
|
|
} else {
|
|
|
|
/* Check if default thread attributes are required: */
|
1996-08-20 08:22:01 +00:00
|
|
|
if (attr == NULL || *attr == NULL) {
|
1996-01-22 00:23:58 +00:00
|
|
|
/* Use the default thread attributes: */
|
1996-08-20 08:22:01 +00:00
|
|
|
pattr = &pthread_attr_default;
|
|
|
|
} else {
|
|
|
|
pattr = *attr;
|
1996-01-22 00:23:58 +00:00
|
|
|
}
|
|
|
|
/* Check if a stack was specified in the thread attributes: */
|
1996-08-20 08:22:01 +00:00
|
|
|
if ((stack = pattr->stackaddr_attr) != NULL) {
|
1996-01-22 00:23:58 +00:00
|
|
|
}
|
1999-07-05 00:35:19 +00:00
|
|
|
/* Allocate memory for a default-size stack: */
|
|
|
|
else if (pattr->stacksize_attr == PTHREAD_STACK_DEFAULT) {
|
1999-07-11 06:06:52 +00:00
|
|
|
struct stack *spare_stack;
|
1999-07-05 00:35:19 +00:00
|
|
|
|
|
|
|
/* Allocate or re-use a default-size stack. */
|
|
|
|
|
1999-07-11 05:56:37 +00:00
|
|
|
/*
|
|
|
|
* Use the garbage collector mutex for synchronization
|
1999-07-05 00:35:19 +00:00
|
|
|
* of the spare stack list.
|
1999-07-11 05:56:37 +00:00
|
|
|
*/
|
1999-07-05 00:35:19 +00:00
|
|
|
if (pthread_mutex_lock(&_gc_mutex) != 0)
|
|
|
|
PANIC("Cannot lock gc mutex");
|
|
|
|
|
1999-07-11 05:56:37 +00:00
|
|
|
if ((spare_stack = SLIST_FIRST(&_stackq)) != NULL) {
|
1999-07-05 00:35:19 +00:00
|
|
|
/* Use the spare stack. */
|
|
|
|
SLIST_REMOVE_HEAD(&_stackq, qe);
|
1999-07-11 05:56:37 +00:00
|
|
|
|
|
|
|
/* Unlock the garbage collector mutex. */
|
|
|
|
if (pthread_mutex_unlock(&_gc_mutex) != 0)
|
|
|
|
PANIC("Cannot unlock gc mutex");
|
|
|
|
|
|
|
|
stack = sizeof(struct stack)
|
|
|
|
+ (void *) spare_stack
|
|
|
|
- PTHREAD_STACK_DEFAULT;
|
1999-07-05 00:35:19 +00:00
|
|
|
} else {
|
1999-07-11 05:56:37 +00:00
|
|
|
/* Unlock the garbage collector mutex. */
|
|
|
|
if (pthread_mutex_unlock(&_gc_mutex) != 0)
|
|
|
|
PANIC("Cannot unlock gc mutex");
|
|
|
|
|
1999-07-05 00:35:19 +00:00
|
|
|
/* Allocate a new stack. */
|
|
|
|
stack = _next_stack + PTHREAD_STACK_GUARD;
|
1999-07-11 05:56:37 +00:00
|
|
|
/*
|
|
|
|
* Even if stack allocation fails, we don't want
|
|
|
|
* to try to use this location again, so
|
|
|
|
* unconditionally decrement _next_stack. Under
|
|
|
|
* normal operating conditions, the most likely
|
|
|
|
* reason for an mmap() error is a stack
|
|
|
|
* overflow of the adjacent thread stack.
|
|
|
|
*/
|
|
|
|
_next_stack -= (PTHREAD_STACK_DEFAULT
|
|
|
|
+ PTHREAD_STACK_GUARD);
|
1999-07-05 00:35:19 +00:00
|
|
|
|
|
|
|
/* Red zone: */
|
1999-07-11 05:56:37 +00:00
|
|
|
if (mmap(_next_stack, PTHREAD_STACK_GUARD, 0,
|
|
|
|
MAP_ANON, -1, 0) == MAP_FAILED) {
|
1999-07-05 00:35:19 +00:00
|
|
|
ret = EAGAIN;
|
|
|
|
free(new_thread);
|
|
|
|
}
|
|
|
|
/* Stack: */
|
1999-07-11 05:56:37 +00:00
|
|
|
else if (mmap(stack,
|
|
|
|
PTHREAD_STACK_DEFAULT,
|
|
|
|
PROT_READ | PROT_WRITE,
|
|
|
|
#ifdef __i386__
|
|
|
|
MAP_STACK,
|
|
|
|
#else
|
|
|
|
MAP_ANON,
|
|
|
|
#endif
|
|
|
|
-1, 0) == MAP_FAILED) {
|
1999-07-05 00:35:19 +00:00
|
|
|
ret = EAGAIN;
|
1999-07-11 05:56:37 +00:00
|
|
|
munmap(_next_stack,
|
|
|
|
PTHREAD_STACK_GUARD);
|
1999-07-05 00:35:19 +00:00
|
|
|
free(new_thread);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
1999-07-11 05:56:37 +00:00
|
|
|
/*
|
|
|
|
* The user wants a stack of a particular size. Lets hope they
|
|
|
|
* really know what they want, and simply malloc the stack.
|
|
|
|
*/
|
|
|
|
else if ((stack = (void *) malloc(pattr->stacksize_attr))
|
|
|
|
== NULL) {
|
1999-07-05 00:35:19 +00:00
|
|
|
/* Insufficient memory to create a thread: */
|
|
|
|
ret = EAGAIN;
|
|
|
|
free(new_thread);
|
|
|
|
}
|
1999-07-11 05:56:37 +00:00
|
|
|
|
1996-01-22 00:23:58 +00:00
|
|
|
/* Check for errors: */
|
|
|
|
if (ret != 0) {
|
|
|
|
} else {
|
|
|
|
/* Initialise the thread structure: */
|
|
|
|
memset(new_thread, 0, sizeof(struct pthread));
|
|
|
|
new_thread->slice_usec = -1;
|
|
|
|
new_thread->sig_saved = 0;
|
|
|
|
new_thread->stack = stack;
|
|
|
|
new_thread->start_routine = start_routine;
|
|
|
|
new_thread->arg = arg;
|
1998-04-04 07:27:29 +00:00
|
|
|
|
1999-11-28 05:38:13 +00:00
|
|
|
new_thread->cancelflags = PTHREAD_CANCEL_ENABLE |
|
|
|
|
PTHREAD_CANCEL_DEFERRED;
|
|
|
|
|
1998-04-04 07:27:29 +00:00
|
|
|
/*
|
|
|
|
* Write a magic value to the thread structure
|
|
|
|
* to help identify valid ones:
|
|
|
|
*/
|
|
|
|
new_thread->magic = PTHREAD_MAGIC;
|
|
|
|
|
1996-01-22 00:23:58 +00:00
|
|
|
/* Initialise the thread for signals: */
|
|
|
|
new_thread->sigmask = _thread_run->sigmask;
|
|
|
|
|
|
|
|
/* Initialise the jump buffer: */
|
1998-04-29 09:59:34 +00:00
|
|
|
setjmp(new_thread->saved_jmp_buf);
|
1996-01-22 00:23:58 +00:00
|
|
|
|
|
|
|
/*
|
|
|
|
* Set up new stack frame so that it looks like it
|
|
|
|
* returned from a longjmp() to the beginning of
|
1998-04-29 09:59:34 +00:00
|
|
|
* _thread_start().
|
1996-01-22 00:23:58 +00:00
|
|
|
*/
|
|
|
|
#if defined(__FreeBSD__)
|
1998-03-09 04:46:26 +00:00
|
|
|
#if defined(__alpha__)
|
1998-04-29 09:59:34 +00:00
|
|
|
new_thread->saved_jmp_buf[0]._jb[2] = (long) _thread_start;
|
|
|
|
new_thread->saved_jmp_buf[0]._jb[4 + R_RA] = 0;
|
|
|
|
new_thread->saved_jmp_buf[0]._jb[4 + R_T12] = (long) _thread_start;
|
1998-03-09 04:46:26 +00:00
|
|
|
#else
|
1998-04-29 09:59:34 +00:00
|
|
|
new_thread->saved_jmp_buf[0]._jb[0] = (long) _thread_start;
|
1998-03-09 04:46:26 +00:00
|
|
|
#endif
|
1996-01-22 00:23:58 +00:00
|
|
|
#elif defined(__NetBSD__)
|
1998-03-09 04:46:26 +00:00
|
|
|
#if defined(__alpha__)
|
1998-04-29 09:59:34 +00:00
|
|
|
new_thread->saved_jmp_buf[2] = (long) _thread_start;
|
|
|
|
new_thread->saved_jmp_buf[4 + R_RA] = 0;
|
|
|
|
new_thread->saved_jmp_buf[4 + R_T12] = (long) _thread_start;
|
1996-01-22 00:23:58 +00:00
|
|
|
#else
|
1998-04-29 09:59:34 +00:00
|
|
|
new_thread->saved_jmp_buf[0] = (long) _thread_start;
|
1996-01-22 00:23:58 +00:00
|
|
|
#endif
|
|
|
|
#else
|
|
|
|
#error "Don't recognize this operating system!"
|
|
|
|
#endif
|
|
|
|
|
|
|
|
/* The stack starts high and builds down: */
|
|
|
|
#if defined(__FreeBSD__)
|
1998-03-09 04:46:26 +00:00
|
|
|
#if defined(__alpha__)
|
|
|
|
new_thread->saved_jmp_buf[0]._jb[4 + R_SP] = (long) new_thread->stack + pattr->stacksize_attr - sizeof(double);
|
|
|
|
#else
|
1996-08-20 08:22:01 +00:00
|
|
|
new_thread->saved_jmp_buf[0]._jb[2] = (int) (new_thread->stack + pattr->stacksize_attr - sizeof(double));
|
1998-03-09 04:46:26 +00:00
|
|
|
#endif
|
1996-01-22 00:23:58 +00:00
|
|
|
#elif defined(__NetBSD__)
|
1998-03-09 04:46:26 +00:00
|
|
|
#if defined(__alpha__)
|
1996-08-20 08:22:01 +00:00
|
|
|
new_thread->saved_jmp_buf[4 + R_SP] = (long) new_thread->stack + pattr->stacksize_attr - sizeof(double);
|
1996-01-22 00:23:58 +00:00
|
|
|
#else
|
1996-08-20 08:22:01 +00:00
|
|
|
new_thread->saved_jmp_buf[2] = (long) new_thread->stack + pattr->stacksize_attr - sizeof(double);
|
1996-01-22 00:23:58 +00:00
|
|
|
#endif
|
|
|
|
#else
|
|
|
|
#error "Don't recognize this operating system!"
|
|
|
|
#endif
|
|
|
|
|
|
|
|
/* Copy the thread attributes: */
|
1996-08-20 08:22:01 +00:00
|
|
|
memcpy(&new_thread->attr, pattr, sizeof(struct pthread_attr));
|
1996-01-22 00:23:58 +00:00
|
|
|
|
|
|
|
/*
|
|
|
|
* Check if this thread is to inherit the scheduling
|
|
|
|
* attributes from its parent:
|
|
|
|
*/
|
|
|
|
if (new_thread->attr.flags & PTHREAD_INHERIT_SCHED) {
|
|
|
|
/* Copy the scheduling attributes: */
|
1999-07-11 05:56:37 +00:00
|
|
|
new_thread->base_priority
|
|
|
|
= _thread_run->base_priority;
|
|
|
|
new_thread->attr.prio
|
|
|
|
= _thread_run->base_priority;
|
|
|
|
new_thread->attr.sched_policy
|
|
|
|
= _thread_run->attr.sched_policy;
|
1996-01-22 00:23:58 +00:00
|
|
|
} else {
|
|
|
|
/*
|
|
|
|
* Use just the thread priority, leaving the
|
|
|
|
* other scheduling attributes as their
|
|
|
|
* default values:
|
|
|
|
*/
|
1999-07-11 05:56:37 +00:00
|
|
|
new_thread->base_priority
|
|
|
|
= new_thread->attr.prio;
|
1996-01-22 00:23:58 +00:00
|
|
|
}
|
1999-03-23 05:07:56 +00:00
|
|
|
new_thread->active_priority = new_thread->base_priority;
|
|
|
|
new_thread->inherited_priority = 0;
|
1996-01-22 00:23:58 +00:00
|
|
|
|
|
|
|
/* Initialise the join queue for the new thread: */
|
In the words of the author:
o The polling mechanism for I/O readiness was changed from
select() to poll(). In additon, a wrapped version of poll()
is now provided.
o The wrapped select routine now converts each fd_set to a
poll array so that the thread scheduler doesn't have to
perform a bitwise search for selected fds each time file
descriptors are polled for I/O readiness.
o The thread scheduler was modified to use a new queue (_workq)
for threads that need work. Threads waiting for I/O readiness
and spinblocks are added to the work queue in addition to the
waiting queue. This reduces the time spent forming/searching
the array of file descriptors being polled.
o The waiting queue (_waitingq) is now maintained in order of
thread wakeup time. This allows the thread scheduler to
find the nearest wakeup time by looking at the first thread
in the queue instead of searching the entire queue.
o Removed file descriptor locking for select/poll routines. An
application should not rely on the threads library for providing
this locking; if necessary, the application should use mutexes
to protect selecting/polling of file descriptors.
o Retrieve and use the kernel clock rate/resolution at startup
instead of hardcoding the clock resolution to 10 msec (tested
with kernel running at 1000 HZ).
o All queues have been changed to use queue.h macros. These
include the queues of all threads, dead threads, and threads
waiting for file descriptor locks.
o Added reinitialization of the GC mutex and condition variable
after a fork. Also prevented reallocation of the ready queue
after a fork.
o Prevented the wrapped close routine from closing the thread
kernel pipes.
o Initialized file descriptor table for stdio entries at thread
init.
o Provided additional flags to indicate to what queues threads
belong.
o Moved TAILQ initialization for statically allocated mutex and
condition variables to after the spinlock.
o Added dispatching of signals to pthread_kill. Removing the
dispatching of signals from thread activation broke sigsuspend
when pthread_kill was used to send a signal to a thread.
o Temporarily set the state of a thread to PS_SUSPENDED when it
is first created and placed in the list of threads so that it
will not be accidentally scheduled before becoming a member
of one of the scheduling queues.
o Change the signal handler to queue signals to the thread kernel
pipe if the scheduling queues are protected. When scheduling
queues are unprotected, signals are then dequeued and handled.
o Ensured that all installed signal handlers block the scheduling
signal and that the scheduling signal handler blocks all
other signals. This ensures that the signal handler is only
interruptible for and by non-scheduling signals. An atomic
lock is used to decide which instance of the signal handler
will handle pending signals.
o Removed _lock_thread_list and _unlock_thread_list as they are
no longer used to protect the thread list.
o Added missing RCS IDs to modified files.
o Added checks for appropriate queue membership and activity when
adding, removing, and searching the scheduling queues. These
checks add very little overhead and are enabled when compiled
with _PTHREADS_INVARIANTS defined. Suggested and implemented
by Tor Egge with some modification by me.
o Close a race condition in uthread_close. (Tor Egge)
o Protect the scheduling queues while modifying them in
pthread_cond_signal and _thread_fd_unlock. (Tor Egge)
o Ensure that when a thread gets a mutex, the mutex is on that
threads list of owned mutexes. (Tor Egge)
o Set the kernel-in-scheduler flag in _thread_kern_sched_state
and _thread_kern_sched_state_unlock to prevent a scheduling
signal from calling the scheduler again. (Tor Egge)
o Don't use TAILQ_FOREACH macro while searching the waiting
queue for threads in a sigwait state, because a change of
state destroys the TAILQ link. It is actually safe to do
so, though, because once a sigwaiting thread is found, the
loop ends and the function returns. (Tor Egge)
o When dispatching signals to threads, make the thread inherit
the signal deferral flag of the currently running thread.
(Tor Egge)
Submitted by: Daniel Eischen <eischen@vigrid.com> and
Tor Egge <Tor.Egge@fast.no>
1999-06-20 08:28:48 +00:00
|
|
|
TAILQ_INIT(&(new_thread->join_queue));
|
1996-01-22 00:23:58 +00:00
|
|
|
|
1999-03-23 05:07:56 +00:00
|
|
|
/* Initialize the mutex queue: */
|
|
|
|
TAILQ_INIT(&new_thread->mutexq);
|
|
|
|
|
1996-01-22 00:23:58 +00:00
|
|
|
/* Initialise hooks in the thread structure: */
|
|
|
|
new_thread->specific_data = NULL;
|
|
|
|
new_thread->cleanup = NULL;
|
|
|
|
new_thread->flags = 0;
|
In the words of the author:
o The polling mechanism for I/O readiness was changed from
select() to poll(). In additon, a wrapped version of poll()
is now provided.
o The wrapped select routine now converts each fd_set to a
poll array so that the thread scheduler doesn't have to
perform a bitwise search for selected fds each time file
descriptors are polled for I/O readiness.
o The thread scheduler was modified to use a new queue (_workq)
for threads that need work. Threads waiting for I/O readiness
and spinblocks are added to the work queue in addition to the
waiting queue. This reduces the time spent forming/searching
the array of file descriptors being polled.
o The waiting queue (_waitingq) is now maintained in order of
thread wakeup time. This allows the thread scheduler to
find the nearest wakeup time by looking at the first thread
in the queue instead of searching the entire queue.
o Removed file descriptor locking for select/poll routines. An
application should not rely on the threads library for providing
this locking; if necessary, the application should use mutexes
to protect selecting/polling of file descriptors.
o Retrieve and use the kernel clock rate/resolution at startup
instead of hardcoding the clock resolution to 10 msec (tested
with kernel running at 1000 HZ).
o All queues have been changed to use queue.h macros. These
include the queues of all threads, dead threads, and threads
waiting for file descriptor locks.
o Added reinitialization of the GC mutex and condition variable
after a fork. Also prevented reallocation of the ready queue
after a fork.
o Prevented the wrapped close routine from closing the thread
kernel pipes.
o Initialized file descriptor table for stdio entries at thread
init.
o Provided additional flags to indicate to what queues threads
belong.
o Moved TAILQ initialization for statically allocated mutex and
condition variables to after the spinlock.
o Added dispatching of signals to pthread_kill. Removing the
dispatching of signals from thread activation broke sigsuspend
when pthread_kill was used to send a signal to a thread.
o Temporarily set the state of a thread to PS_SUSPENDED when it
is first created and placed in the list of threads so that it
will not be accidentally scheduled before becoming a member
of one of the scheduling queues.
o Change the signal handler to queue signals to the thread kernel
pipe if the scheduling queues are protected. When scheduling
queues are unprotected, signals are then dequeued and handled.
o Ensured that all installed signal handlers block the scheduling
signal and that the scheduling signal handler blocks all
other signals. This ensures that the signal handler is only
interruptible for and by non-scheduling signals. An atomic
lock is used to decide which instance of the signal handler
will handle pending signals.
o Removed _lock_thread_list and _unlock_thread_list as they are
no longer used to protect the thread list.
o Added missing RCS IDs to modified files.
o Added checks for appropriate queue membership and activity when
adding, removing, and searching the scheduling queues. These
checks add very little overhead and are enabled when compiled
with _PTHREADS_INVARIANTS defined. Suggested and implemented
by Tor Egge with some modification by me.
o Close a race condition in uthread_close. (Tor Egge)
o Protect the scheduling queues while modifying them in
pthread_cond_signal and _thread_fd_unlock. (Tor Egge)
o Ensure that when a thread gets a mutex, the mutex is on that
threads list of owned mutexes. (Tor Egge)
o Set the kernel-in-scheduler flag in _thread_kern_sched_state
and _thread_kern_sched_state_unlock to prevent a scheduling
signal from calling the scheduler again. (Tor Egge)
o Don't use TAILQ_FOREACH macro while searching the waiting
queue for threads in a sigwait state, because a change of
state destroys the TAILQ link. It is actually safe to do
so, though, because once a sigwaiting thread is found, the
loop ends and the function returns. (Tor Egge)
o When dispatching signals to threads, make the thread inherit
the signal deferral flag of the currently running thread.
(Tor Egge)
Submitted by: Daniel Eischen <eischen@vigrid.com> and
Tor Egge <Tor.Egge@fast.no>
1999-06-20 08:28:48 +00:00
|
|
|
new_thread->poll_data.nfds = 0;
|
|
|
|
new_thread->poll_data.fds = NULL;
|
1996-01-22 00:23:58 +00:00
|
|
|
|
In the words of the author:
o The polling mechanism for I/O readiness was changed from
select() to poll(). In additon, a wrapped version of poll()
is now provided.
o The wrapped select routine now converts each fd_set to a
poll array so that the thread scheduler doesn't have to
perform a bitwise search for selected fds each time file
descriptors are polled for I/O readiness.
o The thread scheduler was modified to use a new queue (_workq)
for threads that need work. Threads waiting for I/O readiness
and spinblocks are added to the work queue in addition to the
waiting queue. This reduces the time spent forming/searching
the array of file descriptors being polled.
o The waiting queue (_waitingq) is now maintained in order of
thread wakeup time. This allows the thread scheduler to
find the nearest wakeup time by looking at the first thread
in the queue instead of searching the entire queue.
o Removed file descriptor locking for select/poll routines. An
application should not rely on the threads library for providing
this locking; if necessary, the application should use mutexes
to protect selecting/polling of file descriptors.
o Retrieve and use the kernel clock rate/resolution at startup
instead of hardcoding the clock resolution to 10 msec (tested
with kernel running at 1000 HZ).
o All queues have been changed to use queue.h macros. These
include the queues of all threads, dead threads, and threads
waiting for file descriptor locks.
o Added reinitialization of the GC mutex and condition variable
after a fork. Also prevented reallocation of the ready queue
after a fork.
o Prevented the wrapped close routine from closing the thread
kernel pipes.
o Initialized file descriptor table for stdio entries at thread
init.
o Provided additional flags to indicate to what queues threads
belong.
o Moved TAILQ initialization for statically allocated mutex and
condition variables to after the spinlock.
o Added dispatching of signals to pthread_kill. Removing the
dispatching of signals from thread activation broke sigsuspend
when pthread_kill was used to send a signal to a thread.
o Temporarily set the state of a thread to PS_SUSPENDED when it
is first created and placed in the list of threads so that it
will not be accidentally scheduled before becoming a member
of one of the scheduling queues.
o Change the signal handler to queue signals to the thread kernel
pipe if the scheduling queues are protected. When scheduling
queues are unprotected, signals are then dequeued and handled.
o Ensured that all installed signal handlers block the scheduling
signal and that the scheduling signal handler blocks all
other signals. This ensures that the signal handler is only
interruptible for and by non-scheduling signals. An atomic
lock is used to decide which instance of the signal handler
will handle pending signals.
o Removed _lock_thread_list and _unlock_thread_list as they are
no longer used to protect the thread list.
o Added missing RCS IDs to modified files.
o Added checks for appropriate queue membership and activity when
adding, removing, and searching the scheduling queues. These
checks add very little overhead and are enabled when compiled
with _PTHREADS_INVARIANTS defined. Suggested and implemented
by Tor Egge with some modification by me.
o Close a race condition in uthread_close. (Tor Egge)
o Protect the scheduling queues while modifying them in
pthread_cond_signal and _thread_fd_unlock. (Tor Egge)
o Ensure that when a thread gets a mutex, the mutex is on that
threads list of owned mutexes. (Tor Egge)
o Set the kernel-in-scheduler flag in _thread_kern_sched_state
and _thread_kern_sched_state_unlock to prevent a scheduling
signal from calling the scheduler again. (Tor Egge)
o Don't use TAILQ_FOREACH macro while searching the waiting
queue for threads in a sigwait state, because a change of
state destroys the TAILQ link. It is actually safe to do
so, though, because once a sigwaiting thread is found, the
loop ends and the function returns. (Tor Egge)
o When dispatching signals to threads, make the thread inherit
the signal deferral flag of the currently running thread.
(Tor Egge)
Submitted by: Daniel Eischen <eischen@vigrid.com> and
Tor Egge <Tor.Egge@fast.no>
1999-06-20 08:28:48 +00:00
|
|
|
/*
|
|
|
|
* Defer signals to protect the scheduling queues
|
|
|
|
* from access by the signal handler:
|
|
|
|
*/
|
|
|
|
_thread_kern_sig_defer();
|
1998-04-29 09:59:34 +00:00
|
|
|
|
1998-09-30 06:36:56 +00:00
|
|
|
/*
|
|
|
|
* Check if the garbage collector thread
|
|
|
|
* needs to be started.
|
|
|
|
*/
|
In the words of the author:
o The polling mechanism for I/O readiness was changed from
select() to poll(). In additon, a wrapped version of poll()
is now provided.
o The wrapped select routine now converts each fd_set to a
poll array so that the thread scheduler doesn't have to
perform a bitwise search for selected fds each time file
descriptors are polled for I/O readiness.
o The thread scheduler was modified to use a new queue (_workq)
for threads that need work. Threads waiting for I/O readiness
and spinblocks are added to the work queue in addition to the
waiting queue. This reduces the time spent forming/searching
the array of file descriptors being polled.
o The waiting queue (_waitingq) is now maintained in order of
thread wakeup time. This allows the thread scheduler to
find the nearest wakeup time by looking at the first thread
in the queue instead of searching the entire queue.
o Removed file descriptor locking for select/poll routines. An
application should not rely on the threads library for providing
this locking; if necessary, the application should use mutexes
to protect selecting/polling of file descriptors.
o Retrieve and use the kernel clock rate/resolution at startup
instead of hardcoding the clock resolution to 10 msec (tested
with kernel running at 1000 HZ).
o All queues have been changed to use queue.h macros. These
include the queues of all threads, dead threads, and threads
waiting for file descriptor locks.
o Added reinitialization of the GC mutex and condition variable
after a fork. Also prevented reallocation of the ready queue
after a fork.
o Prevented the wrapped close routine from closing the thread
kernel pipes.
o Initialized file descriptor table for stdio entries at thread
init.
o Provided additional flags to indicate to what queues threads
belong.
o Moved TAILQ initialization for statically allocated mutex and
condition variables to after the spinlock.
o Added dispatching of signals to pthread_kill. Removing the
dispatching of signals from thread activation broke sigsuspend
when pthread_kill was used to send a signal to a thread.
o Temporarily set the state of a thread to PS_SUSPENDED when it
is first created and placed in the list of threads so that it
will not be accidentally scheduled before becoming a member
of one of the scheduling queues.
o Change the signal handler to queue signals to the thread kernel
pipe if the scheduling queues are protected. When scheduling
queues are unprotected, signals are then dequeued and handled.
o Ensured that all installed signal handlers block the scheduling
signal and that the scheduling signal handler blocks all
other signals. This ensures that the signal handler is only
interruptible for and by non-scheduling signals. An atomic
lock is used to decide which instance of the signal handler
will handle pending signals.
o Removed _lock_thread_list and _unlock_thread_list as they are
no longer used to protect the thread list.
o Added missing RCS IDs to modified files.
o Added checks for appropriate queue membership and activity when
adding, removing, and searching the scheduling queues. These
checks add very little overhead and are enabled when compiled
with _PTHREADS_INVARIANTS defined. Suggested and implemented
by Tor Egge with some modification by me.
o Close a race condition in uthread_close. (Tor Egge)
o Protect the scheduling queues while modifying them in
pthread_cond_signal and _thread_fd_unlock. (Tor Egge)
o Ensure that when a thread gets a mutex, the mutex is on that
threads list of owned mutexes. (Tor Egge)
o Set the kernel-in-scheduler flag in _thread_kern_sched_state
and _thread_kern_sched_state_unlock to prevent a scheduling
signal from calling the scheduler again. (Tor Egge)
o Don't use TAILQ_FOREACH macro while searching the waiting
queue for threads in a sigwait state, because a change of
state destroys the TAILQ link. It is actually safe to do
so, though, because once a sigwaiting thread is found, the
loop ends and the function returns. (Tor Egge)
o When dispatching signals to threads, make the thread inherit
the signal deferral flag of the currently running thread.
(Tor Egge)
Submitted by: Daniel Eischen <eischen@vigrid.com> and
Tor Egge <Tor.Egge@fast.no>
1999-06-20 08:28:48 +00:00
|
|
|
f_gc = (TAILQ_FIRST(&_thread_list) == _thread_initial);
|
1998-09-30 06:36:56 +00:00
|
|
|
|
1996-01-22 00:23:58 +00:00
|
|
|
/* Add the thread to the linked list of all threads: */
|
In the words of the author:
o The polling mechanism for I/O readiness was changed from
select() to poll(). In additon, a wrapped version of poll()
is now provided.
o The wrapped select routine now converts each fd_set to a
poll array so that the thread scheduler doesn't have to
perform a bitwise search for selected fds each time file
descriptors are polled for I/O readiness.
o The thread scheduler was modified to use a new queue (_workq)
for threads that need work. Threads waiting for I/O readiness
and spinblocks are added to the work queue in addition to the
waiting queue. This reduces the time spent forming/searching
the array of file descriptors being polled.
o The waiting queue (_waitingq) is now maintained in order of
thread wakeup time. This allows the thread scheduler to
find the nearest wakeup time by looking at the first thread
in the queue instead of searching the entire queue.
o Removed file descriptor locking for select/poll routines. An
application should not rely on the threads library for providing
this locking; if necessary, the application should use mutexes
to protect selecting/polling of file descriptors.
o Retrieve and use the kernel clock rate/resolution at startup
instead of hardcoding the clock resolution to 10 msec (tested
with kernel running at 1000 HZ).
o All queues have been changed to use queue.h macros. These
include the queues of all threads, dead threads, and threads
waiting for file descriptor locks.
o Added reinitialization of the GC mutex and condition variable
after a fork. Also prevented reallocation of the ready queue
after a fork.
o Prevented the wrapped close routine from closing the thread
kernel pipes.
o Initialized file descriptor table for stdio entries at thread
init.
o Provided additional flags to indicate to what queues threads
belong.
o Moved TAILQ initialization for statically allocated mutex and
condition variables to after the spinlock.
o Added dispatching of signals to pthread_kill. Removing the
dispatching of signals from thread activation broke sigsuspend
when pthread_kill was used to send a signal to a thread.
o Temporarily set the state of a thread to PS_SUSPENDED when it
is first created and placed in the list of threads so that it
will not be accidentally scheduled before becoming a member
of one of the scheduling queues.
o Change the signal handler to queue signals to the thread kernel
pipe if the scheduling queues are protected. When scheduling
queues are unprotected, signals are then dequeued and handled.
o Ensured that all installed signal handlers block the scheduling
signal and that the scheduling signal handler blocks all
other signals. This ensures that the signal handler is only
interruptible for and by non-scheduling signals. An atomic
lock is used to decide which instance of the signal handler
will handle pending signals.
o Removed _lock_thread_list and _unlock_thread_list as they are
no longer used to protect the thread list.
o Added missing RCS IDs to modified files.
o Added checks for appropriate queue membership and activity when
adding, removing, and searching the scheduling queues. These
checks add very little overhead and are enabled when compiled
with _PTHREADS_INVARIANTS defined. Suggested and implemented
by Tor Egge with some modification by me.
o Close a race condition in uthread_close. (Tor Egge)
o Protect the scheduling queues while modifying them in
pthread_cond_signal and _thread_fd_unlock. (Tor Egge)
o Ensure that when a thread gets a mutex, the mutex is on that
threads list of owned mutexes. (Tor Egge)
o Set the kernel-in-scheduler flag in _thread_kern_sched_state
and _thread_kern_sched_state_unlock to prevent a scheduling
signal from calling the scheduler again. (Tor Egge)
o Don't use TAILQ_FOREACH macro while searching the waiting
queue for threads in a sigwait state, because a change of
state destroys the TAILQ link. It is actually safe to do
so, though, because once a sigwaiting thread is found, the
loop ends and the function returns. (Tor Egge)
o When dispatching signals to threads, make the thread inherit
the signal deferral flag of the currently running thread.
(Tor Egge)
Submitted by: Daniel Eischen <eischen@vigrid.com> and
Tor Egge <Tor.Egge@fast.no>
1999-06-20 08:28:48 +00:00
|
|
|
TAILQ_INSERT_HEAD(&_thread_list, new_thread, tle);
|
1999-03-23 05:07:56 +00:00
|
|
|
|
|
|
|
if (pattr->suspend == PTHREAD_CREATE_SUSPENDED) {
|
|
|
|
new_thread->state = PS_SUSPENDED;
|
|
|
|
PTHREAD_WAITQ_INSERT(new_thread);
|
1999-07-11 05:56:37 +00:00
|
|
|
} else {
|
1999-03-23 05:07:56 +00:00
|
|
|
new_thread->state = PS_RUNNING;
|
|
|
|
PTHREAD_PRIOQ_INSERT_TAIL(new_thread);
|
|
|
|
}
|
|
|
|
|
|
|
|
/*
|
In the words of the author:
o The polling mechanism for I/O readiness was changed from
select() to poll(). In additon, a wrapped version of poll()
is now provided.
o The wrapped select routine now converts each fd_set to a
poll array so that the thread scheduler doesn't have to
perform a bitwise search for selected fds each time file
descriptors are polled for I/O readiness.
o The thread scheduler was modified to use a new queue (_workq)
for threads that need work. Threads waiting for I/O readiness
and spinblocks are added to the work queue in addition to the
waiting queue. This reduces the time spent forming/searching
the array of file descriptors being polled.
o The waiting queue (_waitingq) is now maintained in order of
thread wakeup time. This allows the thread scheduler to
find the nearest wakeup time by looking at the first thread
in the queue instead of searching the entire queue.
o Removed file descriptor locking for select/poll routines. An
application should not rely on the threads library for providing
this locking; if necessary, the application should use mutexes
to protect selecting/polling of file descriptors.
o Retrieve and use the kernel clock rate/resolution at startup
instead of hardcoding the clock resolution to 10 msec (tested
with kernel running at 1000 HZ).
o All queues have been changed to use queue.h macros. These
include the queues of all threads, dead threads, and threads
waiting for file descriptor locks.
o Added reinitialization of the GC mutex and condition variable
after a fork. Also prevented reallocation of the ready queue
after a fork.
o Prevented the wrapped close routine from closing the thread
kernel pipes.
o Initialized file descriptor table for stdio entries at thread
init.
o Provided additional flags to indicate to what queues threads
belong.
o Moved TAILQ initialization for statically allocated mutex and
condition variables to after the spinlock.
o Added dispatching of signals to pthread_kill. Removing the
dispatching of signals from thread activation broke sigsuspend
when pthread_kill was used to send a signal to a thread.
o Temporarily set the state of a thread to PS_SUSPENDED when it
is first created and placed in the list of threads so that it
will not be accidentally scheduled before becoming a member
of one of the scheduling queues.
o Change the signal handler to queue signals to the thread kernel
pipe if the scheduling queues are protected. When scheduling
queues are unprotected, signals are then dequeued and handled.
o Ensured that all installed signal handlers block the scheduling
signal and that the scheduling signal handler blocks all
other signals. This ensures that the signal handler is only
interruptible for and by non-scheduling signals. An atomic
lock is used to decide which instance of the signal handler
will handle pending signals.
o Removed _lock_thread_list and _unlock_thread_list as they are
no longer used to protect the thread list.
o Added missing RCS IDs to modified files.
o Added checks for appropriate queue membership and activity when
adding, removing, and searching the scheduling queues. These
checks add very little overhead and are enabled when compiled
with _PTHREADS_INVARIANTS defined. Suggested and implemented
by Tor Egge with some modification by me.
o Close a race condition in uthread_close. (Tor Egge)
o Protect the scheduling queues while modifying them in
pthread_cond_signal and _thread_fd_unlock. (Tor Egge)
o Ensure that when a thread gets a mutex, the mutex is on that
threads list of owned mutexes. (Tor Egge)
o Set the kernel-in-scheduler flag in _thread_kern_sched_state
and _thread_kern_sched_state_unlock to prevent a scheduling
signal from calling the scheduler again. (Tor Egge)
o Don't use TAILQ_FOREACH macro while searching the waiting
queue for threads in a sigwait state, because a change of
state destroys the TAILQ link. It is actually safe to do
so, though, because once a sigwaiting thread is found, the
loop ends and the function returns. (Tor Egge)
o When dispatching signals to threads, make the thread inherit
the signal deferral flag of the currently running thread.
(Tor Egge)
Submitted by: Daniel Eischen <eischen@vigrid.com> and
Tor Egge <Tor.Egge@fast.no>
1999-06-20 08:28:48 +00:00
|
|
|
* Undefer and handle pending signals, yielding
|
|
|
|
* if necessary.
|
1999-03-23 05:07:56 +00:00
|
|
|
*/
|
In the words of the author:
o The polling mechanism for I/O readiness was changed from
select() to poll(). In additon, a wrapped version of poll()
is now provided.
o The wrapped select routine now converts each fd_set to a
poll array so that the thread scheduler doesn't have to
perform a bitwise search for selected fds each time file
descriptors are polled for I/O readiness.
o The thread scheduler was modified to use a new queue (_workq)
for threads that need work. Threads waiting for I/O readiness
and spinblocks are added to the work queue in addition to the
waiting queue. This reduces the time spent forming/searching
the array of file descriptors being polled.
o The waiting queue (_waitingq) is now maintained in order of
thread wakeup time. This allows the thread scheduler to
find the nearest wakeup time by looking at the first thread
in the queue instead of searching the entire queue.
o Removed file descriptor locking for select/poll routines. An
application should not rely on the threads library for providing
this locking; if necessary, the application should use mutexes
to protect selecting/polling of file descriptors.
o Retrieve and use the kernel clock rate/resolution at startup
instead of hardcoding the clock resolution to 10 msec (tested
with kernel running at 1000 HZ).
o All queues have been changed to use queue.h macros. These
include the queues of all threads, dead threads, and threads
waiting for file descriptor locks.
o Added reinitialization of the GC mutex and condition variable
after a fork. Also prevented reallocation of the ready queue
after a fork.
o Prevented the wrapped close routine from closing the thread
kernel pipes.
o Initialized file descriptor table for stdio entries at thread
init.
o Provided additional flags to indicate to what queues threads
belong.
o Moved TAILQ initialization for statically allocated mutex and
condition variables to after the spinlock.
o Added dispatching of signals to pthread_kill. Removing the
dispatching of signals from thread activation broke sigsuspend
when pthread_kill was used to send a signal to a thread.
o Temporarily set the state of a thread to PS_SUSPENDED when it
is first created and placed in the list of threads so that it
will not be accidentally scheduled before becoming a member
of one of the scheduling queues.
o Change the signal handler to queue signals to the thread kernel
pipe if the scheduling queues are protected. When scheduling
queues are unprotected, signals are then dequeued and handled.
o Ensured that all installed signal handlers block the scheduling
signal and that the scheduling signal handler blocks all
other signals. This ensures that the signal handler is only
interruptible for and by non-scheduling signals. An atomic
lock is used to decide which instance of the signal handler
will handle pending signals.
o Removed _lock_thread_list and _unlock_thread_list as they are
no longer used to protect the thread list.
o Added missing RCS IDs to modified files.
o Added checks for appropriate queue membership and activity when
adding, removing, and searching the scheduling queues. These
checks add very little overhead and are enabled when compiled
with _PTHREADS_INVARIANTS defined. Suggested and implemented
by Tor Egge with some modification by me.
o Close a race condition in uthread_close. (Tor Egge)
o Protect the scheduling queues while modifying them in
pthread_cond_signal and _thread_fd_unlock. (Tor Egge)
o Ensure that when a thread gets a mutex, the mutex is on that
threads list of owned mutexes. (Tor Egge)
o Set the kernel-in-scheduler flag in _thread_kern_sched_state
and _thread_kern_sched_state_unlock to prevent a scheduling
signal from calling the scheduler again. (Tor Egge)
o Don't use TAILQ_FOREACH macro while searching the waiting
queue for threads in a sigwait state, because a change of
state destroys the TAILQ link. It is actually safe to do
so, though, because once a sigwaiting thread is found, the
loop ends and the function returns. (Tor Egge)
o When dispatching signals to threads, make the thread inherit
the signal deferral flag of the currently running thread.
(Tor Egge)
Submitted by: Daniel Eischen <eischen@vigrid.com> and
Tor Egge <Tor.Egge@fast.no>
1999-06-20 08:28:48 +00:00
|
|
|
_thread_kern_sig_undefer();
|
1999-03-23 05:07:56 +00:00
|
|
|
|
1996-01-22 00:23:58 +00:00
|
|
|
/* Return a pointer to the thread structure: */
|
1998-04-29 09:59:34 +00:00
|
|
|
(*thread) = new_thread;
|
1996-01-22 00:23:58 +00:00
|
|
|
|
1998-04-29 09:59:34 +00:00
|
|
|
/* Schedule the new user thread: */
|
|
|
|
_thread_kern_sched(NULL);
|
1998-09-30 06:36:56 +00:00
|
|
|
|
|
|
|
/*
|
|
|
|
* Start a garbage collector thread
|
|
|
|
* if necessary.
|
|
|
|
*/
|
|
|
|
if (f_gc && pthread_create(&gc_thread,NULL,
|
|
|
|
_thread_gc,NULL) != 0)
|
|
|
|
PANIC("Can't create gc thread");
|
1996-01-22 00:23:58 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
/* Return the status: */
|
|
|
|
return (ret);
|
|
|
|
}
|
|
|
|
|
|
|
|
void
|
|
|
|
_thread_start(void)
|
|
|
|
{
|
1998-10-09 19:01:30 +00:00
|
|
|
/* We just left the scheduler via longjmp: */
|
|
|
|
_thread_kern_in_sched = 0;
|
|
|
|
|
1996-01-22 00:23:58 +00:00
|
|
|
/* Run the current thread's start routine with argument: */
|
|
|
|
pthread_exit(_thread_run->start_routine(_thread_run->arg));
|
|
|
|
|
|
|
|
/* This point should never be reached. */
|
|
|
|
PANIC("Thread has resumed after exit");
|
|
|
|
}
|
|
|
|
#endif
|