]>
gcc.gnu.org Git - gcc.git/blob - libgcc/gthr.h
1 /* Threads compatibility routines for libgcc2. */
2 /* Compile this one with gcc. */
3 /* Copyright (C) 1997-2019 Free Software Foundation, Inc.
5 This file is part of GCC.
7 GCC is free software; you can redistribute it and/or modify it under
8 the terms of the GNU General Public License as published by the Free
9 Software Foundation; either version 3, or (at your option) any later
12 GCC is distributed in the hope that it will be useful, but WITHOUT ANY
13 WARRANTY; without even the implied warranty of MERCHANTABILITY or
14 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
17 Under Section 7 of GPL version 3, you are granted additional
18 permissions described in the GCC Runtime Library Exception, version
19 3.1, as published by the Free Software Foundation.
21 You should have received a copy of the GNU General Public License and
22 a copy of the GCC Runtime Library Exception along with this program;
23 see the files COPYING3 and COPYING.RUNTIME respectively. If not, see
24 <http://www.gnu.org/licenses/>. */
30 #pragma GCC visibility push(default)
33 /* If this file is compiled with threads support, it must
35 to indicate that threads support is present. Also it has define
37 int __gthread_active_p ()
38 that returns 1 if thread system is active, 0 if not.
40 The threads interface must define the following types:
44 __gthread_recursive_mutex_t
46 The threads interface must define the following macros:
49 to initialize __gthread_once_t
51 to initialize __gthread_mutex_t to get a fast
53 __GTHREAD_MUTEX_INIT_FUNCTION
54 to initialize __gthread_mutex_t to get a fast
56 Define this to a function which looks like this:
57 void __GTHREAD_MUTEX_INIT_FUNCTION (__gthread_mutex_t *)
58 Some systems can't initialize a mutex without a
59 function call. 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.
64 The threads interface must define the following static functions:
66 int __gthread_once (__gthread_once_t *once, void (*func) ())
68 int __gthread_key_create (__gthread_key_t *keyp, void (*dtor) (void *))
69 int __gthread_key_delete (__gthread_key_t key)
71 void *__gthread_getspecific (__gthread_key_t key)
72 int __gthread_setspecific (__gthread_key_t key, const void *ptr)
74 int __gthread_mutex_destroy (__gthread_mutex_t *mutex);
75 int __gthread_recursive_mutex_destroy (__gthread_recursive_mutex_t *mutex);
77 int __gthread_mutex_lock (__gthread_mutex_t *mutex);
78 int __gthread_mutex_trylock (__gthread_mutex_t *mutex);
79 int __gthread_mutex_unlock (__gthread_mutex_t *mutex);
81 int __gthread_recursive_mutex_lock (__gthread_recursive_mutex_t *mutex);
82 int __gthread_recursive_mutex_trylock (__gthread_recursive_mutex_t *mutex);
83 int __gthread_recursive_mutex_unlock (__gthread_recursive_mutex_t *mutex);
85 The following are supported in POSIX threads only. They are required to
86 fix a deadlock in static initialization inside libsupc++. The header file
87 gthr-posix.h defines a symbol __GTHREAD_HAS_COND to signify that these extra
88 features are supported.
95 __GTHREAD_COND_INIT_FUNCTION
98 int __gthread_cond_broadcast (__gthread_cond_t *cond);
99 int __gthread_cond_wait (__gthread_cond_t *cond, __gthread_mutex_t *mutex);
100 int __gthread_cond_wait_recursive (__gthread_cond_t *cond,
101 __gthread_recursive_mutex_t *mutex);
103 All functions returning int should return zero on success or the error
104 number. If the operation is not supported, -1 is returned.
106 If the following are also defined, you should
107 #define __GTHREADS_CXX0X 1
108 to enable the c++0x thread library.
115 int __gthread_create (__gthread_t *thread, void *(*func) (void*),
117 int __gthread_join (__gthread_t thread, void **value_ptr);
118 int __gthread_detach (__gthread_t thread);
119 int __gthread_equal (__gthread_t t1, __gthread_t t2);
120 __gthread_t __gthread_self (void);
121 int __gthread_yield (void);
123 int __gthread_mutex_timedlock (__gthread_mutex_t *m,
124 const __gthread_time_t *abs_timeout);
125 int __gthread_recursive_mutex_timedlock (__gthread_recursive_mutex_t *m,
126 const __gthread_time_t *abs_time);
128 int __gthread_cond_signal (__gthread_cond_t *cond);
129 int __gthread_cond_timedwait (__gthread_cond_t *cond,
130 __gthread_mutex_t *mutex,
131 const __gthread_time_t *abs_timeout);
136 /* The pe-coff weak support isn't fully compatible to ELF's weak.
137 For static libraries it might would work, but as we need to deal
138 with shared versions too, we disable it for mingw-targets. */
140 #undef GTHREAD_USE_WEAK
141 #define GTHREAD_USE_WEAK 0
144 #ifndef GTHREAD_USE_WEAK
145 #define GTHREAD_USE_WEAK 1
148 #include "gthr-default.h"
151 #pragma GCC visibility pop
154 #endif /* ! GCC_GTHR_H */
This page took 0.048273 seconds and 5 git commands to generate.