Home | History | Annotate | Line # | Download | only in libpthread
pthread_int.h revision 1.1.2.15
      1 /*	$NetBSD: pthread_int.h,v 1.1.2.15 2001/08/08 19:36:49 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 	/* The context we saved in pthread__locked_switch but which
     89 	 * was trashed when we were preempted before switching stacks.
     90 	 */
     91 	ucontext_t*	pt_sleepuc;
     92 
     93 	/* Threads that are preempted with spinlocks held will be
     94 	 * continued until they unlock their spinlock. When they do
     95 	 * so, they should jump ship to the thread pointed to by
     96 	 * pt_next.
     97 	 */
     98 	pthread_t	pt_next;
     99 
    100 	/* The upcall that is continuing this thread */
    101 	pthread_t	pt_parent;
    102 
    103 	/* A queue lock that this thread held while trying to
    104 	 * context switch to another process.
    105 	 */
    106 	pt_spin_t*	pt_heldlock;
    107 
    108 	/* Thread-specific data */
    109 	void*		pt_specific[PTHREAD_KEYS_MAX];
    110 
    111 #ifdef PTHREAD__DEBUG
    112 	int	blocks;
    113 	int	preempts;
    114 	int	rescheds;
    115 #endif
    116 };
    117 
    118 
    119 
    120 /* Thread types */
    121 #define PT_THREAD_NORMAL	1
    122 #define PT_THREAD_UPCALL	2
    123 #define PT_THREAD_IDLE		3
    124 
    125 /* Thread states */
    126 #define PT_STATE_RUNNABLE	1
    127 #define PT_STATE_BLOCKED	2
    128 #define PT_STATE_ZOMBIE		3
    129 #define PT_STATE_DEAD		4
    130 #define PT_STATE_RECYCLABLE	5
    131 
    132 /* Flag values */
    133 
    134 #define PT_FLAG_DETACHED	0x0001
    135 #define PT_FLAG_IDLED		0x0002
    136 
    137 #define PT_MAGIC	0x11110001
    138 #define PT_DEAD		0xDEAD0001
    139 
    140 #define PT_ATTR_MAGIC	0x22220002
    141 #define PT_ATTR_DEAD	0xDEAD0002
    142 
    143 #define PT_STACKSIZE	(1<<16)
    144 #define PT_STACKMASK	(PT_STACKSIZE-1)
    145 
    146 #define PT_UPCALLSTACKS	16
    147 
    148 #define NIDLETHREADS	4
    149 #define IDLESPINS	1000
    150 
    151 void	pthread_init(void)  __attribute__ ((__constructor__));
    152 
    153 /* Utility functions */
    154 
    155 /* Set up/clean up a thread's basic state. */
    156 void	pthread__initthread(pthread_t t);
    157 
    158 /* Go do something else. Don't go back on the run queue */
    159 void	pthread__block(pthread_t self, pt_spin_t* queuelock);
    160 /* Put a thread back on the run queue */
    161 void	pthread__sched(pthread_t self, pthread_t thread);
    162 void	pthread__sched_idle(pthread_t self, pthread_t thread);
    163 void	pthread__sched_idle2(pthread_t self);
    164 
    165 void	pthread__sched_bulk(pthread_t self, pthread_t qhead);
    166 
    167 void	pthread__idle(void);
    168 
    169 /* Get the next thread */
    170 pthread_t pthread__next(pthread_t self);
    171 
    172 int	pthread__stackalloc(pthread_t *t);
    173 void	pthread__initmain(pthread_t *t);
    174 
    175 void	pthread__sa_start(void);
    176 void	pthread__sa_recycle(pthread_t old, pthread_t new);
    177 
    178 #include "pthread_md.h"
    179 
    180 int	_getcontext_u(ucontext_t *);
    181 int	_setcontext_u(const ucontext_t *);
    182 int	_swapcontext_u(ucontext_t *, const ucontext_t *);
    183 
    184 /* Stack location of pointer to a particular thread */
    185 #define pthread__id(sp) \
    186 	((pthread_t) (((vaddr_t)(sp)) & ~PT_STACKMASK))
    187 
    188 #define pthread__self() (pthread__id(pthread__sp()))
    189 
    190 /* These three routines are defined in processor-specific code. */
    191 void	pthread__upcall_switch(pthread_t self, pthread_t next);
    192 void	pthread__switch(pthread_t self, pthread_t next);
    193 void	pthread__locked_switch(pthread_t self, pthread_t next,
    194     pt_spin_t *lock);
    195 
    196 
    197 void	pthread__signal(pthread_t t, int sig, int code);
    198 
    199 void	pthread__destroy_tsd(pthread_t self);
    200 
    201 
    202 #define PTHREADD_CREATE		0
    203 #define PTHREADD_IDLE		1
    204 #define PTHREADD_UPCALLS	2
    205 #define PTHREADD_UP_BLOCK       3
    206 #define PTHREADD_UP_NEW		4
    207 #define PTHREADD_UP_PREEMPT	5
    208 #define PTHREADD_UP_UNBLOCK	6
    209 #define PTHREADD_UP_SIGNAL	7
    210 #define PTHREADD_SPINLOCKS	8
    211 #define PTHREADD_SPINUNLOCKS	9
    212 #define PTHREADD_SPINPREEMPT	10
    213 #define PTHREADD_RESOLVELOCKS	11
    214 #define PTHREADD_SWITCHTO	12
    215 #define PTHREADD_NCOUNTERS	13
    216 
    217 #ifdef PTHREAD__DEBUG
    218 
    219 #define PTHREAD__DEBUG_SHMKEY	(0x000f)
    220 #define PTHREAD__DEBUG_SHMSIZE	(1<<18)
    221 
    222 extern int pthread__debug_counters[PTHREADD_NCOUNTERS];
    223 
    224 #define PTHREADD_ADD(x) (pthread__debug_counters[(x)]++)
    225 
    226 #define DPRINTF(x) pthread__debuglog_printf x
    227 
    228 struct	pthread_msgbuf {
    229 #define BUF_MAGIC	0x090976
    230 	int	msg_magic;
    231 	long	msg_bufw;
    232 	long	msg_bufr;
    233 	long	msg_bufs;
    234 	char	msg_bufc[1];
    235 };
    236 
    237 void pthread__debug_init(void);
    238 struct pthread_msgbuf* pthread__debuglog_init(int force);
    239 void pthread__debuglog_printf(const char *fmt, ...);
    240 
    241 #else /* PTHREAD_DEBUG */
    242 
    243 #define PTHREADD_ADD(x)
    244 #define DPRINTF(x)
    245 
    246 #endif /* PTHREAD_DEBUG */
    247 
    248 #endif /* _LIB_PTHREAD_INT_H */
    249 
    250