Home | History | Annotate | Line # | Download | only in libpthread
pthread_int.h revision 1.1.2.10
      1 /*	$NetBSD: pthread_int.h,v 1.1.2.10 2001/07/26 19:57:14 nathanw Exp $	*/
      2 
      3 /*-
      4  * Copyright (c) 2001 The NetBSD Foundation, Inc.
      5  * All rights reserved.
      6  *
      7  * This code is derived from software contributed to The NetBSD Foundation
      8  * by Nathan J. Williams.
      9  *
     10  * Redistribution and use in source and binary forms, with or without
     11  * modification, are permitted provided that the following conditions
     12  * are met:
     13  * 1. Redistributions of source code must retain the above copyright
     14  *    notice, this list of conditions and the following disclaimer.
     15  * 2. Redistributions in binary form must reproduce the above copyright
     16  *    notice, this list of conditions and the following disclaimer in the
     17  *    documentation and/or other materials provided with the distribution.
     18  * 3. All advertising materials mentioning features or use of this software
     19  *    must display the following acknowledgement:
     20  *        This product includes software developed by the NetBSD
     21  *        Foundation, Inc. and its contributors.
     22  * 4. Neither the name of The NetBSD Foundation nor the names of its
     23  *    contributors may be used to endorse or promote products derived
     24  *    from this software without specific prior written permission.
     25  *
     26  * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
     27  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
     28  * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
     29  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
     30  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
     31  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
     32  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
     33  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
     34  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
     35  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
     36  * POSSIBILITY OF SUCH DAMAGE.
     37  */
     38 
     39 #ifndef _LIB_PTHREAD_INT_H
     40 #define _LIB_PTHREAD_INT_H
     41 
     42 #include <sa.h>
     43 #include <signal.h>
     44 
     45 #define PTHREAD__DEBUG
     46 #define ERRORCHECK
     47 
     48 #include "pthread_types.h"
     49 
     50 
     51 struct	pthread_st {
     52 	unsigned int	pt_magic;
     53 
     54 	int	pt_type;	/* normal, upcall, or idle */
     55 	int	pt_state;	/* running, blocked, etc. */
     56 	int	pt_flags;
     57 	int	pt_spinlocks;	/* Number of spinlocks held. */
     58 
     59 	/* Entry on the run queue */
     60 	PTQ_ENTRY(pthread_st)	pt_runq;
     61 	/* Entry on the list of all threads */
     62 	PTQ_ENTRY(pthread_st)	pt_allq;
     63 	/* Entry on the sleep queue (xxx should be same as run queue?) */
     64 	PTQ_ENTRY(pthread_st)	pt_sleep;
     65 
     66 	stack_t		pt_stack;	/* Our stack */
     67 	ucontext_t	*pt_uc;		/* Saved context when we're stopped */
     68 
     69 	sigset_t	pt_sigmask;	/* Signals we won't take. */
     70 	sigset_t	pt_siglist;	/* Signals pending for us. */
     71 	pt_spin_t	pt_siglock;	/* Lock on above */
     72 
     73 	void *		pt_exitval;	/* Read by pthread_join() */
     74 
     75 	/* Other threads trying to pthread_join() us. */
     76 	struct pt_queue_t	pt_joiners;
     77 	/* Lock for above, and for changing pt_state to ZOMBIE or DEAD,
     78 	 * and for setting the DETACHED flag
     79 	 */
     80 	pt_spin_t 		pt_join_lock;
     81 
     82 	/* Thread we were going to switch to before we were preempted
     83 	 * ourselves. Will be used by the upcall that's continuing us.
     84 	 */
     85 	pthread_t	pt_switchto;
     86 	ucontext_t*	pt_switchtouc;
     87 
     88 	/* Threads that are preempted with spinlocks held will be
     89 	 * continued until they unlock their spinlock. When they do
     90 	 * so, they should jump ship to the thread pointed to by
     91 	 * pt_next.
     92 	 */
     93 	pthread_t	pt_next;
     94 
     95 	/* The upcall that is continuing this thread */
     96 	pthread_t	pt_parent;
     97 
     98 	/* A queue lock that this thread held while trying to
     99 	 * context switch to another process.
    100 	 */
    101 	pt_spin_t*	pt_heldlock;
    102 
    103 #ifdef PTHREAD__DEBUG
    104 	int	blocks;
    105 	int	preempts;
    106 	int	rescheds;
    107 #endif
    108 };
    109 
    110 
    111 
    112 /* Thread types */
    113 #define PT_THREAD_NORMAL	1
    114 #define PT_THREAD_UPCALL	2
    115 #define PT_THREAD_IDLE		3
    116 
    117 /* Thread states */
    118 #define PT_STATE_RUNNABLE	1
    119 #define PT_STATE_BLOCKED	2
    120 #define PT_STATE_ZOMBIE		3
    121 #define PT_STATE_DEAD		4
    122 #define PT_STATE_RECYCLABLE	5
    123 
    124 /* Flag values */
    125 
    126 #define PT_FLAG_DETACHED	0x0001
    127 #define PT_FLAG_IDLED		0x0002
    128 
    129 #define PT_MAGIC	0x11110001
    130 #define PT_DEAD		0xDEAD0001
    131 
    132 #define PT_ATTR_MAGIC	0x22220002
    133 #define PT_ATTR_DEAD	0xDEAD0002
    134 
    135 #define PT_STACKSIZE	(1<<16)
    136 #define PT_STACKMASK	(PT_STACKSIZE-1)
    137 
    138 #define PT_UPCALLSTACKS	16
    139 
    140 #define NIDLETHREADS	4
    141 #define IDLESPINS	1000
    142 
    143 /* Utility functions */
    144 
    145 void*	pthread__malloc(size_t size);
    146 void	pthread__free(void *ptr);
    147 
    148 /* Set up/clean up a thread's basic state. */
    149 void	pthread__initthread(pthread_t t);
    150 
    151 /* Go do something else. Don't go back on the run queue */
    152 void	pthread__block(pthread_t self, pt_spin_t* queuelock);
    153 /* Put a thread back on the run queue */
    154 void	pthread__sched(pthread_t self, pthread_t thread);
    155 void	pthread__sched_idle(pthread_t self, pthread_t thread);
    156 void	pthread__sched_idle2(pthread_t self);
    157 
    158 void	pthread__sched_bulk(pthread_t self, pthread_t qhead);
    159 
    160 void	pthread__idle(void);
    161 
    162 /* Get the next thread */
    163 pthread_t pthread__next(pthread_t self);
    164 
    165 int	pthread__stackalloc(pthread_t *t);
    166 void	pthread__initmain(pthread_t *t);
    167 
    168 void	pthread__sa_start(void);
    169 void	pthread__sa_recycle(pthread_t old, pthread_t new);
    170 
    171 #include "pthread_md.h"
    172 
    173 int	_getcontext_u(ucontext_t *);
    174 int	_setcontext_u(const ucontext_t *);
    175 int	_swapcontext_u(ucontext_t *, const ucontext_t *);
    176 
    177 /* Stack location of pointer to a particular thread */
    178 #define pthread__id(sp) \
    179 	((pthread_t) (((vaddr_t)(sp)) & ~PT_STACKMASK))
    180 
    181 #define pthread__self() (pthread__id(pthread__sp()))
    182 
    183 void	pthread__upcall_switch(pthread_t self, pthread_t next);
    184 void	pthread__switch(pthread_t self, pthread_t next);
    185 void	pthread__locked_switch(pthread_t self, pthread_t next,
    186     pt_spin_t *lock);
    187 
    188 void	pthread_lockinit(pt_spin_t *lock);
    189 void	pthread_spinlock(pthread_t thread, pt_spin_t *lock);
    190 int	pthread_spintrylock(pthread_t thread, pt_spin_t *lock);
    191 void	pthread_spinunlock(pthread_t thread, pt_spin_t *lock);
    192 
    193 void	pthread__signal(pthread_t t, int sig, int code);
    194 
    195 
    196 
    197 #define PTHREADD_CREATE		0
    198 #define PTHREADD_IDLE		1
    199 #define PTHREADD_UPCALLS	2
    200 #define PTHREADD_UP_BLOCK       3
    201 #define PTHREADD_UP_NEW		4
    202 #define PTHREADD_UP_PREEMPT	5
    203 #define PTHREADD_UP_UNBLOCK	6
    204 #define PTHREADD_UP_SIGNAL	7
    205 #define PTHREADD_SPINLOCKS	8
    206 #define PTHREADD_SPINUNLOCKS	9
    207 #define PTHREADD_SPINPREEMPT	10
    208 #define PTHREADD_RESOLVELOCKS	11
    209 #define PTHREADD_SWITCHTO	12
    210 #define PTHREADD_NCOUNTERS	13
    211 
    212 #ifdef PTHREAD__DEBUG
    213 
    214 #define PTHREAD__DEBUG_SHMKEY	(0x000f)
    215 #define PTHREAD__DEBUG_SHMSIZE	(1<<18)
    216 
    217 extern int pthread__debug_counters[PTHREADD_NCOUNTERS];
    218 
    219 #define PTHREADD_ADD(x) (pthread__debug_counters[(x)]++)
    220 
    221 #define DPRINTF(x) pthread__debuglog_printf x
    222 
    223 struct	pthread_msgbuf {
    224 #define BUF_MAGIC	0x090976
    225 	int	msg_magic;
    226 	long	msg_bufw;
    227 	long	msg_bufr;
    228 	long	msg_bufs;
    229 	char	msg_bufc[1];
    230 };
    231 
    232 void pthread__debug_init(void);
    233 struct pthread_msgbuf* pthread__debuglog_init(void);
    234 void pthread__debuglog_printf(const char *fmt, ...);
    235 
    236 #else /* PTHREAD_DEBUG */
    237 
    238 #define PTHREADD_ADD(x)
    239 #define DPRINTF(x)
    240 
    241 #endif /* PTHREAD_DEBUG */
    242 
    243 #endif /* _LIB_PTHREAD_INT_H */
    244 
    245