Merged to new trunk.
[cacao.git] / src / threads / posix / thread-posix.h
1 /* src/threads/posix/thread-posix.h - POSIX thread functions
2
3    Copyright (C) 1996-2005, 2006, 2007, 2008
4    CACAOVM - Verein zur Foerderung der freien virtuellen Maschine CACAO
5
6    This file is part of CACAO.
7
8    This program is free software; you can redistribute it and/or
9    modify it under the terms of the GNU General Public License as
10    published by the Free Software Foundation; either version 2, or (at
11    your option) any later version.
12
13    This program is distributed in the hope that it will be useful, but
14    WITHOUT ANY WARRANTY; without even the implied warranty of
15    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
16    General Public License for more details.
17
18    You should have received a copy of the GNU General Public License
19    along with this program; if not, write to the Free Software
20    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
21    02110-1301, USA.
22
23 */
24
25
26 #ifndef _THREAD_POSIX_H
27 #define _THREAD_POSIX_H
28
29 /* forward typedefs ***********************************************************/
30
31 typedef struct threadobject threadobject;
32
33
34 #include "config.h"
35
36 #include <pthread.h>
37 #include <ucontext.h>
38
39 #include "vm/types.h"
40
41 #include "mm/memory.h"
42
43 #include "native/localref.h"
44
45 #include "threads/mutex.h"
46
47 #include "threads/posix/lock.h"
48
49 #include "vm/global.h"
50 #include "vm/vm.h"
51
52 #if defined(ENABLE_GC_CACAO)
53 # include "vm/jit/replace.h"
54 #endif
55
56 #include "vm/jit/stacktrace.h"
57
58 #if defined(ENABLE_INTRP)
59 #include "vm/jit/intrp/intrp.h"
60 #endif
61
62 #if defined(__DARWIN__)
63 # include <mach/mach.h>
64
65 typedef struct {
66         mutex_t mutex;
67         pthread_cond_t cond;
68         int value;
69 } sem_t;
70
71 #else
72 # include <semaphore.h>
73 #endif
74
75
76 /* current threadobject *******************************************************/
77
78 #if defined(HAVE___THREAD)
79
80 #define THREADOBJECT      thread_current
81
82 extern __thread threadobject *thread_current;
83
84 #else /* defined(HAVE___THREAD) */
85
86 #define THREADOBJECT \
87         ((threadobject *) pthread_getspecific(thread_current_key))
88
89 extern pthread_key_t thread_current_key;
90
91 #endif /* defined(HAVE___THREAD) */
92
93
94 /* threadobject ****************************************************************
95
96    Struct holding thread local variables.
97
98 *******************************************************************************/
99
100 #define THREAD_FLAG_JAVA        0x01    /* a normal Java thread               */
101 #define THREAD_FLAG_INTERNAL    0x02    /* CACAO internal thread              */
102 #define THREAD_FLAG_DAEMON      0x04    /* daemon thread                      */
103 #define THREAD_FLAG_IN_NATIVE   0x08    /* currently executing native code    */
104
105 #define SUSPEND_REASON_JNI       1      /* suspended from JNI                 */
106 #define SUSPEND_REASON_STOPWORLD 2      /* suspended from stop-thw-world      */
107
108
109 struct threadobject {
110         java_object_t        *object;       /* link to java.lang.Thread object    */
111
112         ptrint                thinlock;     /* pre-computed thin lock value       */
113
114         s4                    index;        /* thread index, starting with 1      */
115         u4                    flags;        /* flag field                         */
116         u4                    state;        /* state field                        */
117
118         pthread_t             tid;          /* pthread id                         */
119
120 #if defined(__DARWIN__)
121         mach_port_t           mach_thread;       /* Darwin thread id              */
122 #endif
123
124         /* for the sable tasuki lock extension */
125         bool                  flc_bit;
126         struct threadobject  *flc_list;     /* FLC list head for this thread      */
127         struct threadobject  *flc_next;     /* next pointer for FLC list          */
128         java_handle_t        *flc_object;
129         mutex_t               flc_lock;     /* controlling access to these fields */
130         pthread_cond_t        flc_cond;
131
132         /* these are used for the wait/notify implementation                      */
133         mutex_t               waitmutex;
134         pthread_cond_t        waitcond;
135
136         mutex_t               suspendmutex; /* lock before suspending this thread */
137         pthread_cond_t        suspendcond;  /* notify to resume this thread       */
138
139         bool                  interrupted;
140         bool                  signaled;
141
142         bool                  suspended;    /* is this thread suspended?          */
143         s4                    suspend_reason; /* reason for suspending            */
144
145         u1                   *pc;           /* current PC (used for profiling)    */
146
147         java_object_t        *_exceptionptr;     /* current exception             */
148         stackframeinfo_t     *_stackframeinfo;   /* current native stackframeinfo */
149         localref_table       *_localref_table;   /* JNI local references          */
150
151 #if defined(ENABLE_INTRP)
152         Cell                 *_global_sp;        /* stack pointer for interpreter */
153 #endif
154
155 #if defined(ENABLE_GC_CACAO)
156         bool                  gc_critical;  /* indicates a critical section       */
157
158         sourcestate_t        *ss;
159         executionstate_t     *es;
160 #endif
161
162         dumpinfo_t            dumpinfo;     /* dump memory info structure         */
163
164 #if defined(ENABLE_DEBUG_FILTER)
165         u2                    filterverbosecallctr[2]; /* counters for verbose call filter */
166 #endif
167
168 #if !defined(NDEBUG)
169         s4                    tracejavacallindent;
170         u4                    tracejavacallcount;
171 #endif
172
173         listnode_t            linkage;      /* threads-list                       */
174         listnode_t            linkage_free; /* free-list                          */
175 };
176
177
178 /* native-world flags *********************************************************/
179
180 #if defined(ENABLE_GC_CACAO)
181 # define THREAD_NATIVEWORLD_ENTER THREADOBJECT->flags |=  THREAD_FLAG_IN_NATIVE
182 # define THREAD_NATIVEWORLD_EXIT  THREADOBJECT->flags &= ~THREAD_FLAG_IN_NATIVE
183 #else
184 # define THREAD_NATIVEWORLD_ENTER /*nop*/
185 # define THREAD_NATIVEWORLD_EXIT  /*nop*/
186 #endif
187
188
189 /* counter for verbose call filter ********************************************/
190
191 #if defined(ENABLE_DEBUG_FILTER)
192 #       define FILTERVERBOSECALLCTR (THREADOBJECT->filterverbosecallctr)
193 #endif
194
195 /* state for trace java call **************************************************/
196
197 #if !defined(NDEBUG)
198 #       define TRACEJAVACALLINDENT (THREADOBJECT->tracejavacallindent)
199 #       define TRACEJAVACALLCOUNT (THREADOBJECT->tracejavacallcount)
200 #endif
201
202
203 /* inline functions ***********************************************************/
204
205 /* thread_get_current **********************************************************
206
207    Return the threadobject of the current thread.
208    
209    RETURN:
210        the current threadobject *
211
212 *******************************************************************************/
213
214 inline static threadobject *thread_get_current(void)
215 {
216         threadobject *t;
217
218 #if defined(HAVE___THREAD)
219         t = thread_current;
220 #else
221         t = (threadobject *) pthread_getspecific(thread_current_key);
222 #endif
223
224         return t;
225 }
226
227
228 /* thread_set_current **********************************************************
229
230    Set the current thread object.
231    
232    IN:
233       t ... the thread object to set
234
235 *******************************************************************************/
236
237 inline static void thread_set_current(threadobject *t)
238 {
239 #if defined(HAVE___THREAD)
240         thread_current = t;
241 #else
242         int result;
243
244         result = pthread_setspecific(thread_current_key, t);
245
246         if (result != 0)
247                 vm_abort_errnum(result, "thread_set_current: pthread_setspecific failed");
248 #endif
249 }
250
251
252 inline static stackframeinfo_t *threads_get_current_stackframeinfo(void)
253 {
254         return THREADOBJECT->_stackframeinfo;
255 }
256
257 inline static void threads_set_current_stackframeinfo(stackframeinfo_t *sfi)
258 {
259         THREADOBJECT->_stackframeinfo = sfi;
260 }
261
262
263 /* functions ******************************************************************/
264
265 void threads_sem_init(sem_t *sem, bool shared, int value);
266 void threads_sem_wait(sem_t *sem);
267 void threads_sem_post(sem_t *sem);
268
269 void threads_start_thread(threadobject *thread, functionptr function);
270
271 void threads_set_thread_priority(pthread_t tid, int priority);
272
273 #if defined(ENABLE_GC_CACAO)
274 bool threads_suspend_thread(threadobject *thread, s4 reason);
275 void threads_suspend_ack(u1* pc, u1* sp);
276 bool threads_resume_thread(threadobject *thread);
277 #endif
278
279 void threads_join_all_threads(void);
280
281 void threads_sleep(int64_t millis, int32_t nanos);
282
283 void threads_wait_with_timeout_relative(threadobject *t, s8 millis, s4 nanos);
284
285 void threads_thread_interrupt(threadobject *thread);
286
287 #endif /* _THREAD_POSIX_H */
288
289
290 /*
291  * These are local overrides for various environment variables in Emacs.
292  * Please do not remove this and leave it at the end of the file, where
293  * Emacs will automagically detect them.
294  * ---------------------------------------------------------------------
295  * Local variables:
296  * mode: c
297  * indent-tabs-mode: t
298  * c-basic-offset: 4
299  * tab-width: 4
300  * End:
301  * vim:noexpandtab:sw=4:ts=4:
302  */