OSDN Git Service

gcc:
[pf3gnuchains/gcc-fork.git] / gcc / gthr.h
1 /* Threads compatibility routines for libgcc2.  */
2 /* Compile this one with gcc.  */
3 /* Copyright (C) 1997, 1998, 2004, 2008, 2009, 2011
4    Free Software Foundation, Inc.
5
6 This file is part of GCC.
7
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 3, or (at your option) any later
11 version.
12
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.
17
18 Under Section 7 of GPL version 3, you are granted additional
19 permissions described in the GCC Runtime Library Exception, version
20 3.1, as published by the Free Software Foundation.
21
22 You should have received a copy of the GNU General Public License and
23 a copy of the GCC Runtime Library Exception along with this program;
24 see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
25 <http://www.gnu.org/licenses/>.  */
26
27 #ifndef GCC_GTHR_H
28 #define GCC_GTHR_H
29
30 #ifndef HIDE_EXPORTS
31 #pragma GCC visibility push(default)
32 #endif
33
34 /* If this file is compiled with threads support, it must
35        #define __GTHREADS 1
36    to indicate that threads support is present.  Also it has define
37    function
38      int __gthread_active_p ()
39    that returns 1 if thread system is active, 0 if not.
40
41    The threads interface must define the following types:
42      __gthread_key_t
43      __gthread_once_t
44      __gthread_mutex_t
45      __gthread_recursive_mutex_t
46
47    The threads interface must define the following macros:
48
49      __GTHREAD_ONCE_INIT
50                 to initialize __gthread_once_t
51      __GTHREAD_MUTEX_INIT
52                 to initialize __gthread_mutex_t to get a fast
53                 non-recursive mutex.
54      __GTHREAD_MUTEX_INIT_FUNCTION
55                 some systems can't initialize a mutex without a
56                 function call.  On such systems, define this to a
57                 function which looks like this:
58                   void __GTHREAD_MUTEX_INIT_FUNCTION (__gthread_mutex_t *)
59                 Don't define __GTHREAD_MUTEX_INIT in this case
60      __GTHREAD_RECURSIVE_MUTEX_INIT
61      __GTHREAD_RECURSIVE_MUTEX_INIT_FUNCTION
62                 as above, but for a recursive mutex.
63
64    The threads interface must define the following static functions:
65
66      int __gthread_once (__gthread_once_t *once, void (*func) ())
67
68      int __gthread_key_create (__gthread_key_t *keyp, void (*dtor) (void *))
69      int __gthread_key_delete (__gthread_key_t key)
70
71      void *__gthread_getspecific (__gthread_key_t key)
72      int __gthread_setspecific (__gthread_key_t key, const void *ptr)
73
74      int __gthread_mutex_destroy (__gthread_mutex_t *mutex);
75
76      int __gthread_mutex_lock (__gthread_mutex_t *mutex);
77      int __gthread_mutex_trylock (__gthread_mutex_t *mutex);
78      int __gthread_mutex_unlock (__gthread_mutex_t *mutex);
79
80      int __gthread_recursive_mutex_lock (__gthread_recursive_mutex_t *mutex);
81      int __gthread_recursive_mutex_trylock (__gthread_recursive_mutex_t *mutex);
82      int __gthread_recursive_mutex_unlock (__gthread_recursive_mutex_t *mutex);
83
84    The following are supported in POSIX threads only. They are required to
85    fix a deadlock in static initialization inside libsupc++. The header file
86    gthr-posix.h defines a symbol __GTHREAD_HAS_COND to signify that these extra
87    features are supported.
88
89    Types:
90      __gthread_cond_t
91
92    Macros:
93      __GTHREAD_COND_INIT
94      __GTHREAD_COND_INIT_FUNCTION
95
96    Interface:
97      int __gthread_cond_broadcast (__gthread_cond_t *cond);
98      int __gthread_cond_wait (__gthread_cond_t *cond, __gthread_mutex_t *mutex);
99      int __gthread_cond_wait_recursive (__gthread_cond_t *cond,
100                                         __gthread_recursive_mutex_t *mutex);
101
102    All functions returning int should return zero on success or the error
103    number.  If the operation is not supported, -1 is returned.
104
105    If the following are also defined, you should
106      #define __GTHREADS_CXX0X 1
107    to enable the c++0x thread library.
108
109    Types:
110      __gthread_t
111      __gthread_time_t
112
113    Interface:
114      int __gthread_create (__gthread_t *thread, void *(*func) (void*),
115                            void *args);
116      int __gthread_join (__gthread_t thread, void **value_ptr);
117      int __gthread_detach (__gthread_t thread);
118      int __gthread_equal (__gthread_t t1, __gthread_t t2);
119      __gthread_t __gthread_self (void);
120      int __gthread_yield (void);
121
122      int __gthread_mutex_timedlock (__gthread_mutex_t *m,
123                                     const __gthread_time_t *abs_timeout);
124      int __gthread_recursive_mutex_timedlock (__gthread_recursive_mutex_t *m,
125                                           const __gthread_time_t *abs_time);
126
127      int __gthread_cond_signal (__gthread_cond_t *cond);
128      int __gthread_cond_timedwait (__gthread_cond_t *cond,
129                                    __gthread_mutex_t *mutex,
130                                    const __gthread_time_t *abs_timeout);
131      int __gthread_cond_timedwait_recursive (__gthread_cond_t *cond,
132                                              __gthread_recursive_mutex_t *mutex,
133                                              const __gthread_time_t *abs_time)
134
135    Currently supported threads packages are
136      TPF threads with -D__tpf__
137      POSIX/Unix98 threads with -D_PTHREADS
138      POSIX/Unix95 threads with -D_PTHREADS95
139      DCE threads with -D_DCE_THREADS
140
141 */
142
143 /* Check first for thread specific defines.  */
144 #if defined (__tpf__)
145 #include "gthr-tpf.h"
146 #elif _PTHREADS
147 #include "gthr-posix.h"
148 #elif _PTHREADS95
149 #include "gthr-posix95.h"
150 #elif _DCE_THREADS
151 #include "gthr-dce.h"
152
153 /* Include GTHREAD_FILE if one is defined.  */
154 #elif defined(HAVE_GTHR_DEFAULT)
155 #if SUPPORTS_WEAK
156 #ifndef GTHREAD_USE_WEAK
157 #define GTHREAD_USE_WEAK 1
158 #endif
159 #endif
160 #include "gthr-default.h"
161
162 /* Fallback to single thread definitions.  */
163 #else
164 #include "gthr-single.h"
165 #endif
166
167 #ifndef HIDE_EXPORTS
168 #pragma GCC visibility pop
169 #endif
170
171 #endif /* ! GCC_GTHR_H */