source: libcfa/src/concurrency/invoke.h @ 038110a

arm-ehjacob/cs343-translationnew-ast-unique-expr
Last change on this file since 038110a was 038110a, checked in by Thierry Delisle <tdelisle@…>, 14 months ago

Fixed typos and added thread/monitor/coroutine wrapper for gdb

  • Property mode set to 100644
File size: 7.6 KB
Line 
1//
2// Cforall Version 1.0.0 Copyright (C) 2016 University of Waterloo
3//
4// The contents of this file are covered under the licence agreement in the
5// file "LICENCE" distributed with Cforall.
6//
7// invoke.h --
8//
9// Author           : Thierry Delisle
10// Created On       : Tue Jan 17 12:27:26 2016
11// Last Modified By : Peter A. Buhr
12// Last Modified On : Thu Dec  5 16:26:03 2019
13// Update Count     : 44
14//
15
16#include "bits/containers.hfa"
17#include "bits/defs.hfa"
18#include "bits/locks.hfa"
19#include "kernel/fwd.hfa"
20
21#ifdef __cforall
22extern "C" {
23#endif
24
25#if ! defined(__CFA_INVOKE_PRIVATE__)
26#ifndef _INVOKE_H_
27#define _INVOKE_H_
28
29        struct __cfaehm_try_resume_node;
30        struct __cfaehm_base_exception_t;
31        struct exception_context_t {
32                struct __cfaehm_try_resume_node * top_resume;
33                struct __cfaehm_base_exception_t * current_exception;
34        };
35
36        struct __stack_context_t {
37                void * SP;
38                void * FP;
39        };
40
41        // low adresses  :           +----------------------+ <- start of allocation
42        //                           |  optional guard page |
43        //                           +----------------------+ <- __stack_t.limit
44        //                           |                      |
45        //                           |       /\ /\ /\       |
46        //                           |       || || ||       |
47        //                           |                      |
48        //                           |    program  stack    |
49        //                           |                      |
50        // __stack_info_t.storage -> +----------------------+ <- __stack_t.base
51        //                           |      __stack_t       |
52        // high adresses :           +----------------------+ <- end of allocation
53
54        struct __stack_t {
55                // stack grows towards stack limit
56                void * limit;
57
58                // base of stack
59                void * base;
60
61                // Information for exception handling.
62                struct exception_context_t exception_context;
63        };
64
65        struct __stack_info_t {
66                // pointer to stack
67                struct __stack_t * storage;
68        };
69
70        enum __Coroutine_State { Halted, Start, Primed, Blocked, Ready, Active, Cancelled };
71
72        struct $coroutine {
73                // context that is switch during a __cfactx_switch
74                struct __stack_context_t context;
75
76                // stack information of the coroutine
77                struct __stack_info_t stack;
78
79                // textual name for coroutine/task
80                const char * name;
81
82                // current execution status for coroutine
83                enum __Coroutine_State state;
84
85                // first coroutine to resume this one
86                struct $coroutine * starter;
87
88                // last coroutine to resume this one
89                struct $coroutine * last;
90
91                // If non-null stack must be unwound with this exception
92                struct _Unwind_Exception * cancellation;
93
94        };
95        // Wrapper for gdb
96        struct cfathread_coroutine_t { $coroutine debug; };
97
98        static inline struct __stack_t * __get_stack( struct $coroutine * cor ) {
99                return (struct __stack_t*)(((uintptr_t)cor->stack.storage) & ((uintptr_t)-2));
100        }
101
102        // struct which calls the monitor is accepting
103        struct __waitfor_mask_t {
104                // the index of the accepted function, -1 if none
105                short * accepted;
106
107                // list of acceptable functions, null if any
108                __cfa_anonymous_object( __small_array_t(struct __acceptable_t) );
109        };
110
111        struct $monitor {
112                // spinlock to protect internal data
113                struct __spinlock_t lock;
114
115                // current owner of the monitor
116                struct $thread * owner;
117
118                // queue of threads that are blocked waiting for the monitor
119                __queue_t(struct $thread) entry_queue;
120
121                // stack of conditions to run next once we exit the monitor
122                __stack_t(struct __condition_criterion_t) signal_stack;
123
124                // monitor routines can be called recursively, we need to keep track of that
125                unsigned int recursion;
126
127                // mask used to know if some thread is waiting for something while holding the monitor
128                struct __waitfor_mask_t mask;
129
130                // node used to signal the dtor in a waitfor dtor
131                struct __condition_node_t * dtor_node;
132        };
133        // Wrapper for gdb
134        struct cfathread_monitor_t { $monitor debug; };
135
136        struct __monitor_group_t {
137                // currently held monitors
138                __cfa_anonymous_object( __small_array_t($monitor*) );
139
140                // last function that acquired monitors
141                fptr_t func;
142        };
143
144        // Link lists fields
145        // instrusive link field for threads
146        struct __thread_desc_link {
147                struct $thread * next;
148                struct $thread * prev;
149                volatile unsigned long long ts;
150                int preferred;
151        };
152
153        struct $thread {
154                // Core threading fields
155                // context that is switch during a __cfactx_switch
156                struct __stack_context_t context;
157
158                // current execution status for coroutine
159                volatile int ticket;
160                enum __Coroutine_State state:8;
161                enum __Preemption_Reason preempted:8;
162
163                //SKULLDUGGERY errno is not save in the thread data structure because returnToKernel appears to be the only function to require saving and restoring it
164
165                // pointer to the cluster on which the thread is running
166                struct cluster * curr_cluster;
167
168                // Link lists fields
169                // instrusive link field for threads
170                struct __thread_desc_link link;
171
172                // coroutine body used to store context
173                struct $coroutine  self_cor;
174
175                // current active context
176                struct $coroutine * curr_cor;
177
178                // monitor body used for mutual exclusion
179                struct $monitor    self_mon;
180
181                // pointer to monitor with sufficient lifetime for current monitors
182                struct $monitor *  self_mon_p;
183
184                // monitors currently held by this thread
185                struct __monitor_group_t monitors;
186
187                struct {
188                        struct $thread * next;
189                        struct $thread * prev;
190                } node;
191
192                #ifdef __CFA_DEBUG__
193                        // previous function to park/unpark the thread
194                        const char * park_caller;
195                        int park_result;
196                        enum __Coroutine_State park_state;
197                        bool park_stale;
198                        const char * unpark_caller;
199                        int unpark_result;
200                        enum __Coroutine_State unpark_state;
201                        bool unpark_stale;
202                #endif
203        };
204        // Wrapper for gdb
205        struct cfathread_thread_t { $thread debug; };
206
207        #ifdef __CFA_DEBUG__
208                void __cfaabi_dbg_record_thrd($thread & this, bool park, const char prev_name[]);
209        #else
210                #define __cfaabi_dbg_record_thrd(x, y, z)
211        #endif
212
213        #ifdef __cforall
214        extern "Cforall" {
215
216                static inline $thread *& get_next( $thread & this ) __attribute__((const)) {
217                        return this.link.next;
218                }
219
220                static inline [$thread *&, $thread *& ] __get( $thread & this ) __attribute__((const)) {
221                        return this.node.[next, prev];
222                }
223
224                static inline void ?{}(__monitor_group_t & this) {
225                        (this.data){0p};
226                        (this.size){0};
227                        (this.func){NULL};
228                }
229
230                static inline void ?{}(__monitor_group_t & this, struct $monitor ** data, __lock_size_t size, fptr_t func) {
231                        (this.data){data};
232                        (this.size){size};
233                        (this.func){func};
234                }
235
236                static inline bool ?==?( const __monitor_group_t & lhs, const __monitor_group_t & rhs ) __attribute__((const)) {
237                        if( (lhs.data != 0) != (rhs.data != 0) ) return false;
238                        if( lhs.size != rhs.size ) return false;
239                        if( lhs.func != rhs.func ) return false;
240
241                        // Check that all the monitors match
242                        for( int i = 0; i < lhs.size; i++ ) {
243                                // If not a match, check next function
244                                if( lhs[i] != rhs[i] ) return false;
245                        }
246
247                        return true;
248                }
249
250                static inline void ?=?(__monitor_group_t & lhs, const __monitor_group_t & rhs) {
251                        lhs.data = rhs.data;
252                        lhs.size = rhs.size;
253                        lhs.func = rhs.func;
254                }
255        }
256        #endif
257
258#endif //_INVOKE_H_
259#else //! defined(__CFA_INVOKE_PRIVATE__)
260#ifndef _INVOKE_PRIVATE_H_
261#define _INVOKE_PRIVATE_H_
262
263        struct machine_context_t {
264                void *SP;
265                void *FP;
266                void *PC;
267        };
268
269        // assembler routines that performs the context switch
270        extern void __cfactx_invoke_stub( void );
271        extern void __cfactx_switch( struct __stack_context_t * from, struct __stack_context_t * to ) asm ("__cfactx_switch");
272        // void CtxStore ( void * this ) asm ("CtxStore");
273        // void CtxRet   ( void * dst  ) asm ("CtxRet");
274
275#endif //_INVOKE_PRIVATE_H_
276#endif //! defined(__CFA_INVOKE_PRIVATE__)
277#ifdef __cforall
278}
279#endif
280
281// Local Variables: //
282// mode: c //
283// tab-width: 4 //
284// End: //
Note: See TracBrowser for help on using the repository browser.