Commit | Line | Data |
---|---|---|
7bfd3b9e JB |
1 | /* classes: h_files */ |
2 | ||
0527e687 DH |
3 | #ifndef SCM_THREADS_H |
4 | #define SCM_THREADS_H | |
7bfd3b9e | 5 | |
01b69e79 | 6 | /* Copyright (C) 1996, 1997, 1998, 2000, 2001, 2002, 2003, 2004, 2006, |
aef1fcf9 | 7 | * 2007, 2008, 2009, 2011, 2012, 2013, 2014 Free Software Foundation, Inc. |
0527e687 | 8 | * |
73be1d9e | 9 | * This library is free software; you can redistribute it and/or |
53befeb7 NJ |
10 | * modify it under the terms of the GNU Lesser General Public License |
11 | * as published by the Free Software Foundation; either version 3 of | |
12 | * the License, or (at your option) any later version. | |
0527e687 | 13 | * |
53befeb7 NJ |
14 | * This library is distributed in the hope that it will be useful, but |
15 | * WITHOUT ANY WARRANTY; without even the implied warranty of | |
73be1d9e MV |
16 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU |
17 | * Lesser General Public License for more details. | |
0527e687 | 18 | * |
73be1d9e MV |
19 | * You should have received a copy of the GNU Lesser General Public |
20 | * License along with this library; if not, write to the Free Software | |
53befeb7 NJ |
21 | * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA |
22 | * 02110-1301 USA | |
73be1d9e | 23 | */ |
d3a6bc94 | 24 | |
7bfd3b9e JB |
25 | \f |
26 | ||
27 | #include "libguile/__scm.h" | |
28 | #include "libguile/procs.h" | |
1651c824 | 29 | #include "libguile/throw.h" |
f7eca35d | 30 | #include "libguile/root.h" |
9ede013f | 31 | #include "libguile/dynstack.h" |
d823b11b | 32 | #include "libguile/iselect.h" |
346e4402 | 33 | #include "libguile/continuations.h" |
9de87eea MV |
34 | |
35 | #if SCM_USE_PTHREAD_THREADS | |
36 | #include "libguile/pthread-threads.h" | |
37 | #endif | |
38 | ||
39 | #if SCM_USE_NULL_THREADS | |
40 | #include "libguile/null-threads.h" | |
41 | #endif | |
42 | ||
b2728432 DH |
43 | \f |
44 | ||
7bfd3b9e | 45 | /* smob tags for the thread datatypes */ |
33b001fd MV |
46 | SCM_API scm_t_bits scm_tc16_thread; |
47 | SCM_API scm_t_bits scm_tc16_mutex; | |
48 | SCM_API scm_t_bits scm_tc16_condvar; | |
7bfd3b9e | 49 | |
9de87eea MV |
50 | typedef struct scm_i_thread { |
51 | struct scm_i_thread *next_thread; | |
52 | ||
53 | SCM handle; | |
54 | scm_i_pthread_t pthread; | |
2e77f720 LC |
55 | |
56 | SCM cleanup_handler; | |
9de87eea | 57 | SCM join_queue; |
86a597f8 NJ |
58 | |
59 | scm_i_pthread_mutex_t admin_mutex; | |
6180e336 | 60 | SCM mutexes; |
d2a51087 | 61 | scm_i_pthread_mutex_t *held_mutex; |
86a597f8 | 62 | |
9de87eea | 63 | SCM result; |
2e77f720 | 64 | int canceled; |
9de87eea MV |
65 | int exited; |
66 | ||
72e6b608 LC |
67 | /* Boolean indicating whether the thread is in guile mode. */ |
68 | int guile_mode; | |
69 | ||
9de87eea MV |
70 | SCM sleep_object; |
71 | scm_i_pthread_mutex_t *sleep_mutex; | |
72 | scm_i_pthread_cond_t sleep_cond; | |
73 | int sleep_fd, sleep_pipe[2]; | |
74 | ||
aef1fcf9 AW |
75 | /* Thread-local freelists; see gc-inline.h. */ |
76 | void **freelists; | |
77 | void **pointerless_freelists; | |
78 | ||
9de87eea MV |
79 | /* Other thread local things. |
80 | */ | |
81 | SCM dynamic_state; | |
9ede013f AW |
82 | |
83 | /* The dynamic stack. */ | |
84 | scm_t_dynstack dynstack; | |
9de87eea MV |
85 | |
86 | /* For system asyncs. | |
87 | */ | |
88 | SCM active_asyncs; /* The thunks to be run at the next | |
89 | safe point */ | |
74926120 | 90 | unsigned int block_asyncs; /* Non-zero means that asyncs should |
9de87eea MV |
91 | not be run. */ |
92 | unsigned int pending_asyncs; /* Non-zero means that asyncs might be pending. | |
93 | */ | |
94 | ||
95 | /* The current continuation root and the stack base for it. | |
96 | ||
97 | The continuation root is an arbitrary but unique object that | |
98 | identifies a dynamic extent. Continuations created during that | |
99 | extent can also only be invoked during it. | |
100 | ||
101 | We use pairs where the car is the thread handle and the cdr links | |
102 | to the previous pair. This might be used for better error | |
103 | messages but is not essential for identifying continuation roots. | |
104 | ||
105 | The continuation base is the far end of the stack upto which it | |
106 | needs to be copied. | |
107 | */ | |
108 | SCM continuation_root; | |
109 | SCM_STACKITEM *continuation_base; | |
110 | ||
111 | /* For keeping track of the stack and registers. */ | |
3506b152 | 112 | struct scm_vm *vp; |
9de87eea | 113 | SCM_STACKITEM *base; |
a4dbe1ac | 114 | scm_i_jmp_buf regs; |
346e4402 NJ |
115 | #ifdef __ia64__ |
116 | void *register_backing_store_base; | |
117 | scm_t_contregs *pending_rbs_continuation; | |
118 | #endif | |
9de87eea | 119 | |
87f30eda NJ |
120 | /* Whether this thread is in a critical section. */ |
121 | int critical_section_level; | |
122 | ||
9de87eea MV |
123 | } scm_i_thread; |
124 | ||
125 | #define SCM_I_IS_THREAD(x) SCM_SMOB_PREDICATE (scm_tc16_thread, x) | |
126 | #define SCM_I_THREAD_DATA(x) ((scm_i_thread *) SCM_SMOB_DATA (x)) | |
7bfd3b9e | 127 | |
d823b11b | 128 | #define SCM_VALIDATE_THREAD(pos, a) \ |
9de87eea | 129 | scm_assert_smob_type (scm_tc16_thread, (a)) |
d823b11b | 130 | #define SCM_VALIDATE_MUTEX(pos, a) \ |
9de87eea | 131 | scm_assert_smob_type (scm_tc16_mutex, (a)) |
d823b11b | 132 | #define SCM_VALIDATE_CONDVAR(pos, a) \ |
9de87eea | 133 | scm_assert_smob_type (scm_tc16_condvar, (a)) |
d823b11b | 134 | |
33b001fd MV |
135 | SCM_API SCM scm_spawn_thread (scm_t_catch_body body, void *body_data, |
136 | scm_t_catch_handler handler, void *handler_data); | |
76da80e7 | 137 | |
9de87eea | 138 | SCM_API void *scm_without_guile (void *(*func)(void *), void *data); |
9de87eea | 139 | SCM_API void *scm_with_guile (void *(*func)(void *), void *data); |
98648121 | 140 | |
aafb4ed7 | 141 | SCM_INTERNAL void scm_i_reset_fluid (size_t); |
12c1d861 | 142 | SCM_INTERNAL void scm_threads_prehistory (void *); |
102dbb6f LC |
143 | SCM_INTERNAL void scm_init_threads (void); |
144 | SCM_INTERNAL void scm_init_thread_procs (void); | |
145 | SCM_INTERNAL void scm_init_threads_default_dynamic_state (void); | |
9de87eea | 146 | |
e676a4c3 | 147 | SCM_INTERNAL void scm_i_dynwind_pthread_mutex_lock_block_asyncs (scm_i_pthread_mutex_t *mutex); |
d823b11b | 148 | |
d823b11b | 149 | SCM_API SCM scm_call_with_new_thread (SCM thunk, SCM handler); |
29717c89 | 150 | SCM_API SCM scm_yield (void); |
2e77f720 LC |
151 | SCM_API SCM scm_cancel_thread (SCM t); |
152 | SCM_API SCM scm_set_thread_cleanup_x (SCM thread, SCM proc); | |
153 | SCM_API SCM scm_thread_cleanup (SCM thread); | |
33b001fd | 154 | SCM_API SCM scm_join_thread (SCM t); |
6180e336 NJ |
155 | SCM_API SCM scm_join_thread_timed (SCM t, SCM timeout, SCM timeoutval); |
156 | SCM_API SCM scm_thread_p (SCM t); | |
9de87eea | 157 | |
33b001fd | 158 | SCM_API SCM scm_make_mutex (void); |
9de87eea | 159 | SCM_API SCM scm_make_recursive_mutex (void); |
6180e336 | 160 | SCM_API SCM scm_make_mutex_with_flags (SCM flags); |
33b001fd | 161 | SCM_API SCM scm_lock_mutex (SCM m); |
adc085f1 | 162 | SCM_API SCM scm_lock_mutex_timed (SCM m, SCM timeout, SCM owner); |
661ae7ab | 163 | SCM_API void scm_dynwind_lock_mutex (SCM mutex); |
5f05c406 | 164 | SCM_API SCM scm_try_mutex (SCM m); |
33b001fd | 165 | SCM_API SCM scm_unlock_mutex (SCM m); |
6180e336 NJ |
166 | SCM_API SCM scm_unlock_mutex_timed (SCM m, SCM cond, SCM timeout); |
167 | SCM_API SCM scm_mutex_p (SCM o); | |
adc085f1 JG |
168 | SCM_API SCM scm_mutex_locked_p (SCM m); |
169 | SCM_API SCM scm_mutex_owner (SCM m); | |
170 | SCM_API SCM scm_mutex_level (SCM m); | |
9de87eea | 171 | |
33b001fd MV |
172 | SCM_API SCM scm_make_condition_variable (void); |
173 | SCM_API SCM scm_wait_condition_variable (SCM cond, SCM mutex); | |
5f05c406 MV |
174 | SCM_API SCM scm_timed_wait_condition_variable (SCM cond, SCM mutex, |
175 | SCM abstime); | |
33b001fd | 176 | SCM_API SCM scm_signal_condition_variable (SCM cond); |
5f05c406 | 177 | SCM_API SCM scm_broadcast_condition_variable (SCM cond); |
6180e336 | 178 | SCM_API SCM scm_condition_variable_p (SCM o); |
6d71500e | 179 | |
f7eca35d MV |
180 | SCM_API SCM scm_current_thread (void); |
181 | SCM_API SCM scm_all_threads (void); | |
182 | ||
5f05c406 MV |
183 | SCM_API int scm_c_thread_exited_p (SCM thread); |
184 | SCM_API SCM scm_thread_exited_p (SCM thread); | |
185 | ||
661ae7ab | 186 | SCM_API void scm_dynwind_critical_section (SCM mutex); |
9de87eea | 187 | |
46935a1f LC |
188 | #ifdef BUILDING_LIBGUILE |
189 | ||
f60a7648 AW |
190 | /* Though we don't need the key for SCM_I_CURRENT_THREAD if we have TLS, |
191 | we do use it for cleanup purposes. */ | |
192 | SCM_INTERNAL scm_i_pthread_key_t scm_i_thread_key; | |
193 | ||
705edb95 LC |
194 | # ifdef SCM_HAVE_THREAD_STORAGE_CLASS |
195 | ||
196 | SCM_INTERNAL SCM_THREAD_LOCAL scm_i_thread *scm_i_current_thread; | |
197 | # define SCM_I_CURRENT_THREAD (scm_i_current_thread) | |
198 | ||
199 | # else /* !SCM_HAVE_THREAD_STORAGE_CLASS */ | |
200 | ||
705edb95 LC |
201 | # define SCM_I_CURRENT_THREAD \ |
202 | ((scm_i_thread *) scm_i_pthread_getspecific (scm_i_thread_key)) | |
203 | ||
204 | # endif /* !SCM_HAVE_THREAD_STORAGE_CLASS */ | |
9de87eea | 205 | |
46935a1f LC |
206 | #endif /* BUILDING_LIBGUILE */ |
207 | ||
102dbb6f | 208 | SCM_INTERNAL scm_i_pthread_mutex_t scm_i_misc_mutex; |
9bc4701c | 209 | |
9de87eea MV |
210 | /* Convenience functions for working with the pthread API in guile |
211 | mode. | |
212 | */ | |
213 | ||
214 | #if SCM_USE_PTHREAD_THREADS | |
215 | SCM_API int scm_pthread_mutex_lock (pthread_mutex_t *mutex); | |
661ae7ab | 216 | SCM_API void scm_dynwind_pthread_mutex_lock (pthread_mutex_t *mutex); |
9de87eea MV |
217 | SCM_API int scm_pthread_cond_wait (pthread_cond_t *cond, |
218 | pthread_mutex_t *mutex); | |
219 | SCM_API int scm_pthread_cond_timedwait (pthread_cond_t *cond, | |
220 | pthread_mutex_t *mutex, | |
ab878b0f | 221 | const scm_t_timespec *abstime); |
9de87eea MV |
222 | #endif |
223 | ||
224 | /* More convenience functions. | |
225 | */ | |
d823b11b | 226 | |
9de87eea MV |
227 | SCM_API unsigned int scm_std_sleep (unsigned int); |
228 | SCM_API unsigned long scm_std_usleep (unsigned long); | |
50dc1840 | 229 | |
d20912e6 LC |
230 | SCM_API SCM scm_total_processor_count (void); |
231 | SCM_API SCM scm_current_processor_count (void); | |
232 | ||
0527e687 | 233 | #endif /* SCM_THREADS_H */ |
89e00824 ML |
234 | |
235 | /* | |
236 | Local Variables: | |
237 | c-file-style: "gnu" | |
238 | End: | |
239 | */ |