source: libcfa/src/concurrency/thread.hfa @ ab8c6a6

arm-ehjacob/cs343-translationnew-ast-unique-expr
Last change on this file since ab8c6a6 was ab8c6a6, checked in by Andrew Beach <ajbeach@…>, 12 months ago

Thread Cancellation, a test for it and a required fix to Specialization.

  • Property mode set to 100644
File size: 5.3 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// thread --
8//
9// Author           : Thierry Delisle
10// Created On       : Tue Jan 17 12:27:26 2017
11// Last Modified By : Peter A. Buhr
12// Last Modified On : Wed Dec  4 09:18:14 2019
13// Update Count     : 6
14//
15
16#pragma once
17
18#include <assert.h>
19#include "invoke.h"
20
21#include "coroutine.hfa"
22#include "kernel.hfa"
23#include "monitor.hfa"
24#include "exception.hfa"
25
26//-----------------------------------------------------------------------------
27// thread trait
28trait is_thread(dtype T) {
29        void ^?{}(T& mutex this);
30        void main(T& this);
31        $thread* get_thread(T& this);
32};
33
34FORALL_DATA_EXCEPTION(ThreadCancelled, (dtype thread_t), (thread_t)) (
35        thread_t * the_thread;
36        exception_t * the_exception;
37);
38
39forall(dtype T)
40void copy(ThreadCancelled(T) * dst, ThreadCancelled(T) * src);
41
42forall(dtype T)
43const char * msg(ThreadCancelled(T) *);
44
45// define that satisfies the trait without using the thread keyword
46#define DECL_THREAD(X) $thread* get_thread(X& this) __attribute__((const)) { return &this.__thrd; } void main(X& this)
47
48// Inline getters for threads/coroutines/monitors
49forall( dtype T | is_thread(T) )
50static inline $coroutine* get_coroutine(T & this) __attribute__((const)) { return &get_thread(this)->self_cor; }
51
52forall( dtype T | is_thread(T) )
53static inline $monitor  * get_monitor  (T & this) __attribute__((const)) { return &get_thread(this)->self_mon; }
54
55static inline $coroutine* get_coroutine($thread * this) __attribute__((const)) { return &this->self_cor; }
56static inline $monitor  * get_monitor  ($thread * this) __attribute__((const)) { return &this->self_mon; }
57
58//-----------------------------------------------------------------------------
59// forward declarations needed for threads
60extern struct cluster * mainCluster;
61
62forall( dtype T | is_thread(T) )
63void __thrd_start( T & this, void (*)(T &) );
64
65//-----------------------------------------------------------------------------
66// Ctors and dtors
67void ?{}($thread & this, const char * const name, struct cluster & cl, void * storage, size_t storageSize );
68void ^?{}($thread & this);
69
70static inline void ?{}($thread & this)                                                                  { this{ "Anonymous Thread", *mainCluster, 0p, 65000 }; }
71static inline void ?{}($thread & this, size_t stackSize )                                               { this{ "Anonymous Thread", *mainCluster, 0p, stackSize }; }
72static inline void ?{}($thread & this, void * storage, size_t storageSize )                             { this{ "Anonymous Thread", *mainCluster, storage, storageSize }; }
73static inline void ?{}($thread & this, struct cluster & cl )                                            { this{ "Anonymous Thread", cl, 0p, 65000 }; }
74static inline void ?{}($thread & this, struct cluster & cl, size_t stackSize )                          { this{ "Anonymous Thread", cl, 0p, stackSize }; }
75static inline void ?{}($thread & this, struct cluster & cl, void * storage, size_t storageSize )        { this{ "Anonymous Thread", cl, storage, storageSize }; }
76static inline void ?{}($thread & this, const char * const name)                                         { this{ name, *mainCluster, 0p, 65000 }; }
77static inline void ?{}($thread & this, const char * const name, struct cluster & cl )                   { this{ name, cl, 0p, 65000 }; }
78static inline void ?{}($thread & this, const char * const name, struct cluster & cl, size_t stackSize ) { this{ name, cl, 0p, stackSize }; }
79
80struct thread_dtor_guard_t {
81        monitor_dtor_guard_t mg;
82};
83
84forall( dtype T | is_thread(T) | IS_EXCEPTION(ThreadCancelled, (T)) )
85void ?{}( thread_dtor_guard_t & this, T & thrd, void(*)(ThreadCancelled(T) &) );
86void ^?{}( thread_dtor_guard_t & this );
87
88//-----------------------------------------------------------------------------
89// thread runner
90// Structure that actually start and stop threads
91forall( dtype T | sized(T) | is_thread(T) )
92struct scoped {
93        T handle;
94};
95
96forall( dtype T | sized(T) | is_thread(T) | { void ?{}(T&); } )
97void ?{}( scoped(T)& this );
98
99forall( dtype T, ttype P | sized(T) | is_thread(T) | { void ?{}(T&, P); } )
100void ?{}( scoped(T)& this, P params );
101
102forall( dtype T | sized(T) | is_thread(T) )
103void ^?{}( scoped(T)& this );
104
105//-----------------------------------------------------------------------------
106// Scheduler API
107
108//----------
109// Park thread: block until corresponding call to unpark, won't block if unpark is already called
110void park( void );
111
112//----------
113// Unpark a thread, if the thread is already blocked, schedule it
114//                  if the thread is not yet block, signal that it should rerun immediately
115void unpark( $thread * this );
116
117forall( dtype T | is_thread(T) )
118static inline void unpark( T & this ) { if(!&this) return; unpark( get_thread( this ) );}
119
120//----------
121// Yield: force thread to block and be rescheduled
122bool force_yield( enum __Preemption_Reason );
123
124//----------
125// sleep: force thread to block and be rescheduled after Duration duration
126void sleep( Duration duration );
127
128//----------
129// join
130forall( dtype T | is_thread(T) | IS_RESUMPTION_EXCEPTION(ThreadCancelled, (T)) )
131T & join( T & this );
132
133// Local Variables: //
134// mode: c //
135// tab-width: 4 //
136// End: //
Note: See TracBrowser for help on using the repository browser.