* arm.h (REVERSE_CONDITION): Define.
[official-gcc.git] / gcc / gthr-win32.h
blob3e1aac7fce093930e3ad64dc36e8c47caeb25b12
1 /* Threads compatibility routines for libgcc2 and libobjc. */
2 /* Compile this one with gcc. */
3 /* Copyright (C) 1999, 2000, 2002, 2003, 2004 Free Software Foundation, Inc.
4 Contributed by Mumit Khan <khan@xraylith.wisc.edu>.
6 This file is part of GCC.
8 GCC is free software; you can redistribute it and/or modify it under
9 the terms of the GNU General Public License as published by the Free
10 Software Foundation; either version 2, or (at your option) any later
11 version.
13 GCC is distributed in the hope that it will be useful, but WITHOUT ANY
14 WARRANTY; without even the implied warranty of MERCHANTABILITY or
15 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
16 for more details.
18 You should have received a copy of the GNU General Public License
19 along with GCC; see the file COPYING. If not, write to the Free
20 Software Foundation, 59 Temple Place - Suite 330, Boston, MA
21 02111-1307, USA. */
23 /* As a special exception, if you link this library with other files,
24 some of which are compiled with GCC, to produce an executable,
25 this library does not by itself cause the resulting executable
26 to be covered by the GNU General Public License.
27 This exception does not however invalidate any other reasons why
28 the executable file might be covered by the GNU General Public License. */
30 #ifndef GCC_GTHR_WIN32_H
31 #define GCC_GTHR_WIN32_H
33 /* Windows32 threads specific definitions. The windows32 threading model
34 does not map well into pthread-inspired gcc's threading model, and so
35 there are caveats one needs to be aware of.
37 1. The destructor supplied to __gthread_key_create is ignored for
38 generic x86-win32 ports. This will certainly cause memory leaks
39 due to unreclaimed eh contexts (sizeof (eh_context) is at least
40 24 bytes for x86 currently).
42 This memory leak may be significant for long-running applications
43 that make heavy use of C++ EH.
45 However, Mingw runtime (version 0.3 or newer) provides a mechanism
46 to emulate pthreads key dtors; the runtime provides a special DLL,
47 linked in if -mthreads option is specified, that runs the dtors in
48 the reverse order of registration when each thread exits. If
49 -mthreads option is not given, a stub is linked in instead of the
50 DLL, which results in memory leak. Other x86-win32 ports can use
51 the same technique of course to avoid the leak.
53 2. The error codes returned are non-POSIX like, and cast into ints.
54 This may cause incorrect error return due to truncation values on
55 hw where sizeof (DWORD) > sizeof (int).
57 3. We are currently using a special mutex instead of the Critical
58 Sections, since Win9x does not support TryEnterCriticalSection
59 (while NT does).
61 The basic framework should work well enough. In the long term, GCC
62 needs to use Structured Exception Handling on Windows32. */
64 #define __GTHREADS 1
66 #include <errno.h>
67 #ifdef __MINGW32__
68 #include <_mingw.h>
69 #endif
71 #ifdef _LIBOBJC
73 /* This is necessary to prevent windef.h (included from windows.h) from
74 defining it's own BOOL as a typedef. */
75 #ifndef __OBJC__
76 #define __OBJC__
77 #endif
78 #include <windows.h>
79 /* Now undef the windows BOOL. */
80 #undef BOOL
82 /* Key structure for maintaining thread specific storage */
83 static DWORD __gthread_objc_data_tls = (DWORD) -1;
85 /* Backend initialization functions */
87 /* Initialize the threads subsystem. */
88 int
89 __gthread_objc_init_thread_system (void)
91 /* Initialize the thread storage key */
92 if ((__gthread_objc_data_tls = TlsAlloc ()) != (DWORD) -1)
93 return 0;
94 else
95 return -1;
98 /* Close the threads subsystem. */
99 int
100 __gthread_objc_close_thread_system (void)
102 if (__gthread_objc_data_tls != (DWORD) -1)
103 TlsFree (__gthread_objc_data_tls);
104 return 0;
107 /* Backend thread functions */
109 /* Create a new thread of execution. */
110 objc_thread_t
111 __gthread_objc_thread_detach (void (*func)(void *arg), void *arg)
113 DWORD thread_id = 0;
114 HANDLE win32_handle;
116 if (!(win32_handle = CreateThread (NULL, 0, (LPTHREAD_START_ROUTINE) func,
117 arg, 0, &thread_id)))
118 thread_id = 0;
120 return (objc_thread_t) thread_id;
123 /* Set the current thread's priority. */
125 __gthread_objc_thread_set_priority (int priority)
127 int sys_priority = 0;
129 switch (priority)
131 case OBJC_THREAD_INTERACTIVE_PRIORITY:
132 sys_priority = THREAD_PRIORITY_NORMAL;
133 break;
134 default:
135 case OBJC_THREAD_BACKGROUND_PRIORITY:
136 sys_priority = THREAD_PRIORITY_BELOW_NORMAL;
137 break;
138 case OBJC_THREAD_LOW_PRIORITY:
139 sys_priority = THREAD_PRIORITY_LOWEST;
140 break;
143 /* Change priority */
144 if (SetThreadPriority (GetCurrentThread (), sys_priority))
145 return 0;
146 else
147 return -1;
150 /* Return the current thread's priority. */
152 __gthread_objc_thread_get_priority (void)
154 int sys_priority;
156 sys_priority = GetThreadPriority (GetCurrentThread ());
158 switch (sys_priority)
160 case THREAD_PRIORITY_HIGHEST:
161 case THREAD_PRIORITY_TIME_CRITICAL:
162 case THREAD_PRIORITY_ABOVE_NORMAL:
163 case THREAD_PRIORITY_NORMAL:
164 return OBJC_THREAD_INTERACTIVE_PRIORITY;
166 default:
167 case THREAD_PRIORITY_BELOW_NORMAL:
168 return OBJC_THREAD_BACKGROUND_PRIORITY;
170 case THREAD_PRIORITY_IDLE:
171 case THREAD_PRIORITY_LOWEST:
172 return OBJC_THREAD_LOW_PRIORITY;
175 /* Couldn't get priority. */
176 return -1;
179 /* Yield our process time to another thread. */
180 void
181 __gthread_objc_thread_yield (void)
183 Sleep (0);
186 /* Terminate the current thread. */
188 __gthread_objc_thread_exit (void)
190 /* exit the thread */
191 ExitThread (__objc_thread_exit_status);
193 /* Failed if we reached here */
194 return -1;
197 /* Returns an integer value which uniquely describes a thread. */
198 objc_thread_t
199 __gthread_objc_thread_id (void)
201 return (objc_thread_t) GetCurrentThreadId ();
204 /* Sets the thread's local storage pointer. */
206 __gthread_objc_thread_set_data (void *value)
208 if (TlsSetValue (__gthread_objc_data_tls, value))
209 return 0;
210 else
211 return -1;
214 /* Returns the thread's local storage pointer. */
215 void *
216 __gthread_objc_thread_get_data (void)
218 DWORD lasterror;
219 void *ptr;
221 lasterror = GetLastError ();
223 ptr = TlsGetValue (__gthread_objc_data_tls); /* Return thread data. */
225 SetLastError (lasterror);
227 return ptr;
230 /* Backend mutex functions */
232 /* Allocate a mutex. */
234 __gthread_objc_mutex_allocate (objc_mutex_t mutex)
236 if ((mutex->backend = (void *) CreateMutex (NULL, 0, NULL)) == NULL)
237 return -1;
238 else
239 return 0;
242 /* Deallocate a mutex. */
244 __gthread_objc_mutex_deallocate (objc_mutex_t mutex)
246 CloseHandle ((HANDLE) (mutex->backend));
247 return 0;
250 /* Grab a lock on a mutex. */
252 __gthread_objc_mutex_lock (objc_mutex_t mutex)
254 int status;
256 status = WaitForSingleObject ((HANDLE) (mutex->backend), INFINITE);
257 if (status != WAIT_OBJECT_0 && status != WAIT_ABANDONED)
258 return -1;
259 else
260 return 0;
263 /* Try to grab a lock on a mutex. */
265 __gthread_objc_mutex_trylock (objc_mutex_t mutex)
267 int status;
269 status = WaitForSingleObject ((HANDLE) (mutex->backend), 0);
270 if (status != WAIT_OBJECT_0 && status != WAIT_ABANDONED)
271 return -1;
272 else
273 return 0;
276 /* Unlock the mutex */
278 __gthread_objc_mutex_unlock (objc_mutex_t mutex)
280 if (ReleaseMutex ((HANDLE) (mutex->backend)) == 0)
281 return -1;
282 else
283 return 0;
286 /* Backend condition mutex functions */
288 /* Allocate a condition. */
290 __gthread_objc_condition_allocate (objc_condition_t condition)
292 /* Unimplemented. */
293 return -1;
296 /* Deallocate a condition. */
298 __gthread_objc_condition_deallocate (objc_condition_t condition)
300 /* Unimplemented. */
301 return -1;
304 /* Wait on the condition */
306 __gthread_objc_condition_wait (objc_condition_t condition, objc_mutex_t mutex)
308 /* Unimplemented. */
309 return -1;
312 /* Wake up all threads waiting on this condition. */
314 __gthread_objc_condition_broadcast (objc_condition_t condition)
316 /* Unimplemented. */
317 return -1;
320 /* Wake up one thread waiting on this condition. */
322 __gthread_objc_condition_signal (objc_condition_t condition)
324 /* Unimplemented. */
325 return -1;
328 #else /* _LIBOBJC */
330 #ifdef __cplusplus
331 extern "C" {
332 #endif
334 typedef unsigned long __gthread_key_t;
336 typedef struct {
337 int done;
338 long started;
339 } __gthread_once_t;
341 typedef struct {
342 long counter;
343 void *sema;
344 } __gthread_mutex_t;
346 typedef struct {
347 long counter;
348 long depth;
349 DWORD owner;
350 void *sema;
351 } __gthread_recursive_mutex_t;
353 #define __GTHREAD_ONCE_INIT {0, -1}
354 #define __GTHREAD_MUTEX_INIT_FUNCTION __gthread_mutex_init_function
355 #define __GTHREAD_MUTEX_INIT_DEFAULT {-1, 0}
356 #define __GTHREAD_RECURSIVE_MUTEX_INIT_FUNCTION __gthread_mutex_init_function
357 #define __GTHREAD_RECURSIVE_MUTEX_INIT_DEFAULT {-1, 0}
359 #if __MINGW32_MAJOR_VERSION >= 1 || \
360 (__MINGW32_MAJOR_VERSION == 0 && __MINGW32_MINOR_VERSION > 2)
361 #define MINGW32_SUPPORTS_MT_EH 1
362 /* Mingw runtime >= v0.3 provides a magic variable that is set to nonzero
363 if -mthreads option was specified, or 0 otherwise. This is to get around
364 the lack of weak symbols in PE-COFF. */
365 extern int _CRT_MT;
366 extern int __mingwthr_key_dtor (unsigned long, void (*) (void *));
367 #endif /* __MINGW32__ version */
369 /* The Windows95 kernel does not export InterlockedCompareExchange.
370 This provides a substitute. When building apps that reference
371 gthread_mutex_try_lock, the __GTHREAD_I486_INLINE_LOCK_PRIMITIVES
372 macro must be defined if Windows95 is a target. Currently
373 gthread_mutex_try_lock is not referenced by libgcc or libstdc++. */
374 #ifdef __GTHREAD_I486_INLINE_LOCK_PRIMITIVES
375 static inline long
376 __gthr_i486_lock_cmp_xchg(long *dest, long xchg, long comperand)
378 long result;
379 __asm__ __volatile__ ("\n\
380 lock\n\
381 cmpxchg{l} {%4, %1|%1, %4}\n"
382 : "=a" (result), "=m" (*dest)
383 : "0" (comperand), "m" (*dest), "r" (xchg)
384 : "cc");
385 return result;
387 #define __GTHR_W32_InterlockedCompareExchange __gthr_i486_lock_cmp_xchg
388 #else /* __GTHREAD_I486_INLINE_LOCK_PRIMITIVES */
389 #define __GTHR_W32_InterlockedCompareExchange InterlockedCompareExchange
390 #endif /* __GTHREAD_I486_INLINE_LOCK_PRIMITIVES */
392 static inline int
393 __gthread_active_p (void)
395 #ifdef MINGW32_SUPPORTS_MT_EH
396 return _CRT_MT;
397 #else
398 return 1;
399 #endif
402 #if __GTHREAD_HIDE_WIN32API
404 /* The implementations are in config/i386/gthr-win32.c in libgcc.a.
405 Only stubs are exposed to avoid polluting the C++ namespace with
406 windows api definitions. */
408 extern int __gthr_win32_once (__gthread_once_t *, void (*) (void));
409 extern int __gthr_win32_key_create (__gthread_key_t *, void (*) (void*));
410 extern int __gthr_win32_key_delete (__gthread_key_t);
411 extern void * __gthr_win32_getspecific (__gthread_key_t);
412 extern int __gthr_win32_setspecific (__gthread_key_t, const void *);
413 extern void __gthr_win32_mutex_init_function (__gthread_mutex_t *);
414 extern int __gthr_win32_mutex_lock (__gthread_mutex_t *);
415 extern int __gthr_win32_mutex_trylock (__gthread_mutex_t *);
416 extern int __gthr_win32_mutex_unlock (__gthread_mutex_t *);
418 static inline int
419 __gthread_once (__gthread_once_t *once, void (*func) (void))
421 if (__gthread_active_p ())
422 return __gthr_win32_once (once, func);
423 else
424 return -1;
427 static inline int
428 __gthread_key_create (__gthread_key_t *key, void (*dtor) (void *))
430 return __gthr_win32_key_create (key, dtor);
433 static inline int
434 __gthread_key_delete (__gthread_key_t key)
436 return __gthr_win32_key_delete (key);
439 static inline void *
440 __gthread_getspecific (__gthread_key_t key)
442 return __gthr_win32_getspecific (key);
445 static inline int
446 __gthread_setspecific (__gthread_key_t key, const void *ptr)
448 return __gthr_win32_setspecific (key, ptr);
451 static inline void
452 __gthread_mutex_init_function (__gthread_mutex_t *mutex)
454 __gthr_win32_mutex_init_function (mutex);
457 static inline int
458 __gthread_mutex_lock (__gthread_mutex_t *mutex)
460 if (__gthread_active_p ())
461 return __gthr_win32_mutex_lock (mutex);
462 else
463 return 0;
466 static inline int
467 __gthread_mutex_trylock (__gthread_mutex_t *mutex)
469 if (__gthread_active_p ())
470 return __gthr_win32_mutex_trylock (mutex);
471 else
472 return 0;
475 static inline int
476 __gthread_mutex_unlock (__gthread_mutex_t *mutex)
478 if (__gthread_active_p ())
479 return __gthr_win32_mutex_unlock (mutex);
480 else
481 return 0;
484 static inline int
485 __gthread_recursive_mutex_lock (__gthread_recursive_mutex_t *mutex)
487 if (__gthread_active_p ())
488 return __gthr_win32_recursive_mutex_lock (mutex);
489 else
490 return 0;
493 static inline int
494 __gthread_recursive_mutex_trylock (__gthread_recursive_mutex_t *mutex)
496 if (__gthread_active_p ())
497 return __gthr_win32_recursive_mutex_trylock (mutex);
498 else
499 return 0;
502 static inline int
503 __gthread_recursive_mutex_unlock (__gthread_recursive_mutex_t *mutex)
505 if (__gthread_active_p ())
506 return __gthr_win32_recursive_mutex_unlock (mutex);
507 else
508 return 0;
511 #else /* ! __GTHREAD_HIDE_WIN32API */
513 #include <windows.h>
514 #include <errno.h>
516 static inline int
517 __gthread_once (__gthread_once_t *once, void (*func) (void))
519 if (! __gthread_active_p ())
520 return -1;
521 else if (once == NULL || func == NULL)
522 return EINVAL;
524 if (! once->done)
526 if (InterlockedIncrement (&(once->started)) == 0)
528 (*func) ();
529 once->done = TRUE;
531 else
533 /* Another thread is currently executing the code, so wait for it
534 to finish; yield the CPU in the meantime. If performance
535 does become an issue, the solution is to use an Event that
536 we wait on here (and set above), but that implies a place to
537 create the event before this routine is called. */
538 while (! once->done)
539 Sleep (0);
543 return 0;
546 /* Windows32 thread local keys don't support destructors; this leads to
547 leaks, especially in threaded applications making extensive use of
548 C++ EH. Mingw uses a thread-support DLL to work-around this problem. */
549 static inline int
550 __gthread_key_create (__gthread_key_t *key, void (*dtor) (void *))
552 int status = 0;
553 DWORD tls_index = TlsAlloc ();
554 if (tls_index != 0xFFFFFFFF)
556 *key = tls_index;
557 #ifdef MINGW32_SUPPORTS_MT_EH
558 /* Mingw runtime will run the dtors in reverse order for each thread
559 when the thread exits. */
560 status = __mingwthr_key_dtor (*key, dtor);
561 #endif
563 else
564 status = (int) GetLastError ();
565 return status;
568 static inline int
569 __gthread_key_delete (__gthread_key_t key)
571 return (TlsFree (key) != 0) ? 0 : (int) GetLastError ();
574 static inline void *
575 __gthread_getspecific (__gthread_key_t key)
577 DWORD lasterror;
578 void *ptr;
580 lasterror = GetLastError ();
582 ptr = TlsGetValue (key);
584 SetLastError (lasterror);
586 return ptr;
589 static inline int
590 __gthread_setspecific (__gthread_key_t key, const void *ptr)
592 return (TlsSetValue (key, (void*) ptr) != 0) ? 0 : (int) GetLastError ();
595 static inline void
596 __gthread_mutex_init_function (__gthread_mutex_t *mutex)
598 mutex->counter = -1;
599 mutex->sema = CreateSemaphore (NULL, 0, 65535, NULL);
602 static inline int
603 __gthread_mutex_lock (__gthread_mutex_t *mutex)
605 int status = 0;
607 if (__gthread_active_p ())
609 if (InterlockedIncrement (&mutex->counter) == 0 ||
610 WaitForSingleObject (mutex->sema, INFINITE) == WAIT_OBJECT_0)
611 status = 0;
612 else
614 /* WaitForSingleObject returns WAIT_FAILED, and we can only do
615 some best-effort cleanup here. */
616 InterlockedDecrement (&mutex->counter);
617 status = 1;
620 return status;
623 static inline int
624 __gthread_mutex_trylock (__gthread_mutex_t *mutex)
626 int status = 0;
628 if (__gthread_active_p ())
630 if (__GTHR_W32_InterlockedCompareExchange (&mutex->counter, 0, -1) < 0)
631 status = 0;
632 else
633 status = 1;
635 return status;
638 static inline int
639 __gthread_mutex_unlock (__gthread_mutex_t *mutex)
641 if (__gthread_active_p ())
643 if (InterlockedDecrement (&mutex->counter) >= 0)
644 return ReleaseSemaphore (mutex->sema, 1, NULL) ? 0 : 1;
646 return 0;
649 static inline void
650 __gthread_recursive_mutex_init_function (__gthread_recursive_mutex_t *mutex)
652 mutex->counter = -1;
653 mutex->depth = 0;
654 mutex->owner = 0;
655 mutex->sema = CreateSemaphore (NULL, 0, 65535, NULL);
658 static inline int
659 __gthread_recursive_mutex_lock (__gthread_recursive_mutex_t *mutex)
661 if (__gthread_active_p ())
663 DWORD me = GetCurrentThreadId();
664 if (InterlockedIncrement (&mutex->counter) == 0)
666 mutex->depth = 1;
667 mutex->owner = me;
669 else if (mutex->owner == me)
671 InterlockedDecrement (&mx->lock_idx);
672 ++(mutex->depth);
674 else if (WaitForSingleObject (mutex->sema, INFINITE) == WAIT_OBJECT_0)
676 mutex->depth = 1;
677 mutex->owner = me;
679 else
681 /* WaitForSingleObject returns WAIT_FAILED, and we can only do
682 some best-effort cleanup here. */
683 InterlockedDecrement (&mutex->counter);
684 return 1;
687 return 0;
690 static inline int
691 __gthread_recursive_mutex_trylock (__gthread_recursive_mutex_t *mutex)
693 if (__gthread_active_p ())
695 DWORD me = GetCurrentThreadId();
696 if (__GTHR_W32_InterlockedCompareExchange (&mutex->counter, 0, -1) < 0)
698 mutex->depth = 1;
699 mutex->owner = me;
701 else if (mutex->owner == me)
702 ++(mutex->depth);
703 else
704 return 1;
706 return 0;
709 static inline int
710 __gthread_recursive_mutex_unlock (__gthread_recursive_mutex_t *mutex)
712 if (__gthread_active_p ())
714 --(mutex->depth);
715 if (mutex->depth == 0)
717 mutex->owner = 0;
719 if (InterlockedDecrement (&mutex->counter) >= 0)
720 return ReleaseSemaphore (mutex->sema, 1, NULL) ? 0 : 1;
723 return 0;
726 #endif /* __GTHREAD_HIDE_WIN32API */
728 #ifdef __cplusplus
730 #endif
732 #endif /* _LIBOBJC */
734 #endif /* ! GCC_GTHR_WIN32_H */