1 /* -----------------------------------------------------------------------------
3 * (c) The GHC Team, 1998-2004
5 * Out-of-line primitive operations
7 * This file contains the implementations of all the primitive
8 * operations ("primops") which are not expanded inline. See
9 * ghc/compiler/prelude/primops.txt.pp for a list of all the primops;
10 * this file contains code for most of those with the attribute
13 * Entry convention: the entry convention for a primop is that all the
14 * args are in Stg registers (R1, R2, etc.). This is to make writing
15 * the primops easier. (see compiler/codeGen/CgCallConv.hs).
17 * Return convention: results from a primop are generally returned
18 * using the ordinary unboxed tuple return convention. The C-- parser
19 * implements the RET_xxxx() macros to perform unboxed-tuple returns
20 * based on the prevailing return convention.
22 * This file is written in a subset of C--, extended with various
23 * features specific to GHC. It is compiled by GHC directly. For the
24 * syntax of .cmm files, see the parser in ghc/compiler/cmm/CmmParse.y.
26 * ---------------------------------------------------------------------------*/
31 #ifndef mingw32_HOST_OS
41 import __gmpz_tdiv_qr;
42 import __gmpz_fdiv_qr;
43 import __gmpz_divexact;
49 import pthread_mutex_lock;
50 import pthread_mutex_unlock;
52 import base_ControlziExceptionziBase_nestedAtomically_closure;
53 import EnterCriticalSection;
54 import LeaveCriticalSection;
55 import ghczmprim_GHCziBool_False_closure;
57 /*-----------------------------------------------------------------------------
60 Basically just new*Array - the others are all inline macros.
62 The size arg is always passed in R1, and the result returned in R1.
64 The slow entry point is for returning from a heap check, the saved
65 size argument must be re-loaded from the stack.
66 -------------------------------------------------------------------------- */
68 /* for objects that are *less* than the size of a word, make sure we
69 * round up to the nearest word for the size of the array.
74 W_ words, payload_words, n, p;
75 MAYBE_GC(NO_PTRS,newByteArrayzh_fast);
77 payload_words = ROUNDUP_BYTES_TO_WDS(n);
78 words = BYTES_TO_WDS(SIZEOF_StgArrWords) + payload_words;
79 ("ptr" p) = foreign "C" allocateLocal(MyCapability() "ptr",words) [];
80 TICK_ALLOC_PRIM(SIZEOF_StgArrWords,WDS(payload_words),0);
81 SET_HDR(p, stg_ARR_WORDS_info, W_[CCCS]);
82 StgArrWords_words(p) = payload_words;
87 #define BA_MASK (BA_ALIGN-1)
89 newPinnedByteArrayzh_fast
91 W_ words, bytes, payload_words, p;
93 MAYBE_GC(NO_PTRS,newPinnedByteArrayzh_fast);
95 /* payload_words is what we will tell the profiler we had to allocate */
96 payload_words = ROUNDUP_BYTES_TO_WDS(bytes);
97 /* When we actually allocate memory, we need to allow space for the
99 bytes = bytes + SIZEOF_StgArrWords;
100 /* And we want to align to BA_ALIGN bytes, so we need to allow space
101 to shift up to BA_ALIGN - 1 bytes: */
102 bytes = bytes + BA_ALIGN - 1;
103 /* Now we convert to a number of words: */
104 words = ROUNDUP_BYTES_TO_WDS(bytes);
106 ("ptr" p) = foreign "C" allocatePinned(words) [];
107 TICK_ALLOC_PRIM(SIZEOF_StgArrWords,WDS(payload_words),0);
109 /* Now we need to move p forward so that the payload is aligned
110 to BA_ALIGN bytes: */
111 p = p + ((-p - SIZEOF_StgArrWords) & BA_MASK);
113 SET_HDR(p, stg_ARR_WORDS_info, W_[CCCS]);
114 StgArrWords_words(p) = payload_words;
118 newAlignedPinnedByteArrayzh_fast
120 W_ words, bytes, payload_words, p, alignment;
122 MAYBE_GC(NO_PTRS,newAlignedPinnedByteArrayzh_fast);
126 /* payload_words is what we will tell the profiler we had to allocate */
127 payload_words = ROUNDUP_BYTES_TO_WDS(bytes);
129 /* When we actually allocate memory, we need to allow space for the
131 bytes = bytes + SIZEOF_StgArrWords;
132 /* And we want to align to <alignment> bytes, so we need to allow space
133 to shift up to <alignment - 1> bytes: */
134 bytes = bytes + alignment - 1;
135 /* Now we convert to a number of words: */
136 words = ROUNDUP_BYTES_TO_WDS(bytes);
138 ("ptr" p) = foreign "C" allocatePinned(words) [];
139 TICK_ALLOC_PRIM(SIZEOF_StgArrWords,WDS(payload_words),0);
141 /* Now we need to move p forward so that the payload is aligned
142 to <alignment> bytes. Note that we are assuming that
143 <alignment> is a power of 2, which is technically not guaranteed */
144 p = p + ((-p - SIZEOF_StgArrWords) & (alignment - 1));
146 SET_HDR(p, stg_ARR_WORDS_info, W_[CCCS]);
147 StgArrWords_words(p) = payload_words;
153 W_ words, n, init, arr, p;
154 /* Args: R1 = words, R2 = initialisation value */
157 MAYBE_GC(R2_PTR,newArrayzh_fast);
159 words = BYTES_TO_WDS(SIZEOF_StgMutArrPtrs) + n;
160 ("ptr" arr) = foreign "C" allocateLocal(MyCapability() "ptr",words) [R2];
161 TICK_ALLOC_PRIM(SIZEOF_StgMutArrPtrs, WDS(n), 0);
163 SET_HDR(arr, stg_MUT_ARR_PTRS_DIRTY_info, W_[CCCS]);
164 StgMutArrPtrs_ptrs(arr) = n;
166 // Initialise all elements of the the array with the value in R2
168 p = arr + SIZEOF_StgMutArrPtrs;
170 if (p < arr + WDS(words)) {
179 unsafeThawArrayzh_fast
181 // SUBTLETY TO DO WITH THE OLD GEN MUTABLE LIST
183 // A MUT_ARR_PTRS lives on the mutable list, but a MUT_ARR_PTRS_FROZEN
184 // normally doesn't. However, when we freeze a MUT_ARR_PTRS, we leave
185 // it on the mutable list for the GC to remove (removing something from
186 // the mutable list is not easy, because the mut_list is only singly-linked).
188 // So that we can tell whether a MUT_ARR_PTRS_FROZEN is on the mutable list,
189 // when we freeze it we set the info ptr to be MUT_ARR_PTRS_FROZEN0
190 // to indicate that it is still on the mutable list.
192 // So, when we thaw a MUT_ARR_PTRS_FROZEN, we must cope with two cases:
193 // either it is on a mut_list, or it isn't. We adopt the convention that
194 // the closure type is MUT_ARR_PTRS_FROZEN0 if it is on the mutable list,
195 // and MUT_ARR_PTRS_FROZEN otherwise. In fact it wouldn't matter if
196 // we put it on the mutable list more than once, but it would get scavenged
197 // multiple times during GC, which would be unnecessarily slow.
199 if (StgHeader_info(R1) != stg_MUT_ARR_PTRS_FROZEN0_info) {
200 SET_INFO(R1,stg_MUT_ARR_PTRS_DIRTY_info);
201 recordMutable(R1, R1);
202 // must be done after SET_INFO, because it ASSERTs closure_MUTABLE()
205 SET_INFO(R1,stg_MUT_ARR_PTRS_DIRTY_info);
210 /* -----------------------------------------------------------------------------
212 -------------------------------------------------------------------------- */
217 /* Args: R1 = initialisation value */
219 ALLOC_PRIM( SIZEOF_StgMutVar, R1_PTR, newMutVarzh_fast);
221 mv = Hp - SIZEOF_StgMutVar + WDS(1);
222 SET_HDR(mv,stg_MUT_VAR_DIRTY_info,W_[CCCS]);
223 StgMutVar_var(mv) = R1;
228 atomicModifyMutVarzh_fast
230 W_ mv, f, z, x, y, r, h;
231 /* Args: R1 :: MutVar#, R2 :: a -> (a,b) */
233 /* If x is the current contents of the MutVar#, then
234 We want to make the new contents point to
238 and the return value is
242 obviously we can share (f x).
244 z = [stg_ap_2 f x] (max (HS + 2) MIN_UPD_SIZE)
245 y = [stg_sel_0 z] (max (HS + 1) MIN_UPD_SIZE)
246 r = [stg_sel_1 z] (max (HS + 1) MIN_UPD_SIZE)
250 #define THUNK_1_SIZE (SIZEOF_StgThunkHeader + WDS(MIN_UPD_SIZE))
251 #define TICK_ALLOC_THUNK_1() TICK_ALLOC_UP_THK(WDS(1),WDS(MIN_UPD_SIZE-1))
253 #define THUNK_1_SIZE (SIZEOF_StgThunkHeader + WDS(1))
254 #define TICK_ALLOC_THUNK_1() TICK_ALLOC_UP_THK(WDS(1),0)
258 #define THUNK_2_SIZE (SIZEOF_StgThunkHeader + WDS(MIN_UPD_SIZE))
259 #define TICK_ALLOC_THUNK_2() TICK_ALLOC_UP_THK(WDS(2),WDS(MIN_UPD_SIZE-2))
261 #define THUNK_2_SIZE (SIZEOF_StgThunkHeader + WDS(2))
262 #define TICK_ALLOC_THUNK_2() TICK_ALLOC_UP_THK(WDS(2),0)
265 #define SIZE (THUNK_2_SIZE + THUNK_1_SIZE + THUNK_1_SIZE)
267 HP_CHK_GEN_TICKY(SIZE, R1_PTR & R2_PTR, atomicModifyMutVarzh_fast);
272 TICK_ALLOC_THUNK_2();
273 CCCS_ALLOC(THUNK_2_SIZE);
274 z = Hp - THUNK_2_SIZE + WDS(1);
275 SET_HDR(z, stg_ap_2_upd_info, W_[CCCS]);
276 LDV_RECORD_CREATE(z);
277 StgThunk_payload(z,0) = f;
279 TICK_ALLOC_THUNK_1();
280 CCCS_ALLOC(THUNK_1_SIZE);
281 y = z - THUNK_1_SIZE;
282 SET_HDR(y, stg_sel_0_upd_info, W_[CCCS]);
283 LDV_RECORD_CREATE(y);
284 StgThunk_payload(y,0) = z;
286 TICK_ALLOC_THUNK_1();
287 CCCS_ALLOC(THUNK_1_SIZE);
288 r = y - THUNK_1_SIZE;
289 SET_HDR(r, stg_sel_1_upd_info, W_[CCCS]);
290 LDV_RECORD_CREATE(r);
291 StgThunk_payload(r,0) = z;
294 x = StgMutVar_var(mv);
295 StgThunk_payload(z,1) = x;
297 (h) = foreign "C" cas(mv + SIZEOF_StgHeader + OFFSET_StgMutVar_var, x, y) [];
298 if (h != x) { goto retry; }
300 StgMutVar_var(mv) = y;
303 if (GET_INFO(mv) == stg_MUT_VAR_CLEAN_info) {
304 foreign "C" dirty_MUT_VAR(BaseReg "ptr", mv "ptr") [];
310 /* -----------------------------------------------------------------------------
311 Weak Pointer Primitives
312 -------------------------------------------------------------------------- */
314 STRING(stg_weak_msg,"New weak pointer at %p\n")
320 R3 = finalizer (or NULL)
325 R3 = stg_NO_FINALIZER_closure;
328 ALLOC_PRIM( SIZEOF_StgWeak, R1_PTR & R2_PTR & R3_PTR, mkWeakzh_fast );
330 w = Hp - SIZEOF_StgWeak + WDS(1);
331 SET_HDR(w, stg_WEAK_info, W_[CCCS]);
333 // We don't care about cfinalizer here.
334 // Should StgWeak_cfinalizer(w) be stg_NO_FINALIZER_closure or
338 StgWeak_value(w) = R2;
339 StgWeak_finalizer(w) = R3;
340 StgWeak_cfinalizer(w) = stg_NO_FINALIZER_closure;
342 StgWeak_link(w) = W_[weak_ptr_list];
343 W_[weak_ptr_list] = w;
345 IF_DEBUG(weak, foreign "C" debugBelch(stg_weak_msg,w) []);
350 mkWeakForeignEnvzh_fast
356 R5 = has environment (0 or 1)
359 W_ w, payload_words, words, p;
361 W_ key, val, fptr, ptr, flag, eptr;
370 ALLOC_PRIM( SIZEOF_StgWeak, R1_PTR & R2_PTR, mkWeakForeignEnvzh_fast );
372 w = Hp - SIZEOF_StgWeak + WDS(1);
373 SET_HDR(w, stg_WEAK_info, W_[CCCS]);
376 words = BYTES_TO_WDS(SIZEOF_StgArrWords) + payload_words;
377 ("ptr" p) = foreign "C" allocateLocal(MyCapability() "ptr", words) [];
379 TICK_ALLOC_PRIM(SIZEOF_StgArrWords,WDS(payload_words),0);
380 SET_HDR(p, stg_ARR_WORDS_info, W_[CCCS]);
382 StgArrWords_words(p) = payload_words;
383 StgArrWords_payload(p,0) = fptr;
384 StgArrWords_payload(p,1) = ptr;
385 StgArrWords_payload(p,2) = eptr;
386 StgArrWords_payload(p,3) = flag;
388 // We don't care about the value here.
389 // Should StgWeak_value(w) be stg_NO_FINALIZER_closure or something else?
391 StgWeak_key(w) = key;
392 StgWeak_value(w) = val;
393 StgWeak_finalizer(w) = stg_NO_FINALIZER_closure;
394 StgWeak_cfinalizer(w) = p;
396 StgWeak_link(w) = W_[weak_ptr_list];
397 W_[weak_ptr_list] = w;
399 IF_DEBUG(weak, foreign "C" debugBelch(stg_weak_msg,w) []);
413 if (GET_INFO(w) == stg_DEAD_WEAK_info) {
414 RET_NP(0,stg_NO_FINALIZER_closure);
420 // A weak pointer is inherently used, so we do not need to call
421 // LDV_recordDead_FILL_SLOP_DYNAMIC():
422 // LDV_recordDead_FILL_SLOP_DYNAMIC((StgClosure *)w);
423 // or, LDV_recordDead():
424 // LDV_recordDead((StgClosure *)w, sizeofW(StgWeak) - sizeofW(StgProfHeader));
425 // Furthermore, when PROFILING is turned on, dead weak pointers are exactly as
426 // large as weak pointers, so there is no need to fill the slop, either.
427 // See stg_DEAD_WEAK_info in StgMiscClosures.hc.
431 // Todo: maybe use SET_HDR() and remove LDV_recordCreate()?
433 SET_INFO(w,stg_DEAD_WEAK_info);
434 LDV_RECORD_CREATE(w);
436 f = StgWeak_finalizer(w);
437 arr = StgWeak_cfinalizer(w);
439 StgDeadWeak_link(w) = StgWeak_link(w);
441 if (arr != stg_NO_FINALIZER_closure) {
442 foreign "C" runCFinalizer(StgArrWords_payload(arr,0),
443 StgArrWords_payload(arr,1),
444 StgArrWords_payload(arr,2),
445 StgArrWords_payload(arr,3)) [];
448 /* return the finalizer */
449 if (f == stg_NO_FINALIZER_closure) {
450 RET_NP(0,stg_NO_FINALIZER_closure);
462 if (GET_INFO(w) == stg_WEAK_info) {
464 val = StgWeak_value(w);
472 /* -----------------------------------------------------------------------------
473 Arbitrary-precision Integer operations.
475 There are some assumptions in this code that mp_limb_t == W_. This is
476 the case for all the platforms that GHC supports, currently.
477 -------------------------------------------------------------------------- */
481 /* arguments: R1 = Int# */
483 W_ val, s, p; /* to avoid aliasing */
486 ALLOC_PRIM( SIZEOF_StgArrWords + WDS(1), NO_PTRS, int2Integerzh_fast );
488 p = Hp - SIZEOF_StgArrWords;
489 SET_HDR(p, stg_ARR_WORDS_info, W_[CCCS]);
490 StgArrWords_words(p) = 1;
492 /* mpz_set_si is inlined here, makes things simpler */
505 /* returns (# size :: Int#,
514 /* arguments: R1 = Word# */
516 W_ val, s, p; /* to avoid aliasing */
520 ALLOC_PRIM( SIZEOF_StgArrWords + WDS(1), NO_PTRS, word2Integerzh_fast);
522 p = Hp - SIZEOF_StgArrWords;
523 SET_HDR(p, stg_ARR_WORDS_info, W_[CCCS]);
524 StgArrWords_words(p) = 1;
533 /* returns (# size :: Int#,
534 data :: ByteArray# #)
541 * 'long long' primops for converting to/from Integers.
544 #ifdef SUPPORT_LONG_LONGS
546 int64ToIntegerzh_fast
548 /* arguments: L1 = Int64# */
551 W_ hi, lo, s, neg, words_needed, p;
556 hi = TO_W_(val >> 32);
559 if ( hi == 0 || (hi == 0xFFFFFFFF && lo != 0) ) {
560 // minimum is one word
566 ALLOC_PRIM( SIZEOF_StgArrWords + WDS(words_needed),
567 NO_PTRS, int64ToIntegerzh_fast );
569 p = Hp - SIZEOF_StgArrWords - WDS(words_needed) + WDS(1);
570 SET_HDR(p, stg_ARR_WORDS_info, W_[CCCS]);
571 StgArrWords_words(p) = words_needed;
583 if ( words_needed == 2 ) {
591 } else /* val==0 */ {
599 /* returns (# size :: Int#,
600 data :: ByteArray# #)
604 word64ToIntegerzh_fast
606 /* arguments: L1 = Word64# */
609 W_ hi, lo, s, words_needed, p;
612 hi = TO_W_(val >> 32);
621 ALLOC_PRIM( SIZEOF_StgArrWords + WDS(words_needed),
622 NO_PTRS, word64ToIntegerzh_fast );
624 p = Hp - SIZEOF_StgArrWords - WDS(words_needed) + WDS(1);
625 SET_HDR(p, stg_ARR_WORDS_info, W_[CCCS]);
626 StgArrWords_words(p) = words_needed;
636 } else /* val==0 */ {
641 /* returns (# size :: Int#,
642 data :: ByteArray# #)
647 #endif /* SUPPORT_LONG_LONGS */
649 #define GMP_TAKE2_RET1(name,mp_fun) \
659 /* call doYouWantToGC() */ \
660 MAYBE_GC(R2_PTR & R4_PTR, name); \
662 STK_CHK_GEN( 4 * SIZEOF_MP_INT, R2_PTR & R4_PTR, name ); \
669 mp_tmp1 = Sp - 1 * SIZEOF_MP_INT; \
670 mp_tmp2 = Sp - 2 * SIZEOF_MP_INT; \
671 mp_result1 = Sp - 3 * SIZEOF_MP_INT; \
672 mp_result2 = Sp - 4 * SIZEOF_MP_INT; \
673 MP_INT__mp_alloc(mp_tmp1) = W_TO_INT(StgArrWords_words(d1)); \
674 MP_INT__mp_size(mp_tmp1) = (s1); \
675 MP_INT__mp_d(mp_tmp1) = BYTE_ARR_CTS(d1); \
676 MP_INT__mp_alloc(mp_tmp2) = W_TO_INT(StgArrWords_words(d2)); \
677 MP_INT__mp_size(mp_tmp2) = (s2); \
678 MP_INT__mp_d(mp_tmp2) = BYTE_ARR_CTS(d2); \
680 foreign "C" __gmpz_init(mp_result1 "ptr") []; \
682 /* Perform the operation */ \
683 foreign "C" mp_fun(mp_result1 "ptr",mp_tmp1 "ptr",mp_tmp2 "ptr") []; \
685 RET_NP(TO_W_(MP_INT__mp_size(mp_result1)), \
686 MP_INT__mp_d(mp_result1) - SIZEOF_StgArrWords); \
689 #define GMP_TAKE1_RET1(name,mp_fun) \
697 /* call doYouWantToGC() */ \
698 MAYBE_GC(R2_PTR, name); \
700 STK_CHK_GEN( 2 * SIZEOF_MP_INT, R2_PTR, name ); \
705 mp_tmp1 = Sp - 1 * SIZEOF_MP_INT; \
706 mp_result1 = Sp - 2 * SIZEOF_MP_INT; \
707 MP_INT__mp_alloc(mp_tmp1) = W_TO_INT(StgArrWords_words(d1)); \
708 MP_INT__mp_size(mp_tmp1) = (s1); \
709 MP_INT__mp_d(mp_tmp1) = BYTE_ARR_CTS(d1); \
711 foreign "C" __gmpz_init(mp_result1 "ptr") []; \
713 /* Perform the operation */ \
714 foreign "C" mp_fun(mp_result1 "ptr",mp_tmp1 "ptr") []; \
716 RET_NP(TO_W_(MP_INT__mp_size(mp_result1)), \
717 MP_INT__mp_d(mp_result1) - SIZEOF_StgArrWords); \
720 #define GMP_TAKE2_RET2(name,mp_fun) \
730 /* call doYouWantToGC() */ \
731 MAYBE_GC(R2_PTR & R4_PTR, name); \
733 STK_CHK_GEN( 4 * SIZEOF_MP_INT, R2_PTR & R4_PTR, name ); \
740 mp_tmp1 = Sp - 1 * SIZEOF_MP_INT; \
741 mp_tmp2 = Sp - 2 * SIZEOF_MP_INT; \
742 mp_result1 = Sp - 3 * SIZEOF_MP_INT; \
743 mp_result2 = Sp - 4 * SIZEOF_MP_INT; \
744 MP_INT__mp_alloc(mp_tmp1) = W_TO_INT(StgArrWords_words(d1)); \
745 MP_INT__mp_size(mp_tmp1) = (s1); \
746 MP_INT__mp_d(mp_tmp1) = BYTE_ARR_CTS(d1); \
747 MP_INT__mp_alloc(mp_tmp2) = W_TO_INT(StgArrWords_words(d2)); \
748 MP_INT__mp_size(mp_tmp2) = (s2); \
749 MP_INT__mp_d(mp_tmp2) = BYTE_ARR_CTS(d2); \
751 foreign "C" __gmpz_init(mp_result1 "ptr") []; \
752 foreign "C" __gmpz_init(mp_result2 "ptr") []; \
754 /* Perform the operation */ \
755 foreign "C" mp_fun(mp_result1 "ptr",mp_result2 "ptr",mp_tmp1 "ptr",mp_tmp2 "ptr") []; \
757 RET_NPNP(TO_W_(MP_INT__mp_size(mp_result1)), \
758 MP_INT__mp_d(mp_result1) - SIZEOF_StgArrWords, \
759 TO_W_(MP_INT__mp_size(mp_result2)), \
760 MP_INT__mp_d(mp_result2) - SIZEOF_StgArrWords); \
763 GMP_TAKE2_RET1(plusIntegerzh_fast, __gmpz_add)
764 GMP_TAKE2_RET1(minusIntegerzh_fast, __gmpz_sub)
765 GMP_TAKE2_RET1(timesIntegerzh_fast, __gmpz_mul)
766 GMP_TAKE2_RET1(gcdIntegerzh_fast, __gmpz_gcd)
767 GMP_TAKE2_RET1(quotIntegerzh_fast, __gmpz_tdiv_q)
768 GMP_TAKE2_RET1(remIntegerzh_fast, __gmpz_tdiv_r)
769 GMP_TAKE2_RET1(divExactIntegerzh_fast, __gmpz_divexact)
770 GMP_TAKE2_RET1(andIntegerzh_fast, __gmpz_and)
771 GMP_TAKE2_RET1(orIntegerzh_fast, __gmpz_ior)
772 GMP_TAKE2_RET1(xorIntegerzh_fast, __gmpz_xor)
773 GMP_TAKE1_RET1(complementIntegerzh_fast, __gmpz_com)
775 GMP_TAKE2_RET2(quotRemIntegerzh_fast, __gmpz_tdiv_qr)
776 GMP_TAKE2_RET2(divModIntegerzh_fast, __gmpz_fdiv_qr)
780 /* R1 = the first Int#; R2 = the second Int# */
784 STK_CHK_GEN( 1 * SIZEOF_MP_INT, NO_PTRS, gcdIntzh_fast );
786 mp_tmp_w = Sp - 1 * SIZEOF_MP_INT;
789 (r) = foreign "C" __gmpn_gcd_1(mp_tmp_w "ptr", 1, R2) [];
792 /* Result parked in R1, return via info-pointer at TOS */
793 jump %ENTRY_CODE(Sp(0));
799 /* R1 = s1; R2 = d1; R3 = the int */
801 (s1) = foreign "C" __gmpn_gcd_1( BYTE_ARR_CTS(R2) "ptr", R1, R3) [];
804 /* Result parked in R1, return via info-pointer at TOS */
805 jump %ENTRY_CODE(Sp(0));
811 /* R1 = s1; R2 = d1; R3 = the int */
812 W_ usize, vsize, v_digit, u_digit;
818 // paraphrased from __gmpz_cmp_si() in the GMP sources
819 if (%gt(v_digit,0)) {
822 if (%lt(v_digit,0)) {
828 if (usize != vsize) {
830 jump %ENTRY_CODE(Sp(0));
835 jump %ENTRY_CODE(Sp(0));
838 u_digit = W_[BYTE_ARR_CTS(R2)];
840 if (u_digit == v_digit) {
842 jump %ENTRY_CODE(Sp(0));
845 if (%gtu(u_digit,v_digit)) { // NB. unsigned: these are mp_limb_t's
851 jump %ENTRY_CODE(Sp(0));
856 /* R1 = s1; R2 = d1; R3 = s2; R4 = d2 */
857 W_ usize, vsize, size, up, vp;
860 // paraphrased from __gmpz_cmp() in the GMP sources
864 if (usize != vsize) {
866 jump %ENTRY_CODE(Sp(0));
871 jump %ENTRY_CODE(Sp(0));
874 if (%lt(usize,0)) { // NB. not <, which is unsigned
880 up = BYTE_ARR_CTS(R2);
881 vp = BYTE_ARR_CTS(R4);
883 (cmp) = foreign "C" __gmpn_cmp(up "ptr", vp "ptr", size) [];
885 if (cmp == 0 :: CInt) {
887 jump %ENTRY_CODE(Sp(0));
890 if (%lt(cmp,0 :: CInt) == %lt(usize,0)) {
895 /* Result parked in R1, return via info-pointer at TOS */
896 jump %ENTRY_CODE(Sp(0));
908 r = W_[R2 + SIZEOF_StgArrWords];
913 /* Result parked in R1, return via info-pointer at TOS */
915 jump %ENTRY_CODE(Sp(0));
927 r = W_[R2 + SIZEOF_StgArrWords];
932 /* Result parked in R1, return via info-pointer at TOS */
934 jump %ENTRY_CODE(Sp(0));
937 decodeFloatzuIntzh_fast
944 STK_CHK_GEN( WDS(2), NO_PTRS, decodeFloatzuIntzh_fast );
946 mp_tmp1 = Sp - WDS(1);
947 mp_tmp_w = Sp - WDS(2);
949 /* arguments: F1 = Float# */
952 /* Perform the operation */
953 foreign "C" __decodeFloat_Int(mp_tmp1 "ptr", mp_tmp_w "ptr", arg) [];
955 /* returns: (Int# (mantissa), Int# (exponent)) */
956 RET_NN(W_[mp_tmp1], W_[mp_tmp_w]);
959 #define DOUBLE_MANTISSA_SIZE SIZEOF_DOUBLE
960 #define ARR_SIZE (SIZEOF_StgArrWords + DOUBLE_MANTISSA_SIZE)
969 STK_CHK_GEN( 2 * SIZEOF_MP_INT, NO_PTRS, decodeDoublezh_fast );
971 mp_tmp1 = Sp - 1 * SIZEOF_MP_INT;
972 mp_tmp_w = Sp - 2 * SIZEOF_MP_INT;
974 /* arguments: D1 = Double# */
977 ALLOC_PRIM( ARR_SIZE, NO_PTRS, decodeDoublezh_fast );
979 /* Be prepared to tell Lennart-coded __decodeDouble
980 where mantissa.d can be put (it does not care about the rest) */
981 p = Hp - ARR_SIZE + WDS(1);
982 SET_HDR(p, stg_ARR_WORDS_info, W_[CCCS]);
983 StgArrWords_words(p) = BYTES_TO_WDS(DOUBLE_MANTISSA_SIZE);
984 MP_INT__mp_d(mp_tmp1) = BYTE_ARR_CTS(p);
986 /* Perform the operation */
987 foreign "C" __decodeDouble(mp_tmp1 "ptr", mp_tmp_w "ptr",arg) [];
989 /* returns: (Int# (expn), Int#, ByteArray#) */
990 RET_NNP(W_[mp_tmp_w], TO_W_(MP_INT__mp_size(mp_tmp1)), p);
993 decodeDoublezu2Intzh_fast
1002 STK_CHK_GEN( WDS(4), NO_PTRS, decodeDoublezu2Intzh_fast );
1004 mp_tmp1 = Sp - WDS(1);
1005 mp_tmp2 = Sp - WDS(2);
1006 mp_result1 = Sp - WDS(3);
1007 mp_result2 = Sp - WDS(4);
1009 /* arguments: D1 = Double# */
1012 /* Perform the operation */
1013 foreign "C" __decodeDouble_2Int(mp_tmp1 "ptr", mp_tmp2 "ptr",
1014 mp_result1 "ptr", mp_result2 "ptr",
1018 (Int# (mant sign), Word# (mant high), Word# (mant low), Int# (expn)) */
1019 RET_NNNN(W_[mp_tmp1], W_[mp_tmp2], W_[mp_result1], W_[mp_result2]);
1022 /* -----------------------------------------------------------------------------
1023 * Concurrency primitives
1024 * -------------------------------------------------------------------------- */
1028 /* args: R1 = closure to spark */
1030 MAYBE_GC(R1_PTR, forkzh_fast);
1036 ("ptr" threadid) = foreign "C" createIOThread( MyCapability() "ptr",
1037 RtsFlags_GcFlags_initialStkSize(RtsFlags),
1040 /* start blocked if the current thread is blocked */
1041 StgTSO_flags(threadid) =
1042 StgTSO_flags(threadid) | (StgTSO_flags(CurrentTSO) &
1043 (TSO_BLOCKEX::I32 | TSO_INTERRUPTIBLE::I32));
1045 foreign "C" scheduleThread(MyCapability() "ptr", threadid "ptr") [];
1047 // context switch soon, but not immediately: we don't want every
1048 // forkIO to force a context-switch.
1049 Capability_context_switch(MyCapability()) = 1 :: CInt;
1056 /* args: R1 = cpu, R2 = closure to spark */
1058 MAYBE_GC(R2_PTR, forkOnzh_fast);
1066 ("ptr" threadid) = foreign "C" createIOThread( MyCapability() "ptr",
1067 RtsFlags_GcFlags_initialStkSize(RtsFlags),
1070 /* start blocked if the current thread is blocked */
1071 StgTSO_flags(threadid) =
1072 StgTSO_flags(threadid) | (StgTSO_flags(CurrentTSO) &
1073 (TSO_BLOCKEX::I32 | TSO_INTERRUPTIBLE::I32));
1075 foreign "C" scheduleThreadOn(MyCapability() "ptr", cpu, threadid "ptr") [];
1077 // context switch soon, but not immediately: we don't want every
1078 // forkIO to force a context-switch.
1079 Capability_context_switch(MyCapability()) = 1 :: CInt;
1086 jump stg_yield_noregs;
1101 foreign "C" labelThread(R1 "ptr", R2 "ptr") [];
1103 jump %ENTRY_CODE(Sp(0));
1106 isCurrentThreadBoundzh_fast
1110 (r) = foreign "C" isThreadBound(CurrentTSO) [];
1116 /* args: R1 :: ThreadId# */
1124 if (TO_W_(StgTSO_what_next(tso)) == ThreadRelocated) {
1125 tso = StgTSO__link(tso);
1129 what_next = TO_W_(StgTSO_what_next(tso));
1130 why_blocked = TO_W_(StgTSO_why_blocked(tso));
1131 // Note: these two reads are not atomic, so they might end up
1132 // being inconsistent. It doesn't matter, since we
1133 // only return one or the other. If we wanted to return the
1134 // contents of block_info too, then we'd have to do some synchronisation.
1136 if (what_next == ThreadComplete) {
1137 ret = 16; // NB. magic, matches up with GHC.Conc.threadStatus
1139 if (what_next == ThreadKilled) {
1148 /* -----------------------------------------------------------------------------
1150 * -------------------------------------------------------------------------- */
1154 // Catch retry frame ------------------------------------------------------------
1156 INFO_TABLE_RET(stg_catch_retry_frame, CATCH_RETRY_FRAME,
1157 #if defined(PROFILING)
1158 W_ unused1, W_ unused2,
1160 W_ unused3, P_ unused4, P_ unused5)
1162 W_ r, frame, trec, outer;
1165 trec = StgTSO_trec(CurrentTSO);
1166 ("ptr" outer) = foreign "C" stmGetEnclosingTRec(trec "ptr") [];
1167 (r) = foreign "C" stmCommitNestedTransaction(MyCapability() "ptr", trec "ptr") [];
1169 /* Succeeded (either first branch or second branch) */
1170 StgTSO_trec(CurrentTSO) = outer;
1171 Sp = Sp + SIZEOF_StgCatchRetryFrame;
1172 jump %ENTRY_CODE(Sp(SP_OFF));
1174 /* Did not commit: re-execute */
1176 ("ptr" new_trec) = foreign "C" stmStartTransaction(MyCapability() "ptr", outer "ptr") [];
1177 StgTSO_trec(CurrentTSO) = new_trec;
1178 if (StgCatchRetryFrame_running_alt_code(frame) != 0::I32) {
1179 R1 = StgCatchRetryFrame_alt_code(frame);
1181 R1 = StgCatchRetryFrame_first_code(frame);
1188 // Atomically frame ------------------------------------------------------------
1190 INFO_TABLE_RET(stg_atomically_frame, ATOMICALLY_FRAME,
1191 #if defined(PROFILING)
1192 W_ unused1, W_ unused2,
1194 P_ unused3, P_ unused4)
1196 W_ frame, trec, valid, next_invariant, q, outer;
1199 trec = StgTSO_trec(CurrentTSO);
1200 ("ptr" outer) = foreign "C" stmGetEnclosingTRec(trec "ptr") [];
1202 if (outer == NO_TREC) {
1203 /* First time back at the atomically frame -- pick up invariants */
1204 ("ptr" q) = foreign "C" stmGetInvariantsToCheck(MyCapability() "ptr", trec "ptr") [];
1205 StgAtomicallyFrame_next_invariant_to_check(frame) = q;
1208 /* Second/subsequent time back at the atomically frame -- abort the
1209 * tx that's checking the invariant and move on to the next one */
1210 StgTSO_trec(CurrentTSO) = outer;
1211 q = StgAtomicallyFrame_next_invariant_to_check(frame);
1212 StgInvariantCheckQueue_my_execution(q) = trec;
1213 foreign "C" stmAbortTransaction(MyCapability() "ptr", trec "ptr") [];
1214 /* Don't free trec -- it's linked from q and will be stashed in the
1215 * invariant if we eventually commit. */
1216 q = StgInvariantCheckQueue_next_queue_entry(q);
1217 StgAtomicallyFrame_next_invariant_to_check(frame) = q;
1221 q = StgAtomicallyFrame_next_invariant_to_check(frame);
1223 if (q != END_INVARIANT_CHECK_QUEUE) {
1224 /* We can't commit yet: another invariant to check */
1225 ("ptr" trec) = foreign "C" stmStartTransaction(MyCapability() "ptr", trec "ptr") [];
1226 StgTSO_trec(CurrentTSO) = trec;
1228 next_invariant = StgInvariantCheckQueue_invariant(q);
1229 R1 = StgAtomicInvariant_code(next_invariant);
1234 /* We've got no more invariants to check, try to commit */
1235 (valid) = foreign "C" stmCommitTransaction(MyCapability() "ptr", trec "ptr") [];
1237 /* Transaction was valid: commit succeeded */
1238 StgTSO_trec(CurrentTSO) = NO_TREC;
1239 Sp = Sp + SIZEOF_StgAtomicallyFrame;
1240 jump %ENTRY_CODE(Sp(SP_OFF));
1242 /* Transaction was not valid: try again */
1243 ("ptr" trec) = foreign "C" stmStartTransaction(MyCapability() "ptr", NO_TREC "ptr") [];
1244 StgTSO_trec(CurrentTSO) = trec;
1245 StgAtomicallyFrame_next_invariant_to_check(frame) = END_INVARIANT_CHECK_QUEUE;
1246 R1 = StgAtomicallyFrame_code(frame);
1252 INFO_TABLE_RET(stg_atomically_waiting_frame, ATOMICALLY_FRAME,
1253 #if defined(PROFILING)
1254 W_ unused1, W_ unused2,
1256 P_ unused3, P_ unused4)
1258 W_ frame, trec, valid;
1262 /* The TSO is currently waiting: should we stop waiting? */
1263 (valid) = foreign "C" stmReWait(MyCapability() "ptr", CurrentTSO "ptr") [];
1265 /* Previous attempt is still valid: no point trying again yet */
1266 jump stg_block_noregs;
1268 /* Previous attempt is no longer valid: try again */
1269 ("ptr" trec) = foreign "C" stmStartTransaction(MyCapability() "ptr", NO_TREC "ptr") [];
1270 StgTSO_trec(CurrentTSO) = trec;
1271 StgHeader_info(frame) = stg_atomically_frame_info;
1272 R1 = StgAtomicallyFrame_code(frame);
1277 // STM catch frame --------------------------------------------------------------
1281 /* Catch frames are very similar to update frames, but when entering
1282 * one we just pop the frame off the stack and perform the correct
1283 * kind of return to the activation record underneath us on the stack.
1286 INFO_TABLE_RET(stg_catch_stm_frame, CATCH_STM_FRAME,
1287 #if defined(PROFILING)
1288 W_ unused1, W_ unused2,
1290 P_ unused3, P_ unused4)
1292 W_ r, frame, trec, outer;
1294 trec = StgTSO_trec(CurrentTSO);
1295 ("ptr" outer) = foreign "C" stmGetEnclosingTRec(trec "ptr") [];
1296 (r) = foreign "C" stmCommitNestedTransaction(MyCapability() "ptr", trec "ptr") [];
1298 /* Commit succeeded */
1299 StgTSO_trec(CurrentTSO) = outer;
1300 Sp = Sp + SIZEOF_StgCatchSTMFrame;
1305 ("ptr" new_trec) = foreign "C" stmStartTransaction(MyCapability() "ptr", outer "ptr") [];
1306 StgTSO_trec(CurrentTSO) = new_trec;
1307 R1 = StgCatchSTMFrame_code(frame);
1313 // Primop definition ------------------------------------------------------------
1321 // stmStartTransaction may allocate
1322 MAYBE_GC (R1_PTR, atomicallyzh_fast);
1324 /* Args: R1 = m :: STM a */
1325 STK_CHK_GEN(SIZEOF_StgAtomicallyFrame + WDS(1), R1_PTR, atomicallyzh_fast);
1327 old_trec = StgTSO_trec(CurrentTSO);
1329 /* Nested transactions are not allowed; raise an exception */
1330 if (old_trec != NO_TREC) {
1331 R1 = base_ControlziExceptionziBase_nestedAtomically_closure;
1335 /* Set up the atomically frame */
1336 Sp = Sp - SIZEOF_StgAtomicallyFrame;
1339 SET_HDR(frame,stg_atomically_frame_info, W_[CCCS]);
1340 StgAtomicallyFrame_code(frame) = R1;
1341 StgAtomicallyFrame_next_invariant_to_check(frame) = END_INVARIANT_CHECK_QUEUE;
1343 /* Start the memory transcation */
1344 ("ptr" new_trec) = foreign "C" stmStartTransaction(MyCapability() "ptr", old_trec "ptr") [R1];
1345 StgTSO_trec(CurrentTSO) = new_trec;
1347 /* Apply R1 to the realworld token */
1356 /* Args: R1 :: STM a */
1357 /* Args: R2 :: Exception -> STM a */
1358 STK_CHK_GEN(SIZEOF_StgCatchSTMFrame + WDS(1), R1_PTR & R2_PTR, catchSTMzh_fast);
1360 /* Set up the catch frame */
1361 Sp = Sp - SIZEOF_StgCatchSTMFrame;
1364 SET_HDR(frame, stg_catch_stm_frame_info, W_[CCCS]);
1365 StgCatchSTMFrame_handler(frame) = R2;
1366 StgCatchSTMFrame_code(frame) = R1;
1368 /* Start a nested transaction to run the body of the try block in */
1371 cur_trec = StgTSO_trec(CurrentTSO);
1372 ("ptr" new_trec) = foreign "C" stmStartTransaction(MyCapability() "ptr", cur_trec "ptr");
1373 StgTSO_trec(CurrentTSO) = new_trec;
1375 /* Apply R1 to the realworld token */
1386 // stmStartTransaction may allocate
1387 MAYBE_GC (R1_PTR & R2_PTR, catchRetryzh_fast);
1389 /* Args: R1 :: STM a */
1390 /* Args: R2 :: STM a */
1391 STK_CHK_GEN(SIZEOF_StgCatchRetryFrame + WDS(1), R1_PTR & R2_PTR, catchRetryzh_fast);
1393 /* Start a nested transaction within which to run the first code */
1394 trec = StgTSO_trec(CurrentTSO);
1395 ("ptr" new_trec) = foreign "C" stmStartTransaction(MyCapability() "ptr", trec "ptr") [R1,R2];
1396 StgTSO_trec(CurrentTSO) = new_trec;
1398 /* Set up the catch-retry frame */
1399 Sp = Sp - SIZEOF_StgCatchRetryFrame;
1402 SET_HDR(frame, stg_catch_retry_frame_info, W_[CCCS]);
1403 StgCatchRetryFrame_running_alt_code(frame) = 0 :: CInt; // false;
1404 StgCatchRetryFrame_first_code(frame) = R1;
1405 StgCatchRetryFrame_alt_code(frame) = R2;
1407 /* Apply R1 to the realworld token */
1420 MAYBE_GC (NO_PTRS, retryzh_fast); // STM operations may allocate
1422 // Find the enclosing ATOMICALLY_FRAME or CATCH_RETRY_FRAME
1424 StgTSO_sp(CurrentTSO) = Sp;
1425 (frame_type) = foreign "C" findRetryFrameHelper(CurrentTSO "ptr") [];
1426 Sp = StgTSO_sp(CurrentTSO);
1428 trec = StgTSO_trec(CurrentTSO);
1429 ("ptr" outer) = foreign "C" stmGetEnclosingTRec(trec "ptr") [];
1431 if (frame_type == CATCH_RETRY_FRAME) {
1432 // The retry reaches a CATCH_RETRY_FRAME before the atomic frame
1433 ASSERT(outer != NO_TREC);
1434 // Abort the transaction attempting the current branch
1435 foreign "C" stmAbortTransaction(MyCapability() "ptr", trec "ptr") [];
1436 foreign "C" stmFreeAbortedTRec(MyCapability() "ptr", trec "ptr") [];
1437 if (!StgCatchRetryFrame_running_alt_code(frame) != 0::I32) {
1438 // Retry in the first branch: try the alternative
1439 ("ptr" trec) = foreign "C" stmStartTransaction(MyCapability() "ptr", outer "ptr") [];
1440 StgTSO_trec(CurrentTSO) = trec;
1441 StgCatchRetryFrame_running_alt_code(frame) = 1 :: CInt; // true;
1442 R1 = StgCatchRetryFrame_alt_code(frame);
1445 // Retry in the alternative code: propagate the retry
1446 StgTSO_trec(CurrentTSO) = outer;
1447 Sp = Sp + SIZEOF_StgCatchRetryFrame;
1448 goto retry_pop_stack;
1452 // We've reached the ATOMICALLY_FRAME: attempt to wait
1453 ASSERT(frame_type == ATOMICALLY_FRAME);
1454 if (outer != NO_TREC) {
1455 // We called retry while checking invariants, so abort the current
1456 // invariant check (merging its TVar accesses into the parents read
1457 // set so we'll wait on them)
1458 foreign "C" stmAbortTransaction(MyCapability() "ptr", trec "ptr") [];
1459 foreign "C" stmFreeAbortedTRec(MyCapability() "ptr", trec "ptr") [];
1461 StgTSO_trec(CurrentTSO) = trec;
1462 ("ptr" outer) = foreign "C" stmGetEnclosingTRec(trec "ptr") [];
1464 ASSERT(outer == NO_TREC);
1466 (r) = foreign "C" stmWait(MyCapability() "ptr", CurrentTSO "ptr", trec "ptr") [];
1468 // Transaction was valid: stmWait put us on the TVars' queues, we now block
1469 StgHeader_info(frame) = stg_atomically_waiting_frame_info;
1471 // Fix up the stack in the unregisterised case: the return convention is different.
1472 R3 = trec; // passing to stmWaitUnblock()
1473 jump stg_block_stmwait;
1475 // Transaction was not valid: retry immediately
1476 ("ptr" trec) = foreign "C" stmStartTransaction(MyCapability() "ptr", outer "ptr") [];
1477 StgTSO_trec(CurrentTSO) = trec;
1478 R1 = StgAtomicallyFrame_code(frame);
1489 /* Args: R1 = invariant closure */
1490 MAYBE_GC (R1_PTR, checkzh_fast);
1492 trec = StgTSO_trec(CurrentTSO);
1494 foreign "C" stmAddInvariantToCheck(MyCapability() "ptr",
1498 jump %ENTRY_CODE(Sp(0));
1507 /* Args: R1 = initialisation value */
1509 MAYBE_GC (R1_PTR, newTVarzh_fast);
1511 ("ptr" tv) = foreign "C" stmNewTVar(MyCapability() "ptr", new_value "ptr") [];
1522 /* Args: R1 = TVar closure */
1524 MAYBE_GC (R1_PTR, readTVarzh_fast); // Call to stmReadTVar may allocate
1525 trec = StgTSO_trec(CurrentTSO);
1527 ("ptr" result) = foreign "C" stmReadTVar(MyCapability() "ptr", trec "ptr", tvar "ptr") [];
1537 result = StgTVar_current_value(R1);
1538 if (%INFO_PTR(result) == stg_TREC_HEADER_info) {
1550 /* Args: R1 = TVar closure */
1551 /* R2 = New value */
1553 MAYBE_GC (R1_PTR & R2_PTR, writeTVarzh_fast); // Call to stmWriteTVar may allocate
1554 trec = StgTSO_trec(CurrentTSO);
1557 foreign "C" stmWriteTVar(MyCapability() "ptr", trec "ptr", tvar "ptr", new_value "ptr") [];
1559 jump %ENTRY_CODE(Sp(0));
1563 /* -----------------------------------------------------------------------------
1566 * take & putMVar work as follows. Firstly, an important invariant:
1568 * If the MVar is full, then the blocking queue contains only
1569 * threads blocked on putMVar, and if the MVar is empty then the
1570 * blocking queue contains only threads blocked on takeMVar.
1573 * MVar empty : then add ourselves to the blocking queue
1574 * MVar full : remove the value from the MVar, and
1575 * blocking queue empty : return
1576 * blocking queue non-empty : perform the first blocked putMVar
1577 * from the queue, and wake up the
1578 * thread (MVar is now full again)
1580 * putMVar is just the dual of the above algorithm.
1582 * How do we "perform a putMVar"? Well, we have to fiddle around with
1583 * the stack of the thread waiting to do the putMVar. See
1584 * stg_block_putmvar and stg_block_takemvar in HeapStackCheck.c for
1585 * the stack layout, and the PerformPut and PerformTake macros below.
1587 * It is important that a blocked take or put is woken up with the
1588 * take/put already performed, because otherwise there would be a
1589 * small window of vulnerability where the thread could receive an
1590 * exception and never perform its take or put, and we'd end up with a
1593 * -------------------------------------------------------------------------- */
1597 /* args: R1 = MVar closure */
1599 if (StgMVar_value(R1) == stg_END_TSO_QUEUE_closure) {
1611 ALLOC_PRIM ( SIZEOF_StgMVar, NO_PTRS, newMVarzh_fast );
1613 mvar = Hp - SIZEOF_StgMVar + WDS(1);
1614 SET_HDR(mvar,stg_MVAR_DIRTY_info,W_[CCCS]);
1615 // MVARs start dirty: generation 0 has no mutable list
1616 StgMVar_head(mvar) = stg_END_TSO_QUEUE_closure;
1617 StgMVar_tail(mvar) = stg_END_TSO_QUEUE_closure;
1618 StgMVar_value(mvar) = stg_END_TSO_QUEUE_closure;
1623 #define PerformTake(tso, value) \
1624 W_[StgTSO_sp(tso) + WDS(1)] = value; \
1625 W_[StgTSO_sp(tso) + WDS(0)] = stg_gc_unpt_r1_info;
1627 #define PerformPut(tso,lval) \
1628 StgTSO_sp(tso) = StgTSO_sp(tso) + WDS(3); \
1629 lval = W_[StgTSO_sp(tso) - WDS(1)];
1633 W_ mvar, val, info, tso;
1635 /* args: R1 = MVar closure */
1638 #if defined(THREADED_RTS)
1639 ("ptr" info) = foreign "C" lockClosure(mvar "ptr") [];
1641 info = GET_INFO(mvar);
1644 if (info == stg_MVAR_CLEAN_info) {
1645 foreign "C" dirty_MVAR(BaseReg "ptr", mvar "ptr") [];
1648 /* If the MVar is empty, put ourselves on its blocking queue,
1649 * and wait until we're woken up.
1651 if (StgMVar_value(mvar) == stg_END_TSO_QUEUE_closure) {
1652 if (StgMVar_head(mvar) == stg_END_TSO_QUEUE_closure) {
1653 StgMVar_head(mvar) = CurrentTSO;
1655 foreign "C" setTSOLink(MyCapability() "ptr",
1656 StgMVar_tail(mvar) "ptr",
1659 StgTSO__link(CurrentTSO) = stg_END_TSO_QUEUE_closure;
1660 StgTSO_block_info(CurrentTSO) = mvar;
1661 // write barrier for throwTo(), which looks at block_info
1662 // if why_blocked==BlockedOnMVar.
1663 prim %write_barrier() [];
1664 StgTSO_why_blocked(CurrentTSO) = BlockedOnMVar::I16;
1665 StgMVar_tail(mvar) = CurrentTSO;
1668 jump stg_block_takemvar;
1671 /* we got the value... */
1672 val = StgMVar_value(mvar);
1674 if (StgMVar_head(mvar) != stg_END_TSO_QUEUE_closure)
1676 /* There are putMVar(s) waiting...
1677 * wake up the first thread on the queue
1679 ASSERT(StgTSO_why_blocked(StgMVar_head(mvar)) == BlockedOnMVar::I16);
1681 /* actually perform the putMVar for the thread that we just woke up */
1682 tso = StgMVar_head(mvar);
1683 PerformPut(tso,StgMVar_value(mvar));
1685 if (TO_W_(StgTSO_flags(tso)) & TSO_DIRTY == 0) {
1686 foreign "C" dirty_TSO(MyCapability() "ptr", tso "ptr") [];
1689 ("ptr" tso) = foreign "C" unblockOne_(MyCapability() "ptr",
1690 StgMVar_head(mvar) "ptr", 1) [];
1691 StgMVar_head(mvar) = tso;
1693 if (StgMVar_head(mvar) == stg_END_TSO_QUEUE_closure) {
1694 StgMVar_tail(mvar) = stg_END_TSO_QUEUE_closure;
1697 #if defined(THREADED_RTS)
1698 unlockClosure(mvar, stg_MVAR_DIRTY_info);
1700 SET_INFO(mvar,stg_MVAR_DIRTY_info);
1706 /* No further putMVars, MVar is now empty */
1707 StgMVar_value(mvar) = stg_END_TSO_QUEUE_closure;
1709 #if defined(THREADED_RTS)
1710 unlockClosure(mvar, stg_MVAR_DIRTY_info);
1712 SET_INFO(mvar,stg_MVAR_DIRTY_info);
1722 W_ mvar, val, info, tso;
1724 /* args: R1 = MVar closure */
1728 #if defined(THREADED_RTS)
1729 ("ptr" info) = foreign "C" lockClosure(mvar "ptr") [];
1731 info = GET_INFO(mvar);
1734 if (StgMVar_value(mvar) == stg_END_TSO_QUEUE_closure) {
1735 #if defined(THREADED_RTS)
1736 unlockClosure(mvar, info);
1738 /* HACK: we need a pointer to pass back,
1739 * so we abuse NO_FINALIZER_closure
1741 RET_NP(0, stg_NO_FINALIZER_closure);
1744 if (info == stg_MVAR_CLEAN_info) {
1745 foreign "C" dirty_MVAR(BaseReg "ptr", mvar "ptr");
1748 /* we got the value... */
1749 val = StgMVar_value(mvar);
1751 if (StgMVar_head(mvar) != stg_END_TSO_QUEUE_closure) {
1753 /* There are putMVar(s) waiting...
1754 * wake up the first thread on the queue
1756 ASSERT(StgTSO_why_blocked(StgMVar_head(mvar)) == BlockedOnMVar::I16);
1758 /* actually perform the putMVar for the thread that we just woke up */
1759 tso = StgMVar_head(mvar);
1760 PerformPut(tso,StgMVar_value(mvar));
1761 if (TO_W_(StgTSO_flags(tso)) & TSO_DIRTY == 0) {
1762 foreign "C" dirty_TSO(MyCapability() "ptr", tso "ptr") [];
1765 ("ptr" tso) = foreign "C" unblockOne_(MyCapability() "ptr",
1766 StgMVar_head(mvar) "ptr", 1) [];
1767 StgMVar_head(mvar) = tso;
1769 if (StgMVar_head(mvar) == stg_END_TSO_QUEUE_closure) {
1770 StgMVar_tail(mvar) = stg_END_TSO_QUEUE_closure;
1772 #if defined(THREADED_RTS)
1773 unlockClosure(mvar, stg_MVAR_DIRTY_info);
1775 SET_INFO(mvar,stg_MVAR_DIRTY_info);
1780 /* No further putMVars, MVar is now empty */
1781 StgMVar_value(mvar) = stg_END_TSO_QUEUE_closure;
1782 #if defined(THREADED_RTS)
1783 unlockClosure(mvar, stg_MVAR_DIRTY_info);
1785 SET_INFO(mvar,stg_MVAR_DIRTY_info);
1795 W_ mvar, val, info, tso;
1797 /* args: R1 = MVar, R2 = value */
1801 #if defined(THREADED_RTS)
1802 ("ptr" info) = foreign "C" lockClosure(mvar "ptr") [];
1804 info = GET_INFO(mvar);
1807 if (info == stg_MVAR_CLEAN_info) {
1808 foreign "C" dirty_MVAR(BaseReg "ptr", mvar "ptr");
1811 if (StgMVar_value(mvar) != stg_END_TSO_QUEUE_closure) {
1812 if (StgMVar_head(mvar) == stg_END_TSO_QUEUE_closure) {
1813 StgMVar_head(mvar) = CurrentTSO;
1815 foreign "C" setTSOLink(MyCapability() "ptr",
1816 StgMVar_tail(mvar) "ptr",
1819 StgTSO__link(CurrentTSO) = stg_END_TSO_QUEUE_closure;
1820 StgTSO_block_info(CurrentTSO) = mvar;
1821 // write barrier for throwTo(), which looks at block_info
1822 // if why_blocked==BlockedOnMVar.
1823 prim %write_barrier() [];
1824 StgTSO_why_blocked(CurrentTSO) = BlockedOnMVar::I16;
1825 StgMVar_tail(mvar) = CurrentTSO;
1829 jump stg_block_putmvar;
1832 if (StgMVar_head(mvar) != stg_END_TSO_QUEUE_closure) {
1834 /* There are takeMVar(s) waiting: wake up the first one
1836 ASSERT(StgTSO_why_blocked(StgMVar_head(mvar)) == BlockedOnMVar::I16);
1838 /* actually perform the takeMVar */
1839 tso = StgMVar_head(mvar);
1840 PerformTake(tso, val);
1841 if (TO_W_(StgTSO_flags(tso)) & TSO_DIRTY == 0) {
1842 foreign "C" dirty_TSO(MyCapability() "ptr", tso "ptr") [];
1845 ("ptr" tso) = foreign "C" unblockOne_(MyCapability() "ptr",
1846 StgMVar_head(mvar) "ptr", 1) [];
1847 StgMVar_head(mvar) = tso;
1849 if (StgMVar_head(mvar) == stg_END_TSO_QUEUE_closure) {
1850 StgMVar_tail(mvar) = stg_END_TSO_QUEUE_closure;
1853 #if defined(THREADED_RTS)
1854 unlockClosure(mvar, stg_MVAR_DIRTY_info);
1856 SET_INFO(mvar,stg_MVAR_DIRTY_info);
1858 jump %ENTRY_CODE(Sp(0));
1862 /* No further takes, the MVar is now full. */
1863 StgMVar_value(mvar) = val;
1865 #if defined(THREADED_RTS)
1866 unlockClosure(mvar, stg_MVAR_DIRTY_info);
1868 SET_INFO(mvar,stg_MVAR_DIRTY_info);
1870 jump %ENTRY_CODE(Sp(0));
1873 /* ToDo: yield afterward for better communication performance? */
1881 /* args: R1 = MVar, R2 = value */
1884 #if defined(THREADED_RTS)
1885 ("ptr" info) = foreign "C" lockClosure(mvar "ptr") [R2];
1887 info = GET_INFO(mvar);
1890 if (StgMVar_value(mvar) != stg_END_TSO_QUEUE_closure) {
1891 #if defined(THREADED_RTS)
1892 unlockClosure(mvar, info);
1897 if (info == stg_MVAR_CLEAN_info) {
1898 foreign "C" dirty_MVAR(BaseReg "ptr", mvar "ptr");
1901 if (StgMVar_head(mvar) != stg_END_TSO_QUEUE_closure) {
1903 /* There are takeMVar(s) waiting: wake up the first one
1905 ASSERT(StgTSO_why_blocked(StgMVar_head(mvar)) == BlockedOnMVar::I16);
1907 /* actually perform the takeMVar */
1908 tso = StgMVar_head(mvar);
1909 PerformTake(tso, R2);
1910 if (TO_W_(StgTSO_flags(tso)) & TSO_DIRTY == 0) {
1911 foreign "C" dirty_TSO(MyCapability() "ptr", tso "ptr") [];
1914 ("ptr" tso) = foreign "C" unblockOne_(MyCapability() "ptr",
1915 StgMVar_head(mvar) "ptr", 1) [];
1916 StgMVar_head(mvar) = tso;
1918 if (StgMVar_head(mvar) == stg_END_TSO_QUEUE_closure) {
1919 StgMVar_tail(mvar) = stg_END_TSO_QUEUE_closure;
1922 #if defined(THREADED_RTS)
1923 unlockClosure(mvar, stg_MVAR_DIRTY_info);
1925 SET_INFO(mvar,stg_MVAR_DIRTY_info);
1930 /* No further takes, the MVar is now full. */
1931 StgMVar_value(mvar) = R2;
1933 #if defined(THREADED_RTS)
1934 unlockClosure(mvar, stg_MVAR_DIRTY_info);
1936 SET_INFO(mvar,stg_MVAR_DIRTY_info);
1941 /* ToDo: yield afterward for better communication performance? */
1945 /* -----------------------------------------------------------------------------
1946 Stable pointer primitives
1947 ------------------------------------------------------------------------- */
1949 makeStableNamezh_fast
1953 ALLOC_PRIM( SIZEOF_StgStableName, R1_PTR, makeStableNamezh_fast );
1955 (index) = foreign "C" lookupStableName(R1 "ptr") [];
1957 /* Is there already a StableName for this heap object?
1958 * stable_ptr_table is a pointer to an array of snEntry structs.
1960 if ( snEntry_sn_obj(W_[stable_ptr_table] + index*SIZEOF_snEntry) == NULL ) {
1961 sn_obj = Hp - SIZEOF_StgStableName + WDS(1);
1962 SET_HDR(sn_obj, stg_STABLE_NAME_info, W_[CCCS]);
1963 StgStableName_sn(sn_obj) = index;
1964 snEntry_sn_obj(W_[stable_ptr_table] + index*SIZEOF_snEntry) = sn_obj;
1966 sn_obj = snEntry_sn_obj(W_[stable_ptr_table] + index*SIZEOF_snEntry);
1973 makeStablePtrzh_fast
1977 MAYBE_GC(R1_PTR, makeStablePtrzh_fast);
1978 ("ptr" sp) = foreign "C" getStablePtr(R1 "ptr") [];
1982 deRefStablePtrzh_fast
1984 /* Args: R1 = the stable ptr */
1987 r = snEntry_addr(W_[stable_ptr_table] + sp*SIZEOF_snEntry);
1991 /* -----------------------------------------------------------------------------
1992 Bytecode object primitives
1993 ------------------------------------------------------------------------- */
2003 W_ bco, bitmap_arr, bytes, words;
2007 words = BYTES_TO_WDS(SIZEOF_StgBCO) + StgArrWords_words(bitmap_arr);
2010 ALLOC_PRIM( bytes, R1_PTR&R2_PTR&R3_PTR&R5_PTR, newBCOzh_fast );
2012 bco = Hp - bytes + WDS(1);
2013 SET_HDR(bco, stg_BCO_info, W_[CCCS]);
2015 StgBCO_instrs(bco) = R1;
2016 StgBCO_literals(bco) = R2;
2017 StgBCO_ptrs(bco) = R3;
2018 StgBCO_arity(bco) = HALF_W_(R4);
2019 StgBCO_size(bco) = HALF_W_(words);
2021 // Copy the arity/bitmap info into the BCO
2025 if (i < StgArrWords_words(bitmap_arr)) {
2026 StgBCO_bitmap(bco,i) = StgArrWords_payload(bitmap_arr,i);
2037 // R1 = the BCO# for the AP
2041 // This function is *only* used to wrap zero-arity BCOs in an
2042 // updatable wrapper (see ByteCodeLink.lhs). An AP thunk is always
2043 // saturated and always points directly to a FUN or BCO.
2044 ASSERT(%INFO_TYPE(%GET_STD_INFO(R1)) == HALF_W_(BCO) &&
2045 StgBCO_arity(R1) == HALF_W_(0));
2047 HP_CHK_GEN_TICKY(SIZEOF_StgAP, R1_PTR, mkApUpd0zh_fast);
2048 TICK_ALLOC_UP_THK(0, 0);
2049 CCCS_ALLOC(SIZEOF_StgAP);
2051 ap = Hp - SIZEOF_StgAP + WDS(1);
2052 SET_HDR(ap, stg_AP_info, W_[CCCS]);
2054 StgAP_n_args(ap) = HALF_W_(0);
2060 unpackClosurezh_fast
2062 /* args: R1 = closure to analyze */
2063 // TODO: Consider the absence of ptrs or nonptrs as a special case ?
2065 W_ info, ptrs, nptrs, p, ptrs_arr, nptrs_arr;
2066 info = %GET_STD_INFO(UNTAG(R1));
2068 // Some closures have non-standard layout, so we omit those here.
2070 type = TO_W_(%INFO_TYPE(info));
2071 switch [0 .. N_CLOSURE_TYPES] type {
2072 case THUNK_SELECTOR : {
2077 case THUNK, THUNK_1_0, THUNK_0_1, THUNK_2_0, THUNK_1_1,
2078 THUNK_0_2, THUNK_STATIC, AP, PAP, AP_STACK, BCO : {
2084 ptrs = TO_W_(%INFO_PTRS(info));
2085 nptrs = TO_W_(%INFO_NPTRS(info));
2090 W_ ptrs_arr_sz, nptrs_arr_sz;
2091 nptrs_arr_sz = SIZEOF_StgArrWords + WDS(nptrs);
2092 ptrs_arr_sz = SIZEOF_StgMutArrPtrs + WDS(ptrs);
2094 ALLOC_PRIM (ptrs_arr_sz + nptrs_arr_sz, R1_PTR, unpackClosurezh_fast);
2099 ptrs_arr = Hp - nptrs_arr_sz - ptrs_arr_sz + WDS(1);
2100 nptrs_arr = Hp - nptrs_arr_sz + WDS(1);
2102 SET_HDR(ptrs_arr, stg_MUT_ARR_PTRS_FROZEN_info, W_[CCCS]);
2103 StgMutArrPtrs_ptrs(ptrs_arr) = ptrs;
2107 W_[ptrs_arr + SIZEOF_StgMutArrPtrs + WDS(p)] = StgClosure_payload(clos,p);
2112 SET_HDR(nptrs_arr, stg_ARR_WORDS_info, W_[CCCS]);
2113 StgArrWords_words(nptrs_arr) = nptrs;
2117 W_[BYTE_ARR_CTS(nptrs_arr) + WDS(p)] = StgClosure_payload(clos, p+ptrs);
2121 RET_NPP(info, ptrs_arr, nptrs_arr);
2124 /* -----------------------------------------------------------------------------
2125 Thread I/O blocking primitives
2126 -------------------------------------------------------------------------- */
2128 /* Add a thread to the end of the blocked queue. (C-- version of the C
2129 * macro in Schedule.h).
2131 #define APPEND_TO_BLOCKED_QUEUE(tso) \
2132 ASSERT(StgTSO__link(tso) == END_TSO_QUEUE); \
2133 if (W_[blocked_queue_hd] == END_TSO_QUEUE) { \
2134 W_[blocked_queue_hd] = tso; \
2136 foreign "C" setTSOLink(MyCapability() "ptr", W_[blocked_queue_tl] "ptr", tso) []; \
2138 W_[blocked_queue_tl] = tso;
2144 foreign "C" barf("waitRead# on threaded RTS") never returns;
2147 ASSERT(StgTSO_why_blocked(CurrentTSO) == NotBlocked::I16);
2148 StgTSO_why_blocked(CurrentTSO) = BlockedOnRead::I16;
2149 StgTSO_block_info(CurrentTSO) = R1;
2150 // No locking - we're not going to use this interface in the
2151 // threaded RTS anyway.
2152 APPEND_TO_BLOCKED_QUEUE(CurrentTSO);
2153 jump stg_block_noregs;
2161 foreign "C" barf("waitWrite# on threaded RTS") never returns;
2164 ASSERT(StgTSO_why_blocked(CurrentTSO) == NotBlocked::I16);
2165 StgTSO_why_blocked(CurrentTSO) = BlockedOnWrite::I16;
2166 StgTSO_block_info(CurrentTSO) = R1;
2167 // No locking - we're not going to use this interface in the
2168 // threaded RTS anyway.
2169 APPEND_TO_BLOCKED_QUEUE(CurrentTSO);
2170 jump stg_block_noregs;
2175 STRING(stg_delayzh_malloc_str, "delayzh_fast")
2178 #ifdef mingw32_HOST_OS
2186 foreign "C" barf("delay# on threaded RTS") never returns;
2189 /* args: R1 (microsecond delay amount) */
2190 ASSERT(StgTSO_why_blocked(CurrentTSO) == NotBlocked::I16);
2191 StgTSO_why_blocked(CurrentTSO) = BlockedOnDelay::I16;
2193 #ifdef mingw32_HOST_OS
2195 /* could probably allocate this on the heap instead */
2196 ("ptr" ares) = foreign "C" stgMallocBytes(SIZEOF_StgAsyncIOResult,
2197 stg_delayzh_malloc_str);
2198 (reqID) = foreign "C" addDelayRequest(R1);
2199 StgAsyncIOResult_reqID(ares) = reqID;
2200 StgAsyncIOResult_len(ares) = 0;
2201 StgAsyncIOResult_errCode(ares) = 0;
2202 StgTSO_block_info(CurrentTSO) = ares;
2204 /* Having all async-blocked threads reside on the blocked_queue
2205 * simplifies matters, so change the status to OnDoProc put the
2206 * delayed thread on the blocked_queue.
2208 StgTSO_why_blocked(CurrentTSO) = BlockedOnDoProc::I16;
2209 APPEND_TO_BLOCKED_QUEUE(CurrentTSO);
2210 jump stg_block_async_void;
2216 (time) = foreign "C" getourtimeofday() [R1];
2217 divisor = TO_W_(RtsFlags_MiscFlags_tickInterval(RtsFlags));
2221 divisor = divisor * 1000;
2222 target = ((R1 + divisor - 1) / divisor) /* divide rounding up */
2223 + time + 1; /* Add 1 as getourtimeofday rounds down */
2224 StgTSO_block_info(CurrentTSO) = target;
2226 /* Insert the new thread in the sleeping queue. */
2228 t = W_[sleeping_queue];
2230 if (t != END_TSO_QUEUE && StgTSO_block_info(t) < target) {
2232 t = StgTSO__link(t);
2236 StgTSO__link(CurrentTSO) = t;
2238 W_[sleeping_queue] = CurrentTSO;
2240 foreign "C" setTSOLink(MyCapability() "ptr", prev "ptr", CurrentTSO) [];
2242 jump stg_block_noregs;
2244 #endif /* !THREADED_RTS */
2248 #ifdef mingw32_HOST_OS
2249 STRING(stg_asyncReadzh_malloc_str, "asyncReadzh_fast")
2256 foreign "C" barf("asyncRead# on threaded RTS") never returns;
2259 /* args: R1 = fd, R2 = isSock, R3 = len, R4 = buf */
2260 ASSERT(StgTSO_why_blocked(CurrentTSO) == NotBlocked::I16);
2261 StgTSO_why_blocked(CurrentTSO) = BlockedOnRead::I16;
2263 /* could probably allocate this on the heap instead */
2264 ("ptr" ares) = foreign "C" stgMallocBytes(SIZEOF_StgAsyncIOResult,
2265 stg_asyncReadzh_malloc_str)
2267 (reqID) = foreign "C" addIORequest(R1, 0/*FALSE*/,R2,R3,R4 "ptr") [];
2268 StgAsyncIOResult_reqID(ares) = reqID;
2269 StgAsyncIOResult_len(ares) = 0;
2270 StgAsyncIOResult_errCode(ares) = 0;
2271 StgTSO_block_info(CurrentTSO) = ares;
2272 APPEND_TO_BLOCKED_QUEUE(CurrentTSO);
2273 jump stg_block_async;
2277 STRING(stg_asyncWritezh_malloc_str, "asyncWritezh_fast")
2284 foreign "C" barf("asyncWrite# on threaded RTS") never returns;
2287 /* args: R1 = fd, R2 = isSock, R3 = len, R4 = buf */
2288 ASSERT(StgTSO_why_blocked(CurrentTSO) == NotBlocked::I16);
2289 StgTSO_why_blocked(CurrentTSO) = BlockedOnWrite::I16;
2291 ("ptr" ares) = foreign "C" stgMallocBytes(SIZEOF_StgAsyncIOResult,
2292 stg_asyncWritezh_malloc_str)
2294 (reqID) = foreign "C" addIORequest(R1, 1/*TRUE*/,R2,R3,R4 "ptr") [];
2296 StgAsyncIOResult_reqID(ares) = reqID;
2297 StgAsyncIOResult_len(ares) = 0;
2298 StgAsyncIOResult_errCode(ares) = 0;
2299 StgTSO_block_info(CurrentTSO) = ares;
2300 APPEND_TO_BLOCKED_QUEUE(CurrentTSO);
2301 jump stg_block_async;
2305 STRING(stg_asyncDoProczh_malloc_str, "asyncDoProczh_fast")
2312 foreign "C" barf("asyncDoProc# on threaded RTS") never returns;
2315 /* args: R1 = proc, R2 = param */
2316 ASSERT(StgTSO_why_blocked(CurrentTSO) == NotBlocked::I16);
2317 StgTSO_why_blocked(CurrentTSO) = BlockedOnDoProc::I16;
2319 /* could probably allocate this on the heap instead */
2320 ("ptr" ares) = foreign "C" stgMallocBytes(SIZEOF_StgAsyncIOResult,
2321 stg_asyncDoProczh_malloc_str)
2323 (reqID) = foreign "C" addDoProcRequest(R1 "ptr",R2 "ptr") [];
2324 StgAsyncIOResult_reqID(ares) = reqID;
2325 StgAsyncIOResult_len(ares) = 0;
2326 StgAsyncIOResult_errCode(ares) = 0;
2327 StgTSO_block_info(CurrentTSO) = ares;
2328 APPEND_TO_BLOCKED_QUEUE(CurrentTSO);
2329 jump stg_block_async;
2334 // noDuplicate# tries to ensure that none of the thunks under
2335 // evaluation by the current thread are also under evaluation by
2336 // another thread. It relies on *both* threads doing noDuplicate#;
2337 // the second one will get blocked if they are duplicating some work.
2340 SAVE_THREAD_STATE();
2341 ASSERT(StgTSO_what_next(CurrentTSO) == ThreadRunGHC::I16);
2342 foreign "C" threadPaused (MyCapability() "ptr", CurrentTSO "ptr") [];
2344 if (StgTSO_what_next(CurrentTSO) == ThreadKilled::I16) {
2345 jump stg_threadFinished;
2347 LOAD_THREAD_STATE();
2348 ASSERT(StgTSO_what_next(CurrentTSO) == ThreadRunGHC::I16);
2349 jump %ENTRY_CODE(Sp(0));
2353 getApStackValzh_fast
2355 W_ ap_stack, offset, val, ok;
2357 /* args: R1 = AP_STACK, R2 = offset */
2361 if (%INFO_PTR(ap_stack) == stg_AP_STACK_info) {
2363 val = StgAP_STACK_payload(ap_stack,offset);
2371 /* -----------------------------------------------------------------------------
2373 -------------------------------------------------------------------------- */
2375 // Write the cost center stack of the first argument on stderr; return
2376 // the second. Possibly only makes sense for already evaluated
2383 ccs = StgHeader_ccs(UNTAG(R1));
2384 foreign "C" fprintCCS_stderr(ccs "ptr") [R2];
2395 #ifndef THREADED_RTS
2396 RET_NP(0,ghczmprim_GHCziBool_False_closure);
2398 (spark) = foreign "C" findSpark(MyCapability());
2402 RET_NP(0,ghczmprim_GHCziBool_False_closure);