PrimOps.cmm 52.3 KB
Newer Older
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
/* -----------------------------------------------------------------------------
 *
 * (c) The GHC Team, 1998-2004
 *
 * Out-of-line primitive operations
 *
 * This file contains the implementations of all the primitive
 * operations ("primops") which are not expanded inline.  See
 * ghc/compiler/prelude/primops.txt.pp for a list of all the primops;
 * this file contains code for most of those with the attribute
 * out_of_line=True.
 *
 * Entry convention: the entry convention for a primop is that all the
 * args are in Stg registers (R1, R2, etc.).  This is to make writing
 * the primops easier.  (see compiler/codeGen/CgCallConv.hs).
 *
 * Return convention: results from a primop are generally returned
 * using the ordinary unboxed tuple return convention.  The C-- parser
 * implements the RET_xxxx() macros to perform unboxed-tuple returns
 * based on the prevailing return convention.
 *
 * This file is written in a subset of C--, extended with various
 * features specific to GHC.  It is compiled by GHC directly.  For the
 * syntax of .cmm files, see the parser in ghc/compiler/cmm/CmmParse.y.
 *
 * ---------------------------------------------------------------------------*/

#include "Cmm.h"

30
#ifdef __PIC__
31
32
import pthread_mutex_lock;
import pthread_mutex_unlock;
33
#endif
34
import base_ControlziExceptionziBase_nestedAtomically_closure;
35
36
import EnterCriticalSection;
import LeaveCriticalSection;
37
import ghczmprim_GHCziBool_False_closure;
38

39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
/*-----------------------------------------------------------------------------
  Array Primitives

  Basically just new*Array - the others are all inline macros.

  The size arg is always passed in R1, and the result returned in R1.

  The slow entry point is for returning from a heap check, the saved
  size argument must be re-loaded from the stack.
  -------------------------------------------------------------------------- */

/* for objects that are *less* than the size of a word, make sure we
 * round up to the nearest word for the size of the array.
 */

54
stg_newByteArrayzh
55
56
{
    W_ words, payload_words, n, p;
57
    MAYBE_GC(NO_PTRS,stg_newByteArrayzh);
58
59
60
    n = R1;
    payload_words = ROUNDUP_BYTES_TO_WDS(n);
    words = BYTES_TO_WDS(SIZEOF_StgArrWords) + payload_words;
61
    ("ptr" p) = foreign "C" allocate(MyCapability() "ptr",words) [];
62
63
64
65
66
67
    TICK_ALLOC_PRIM(SIZEOF_StgArrWords,WDS(payload_words),0);
    SET_HDR(p, stg_ARR_WORDS_info, W_[CCCS]);
    StgArrWords_words(p) = payload_words;
    RET_P(p);
}

Simon Marlow's avatar
Simon Marlow committed
68
69
70
#define BA_ALIGN 16
#define BA_MASK  (BA_ALIGN-1)

71
stg_newPinnedByteArrayzh
72
{
73
    W_ words, bytes, payload_words, p;
74

75
    MAYBE_GC(NO_PTRS,stg_newPinnedByteArrayzh);
76
77
78
79
80
81
82
83
84
85
86
    bytes = R1;
    /* payload_words is what we will tell the profiler we had to allocate */
    payload_words = ROUNDUP_BYTES_TO_WDS(bytes);
    /* When we actually allocate memory, we need to allow space for the
       header: */
    bytes = bytes + SIZEOF_StgArrWords;
    /* And we want to align to BA_ALIGN bytes, so we need to allow space
       to shift up to BA_ALIGN - 1 bytes: */
    bytes = bytes + BA_ALIGN - 1;
    /* Now we convert to a number of words: */
    words = ROUNDUP_BYTES_TO_WDS(bytes);
Simon Marlow's avatar
Simon Marlow committed
87

88
    ("ptr" p) = foreign "C" allocatePinned(MyCapability() "ptr", words) [];
Simon Marlow's avatar
Simon Marlow committed
89
90
    TICK_ALLOC_PRIM(SIZEOF_StgArrWords,WDS(payload_words),0);

91
92
    /* Now we need to move p forward so that the payload is aligned
       to BA_ALIGN bytes: */
Simon Marlow's avatar
Simon Marlow committed
93
94
95
96
97
98
99
    p = p + ((-p - SIZEOF_StgArrWords) & BA_MASK);

    SET_HDR(p, stg_ARR_WORDS_info, W_[CCCS]);
    StgArrWords_words(p) = payload_words;
    RET_P(p);
}

100
stg_newAlignedPinnedByteArrayzh
Simon Marlow's avatar
Simon Marlow committed
101
{
102
    W_ words, bytes, payload_words, p, alignment;
Simon Marlow's avatar
Simon Marlow committed
103

104
    MAYBE_GC(NO_PTRS,stg_newAlignedPinnedByteArrayzh);
105
106
    bytes = R1;
    alignment = R2;
Simon Marlow's avatar
Simon Marlow committed
107

108
109
    /* payload_words is what we will tell the profiler we had to allocate */
    payload_words = ROUNDUP_BYTES_TO_WDS(bytes);
Simon Marlow's avatar
Simon Marlow committed
110

111
112
113
114
115
116
117
118
    /* When we actually allocate memory, we need to allow space for the
       header: */
    bytes = bytes + SIZEOF_StgArrWords;
    /* And we want to align to <alignment> bytes, so we need to allow space
       to shift up to <alignment - 1> bytes: */
    bytes = bytes + alignment - 1;
    /* Now we convert to a number of words: */
    words = ROUNDUP_BYTES_TO_WDS(bytes);
119

120
    ("ptr" p) = foreign "C" allocatePinned(MyCapability() "ptr", words) [];
121
122
    TICK_ALLOC_PRIM(SIZEOF_StgArrWords,WDS(payload_words),0);

123
124
125
126
    /* Now we need to move p forward so that the payload is aligned
       to <alignment> bytes. Note that we are assuming that
       <alignment> is a power of 2, which is technically not guaranteed */
    p = p + ((-p - SIZEOF_StgArrWords) & (alignment - 1));
127
128
129
130
131
132

    SET_HDR(p, stg_ARR_WORDS_info, W_[CCCS]);
    StgArrWords_words(p) = payload_words;
    RET_P(p);
}

133
stg_newArrayzh
134
135
136
137
138
{
    W_ words, n, init, arr, p;
    /* Args: R1 = words, R2 = initialisation value */

    n = R1;
139
    MAYBE_GC(R2_PTR,stg_newArrayzh);
140
141

    words = BYTES_TO_WDS(SIZEOF_StgMutArrPtrs) + n;
142
    ("ptr" arr) = foreign "C" allocate(MyCapability() "ptr",words) [R2];
143
144
    TICK_ALLOC_PRIM(SIZEOF_StgMutArrPtrs, WDS(n), 0);

145
    SET_HDR(arr, stg_MUT_ARR_PTRS_DIRTY_info, W_[CCCS]);
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
    StgMutArrPtrs_ptrs(arr) = n;

    // Initialise all elements of the the array with the value in R2
    init = R2;
    p = arr + SIZEOF_StgMutArrPtrs;
  for:
    if (p < arr + WDS(words)) {
	W_[p] = init;
	p = p + WDS(1);
	goto for;
    }

    RET_P(arr);
}

161
stg_unsafeThawArrayzh
162
163
164
165
166
167
168
169
{
  // SUBTLETY TO DO WITH THE OLD GEN MUTABLE LIST
  //
  // A MUT_ARR_PTRS lives on the mutable list, but a MUT_ARR_PTRS_FROZEN 
  // normally doesn't.  However, when we freeze a MUT_ARR_PTRS, we leave
  // it on the mutable list for the GC to remove (removing something from
  // the mutable list is not easy, because the mut_list is only singly-linked).
  // 
170
  // So that we can tell whether a MUT_ARR_PTRS_FROZEN is on the mutable list,
171
172
173
  // when we freeze it we set the info ptr to be MUT_ARR_PTRS_FROZEN0
  // to indicate that it is still on the mutable list.
  //
174
175
  // So, when we thaw a MUT_ARR_PTRS_FROZEN, we must cope with two cases:
  // either it is on a mut_list, or it isn't.  We adopt the convention that
176
  // the closure type is MUT_ARR_PTRS_FROZEN0 if it is on the mutable list,
177
178
179
  // and MUT_ARR_PTRS_FROZEN otherwise.  In fact it wouldn't matter if
  // we put it on the mutable list more than once, but it would get scavenged
  // multiple times during GC, which would be unnecessarily slow.
180
  //
181
  if (StgHeader_info(R1) != stg_MUT_ARR_PTRS_FROZEN0_info) {
182
	SET_INFO(R1,stg_MUT_ARR_PTRS_DIRTY_info);
183
	recordMutable(R1, R1);
184
185
186
	// must be done after SET_INFO, because it ASSERTs closure_MUTABLE()
	RET_P(R1);
  } else {
187
	SET_INFO(R1,stg_MUT_ARR_PTRS_DIRTY_info);
188
	RET_P(R1);
189
190
191
192
193
194
195
  }
}

/* -----------------------------------------------------------------------------
   MutVar primitives
   -------------------------------------------------------------------------- */

196
stg_newMutVarzh
197
198
199
200
{
    W_ mv;
    /* Args: R1 = initialisation value */

201
    ALLOC_PRIM( SIZEOF_StgMutVar, R1_PTR, stg_newMutVarzh);
202
203

    mv = Hp - SIZEOF_StgMutVar + WDS(1);
204
    SET_HDR(mv,stg_MUT_VAR_DIRTY_info,W_[CCCS]);
205
206
207
208
209
    StgMutVar_var(mv) = R1;
    
    RET_P(mv);
}

210
stg_atomicModifyMutVarzh
211
{
212
    W_ mv, f, z, x, y, r, h;
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
    /* Args: R1 :: MutVar#,  R2 :: a -> (a,b) */

    /* If x is the current contents of the MutVar#, then 
       We want to make the new contents point to

         (sel_0 (f x))
 
       and the return value is
	 
	 (sel_1 (f x))

        obviously we can share (f x).

         z = [stg_ap_2 f x]  (max (HS + 2) MIN_UPD_SIZE)
	 y = [stg_sel_0 z]   (max (HS + 1) MIN_UPD_SIZE)
         r = [stg_sel_1 z]   (max (HS + 1) MIN_UPD_SIZE)
    */

#if MIN_UPD_SIZE > 1
232
#define THUNK_1_SIZE (SIZEOF_StgThunkHeader + WDS(MIN_UPD_SIZE))
233
234
#define TICK_ALLOC_THUNK_1() TICK_ALLOC_UP_THK(WDS(1),WDS(MIN_UPD_SIZE-1))
#else
235
#define THUNK_1_SIZE (SIZEOF_StgThunkHeader + WDS(1))
236
237
238
239
#define TICK_ALLOC_THUNK_1() TICK_ALLOC_UP_THK(WDS(1),0)
#endif

#if MIN_UPD_SIZE > 2
240
#define THUNK_2_SIZE (SIZEOF_StgThunkHeader + WDS(MIN_UPD_SIZE))
241
242
#define TICK_ALLOC_THUNK_2() TICK_ALLOC_UP_THK(WDS(2),WDS(MIN_UPD_SIZE-2))
#else
243
#define THUNK_2_SIZE (SIZEOF_StgThunkHeader + WDS(2))
244
245
246
247
248
#define TICK_ALLOC_THUNK_2() TICK_ALLOC_UP_THK(WDS(2),0)
#endif

#define SIZE (THUNK_2_SIZE + THUNK_1_SIZE + THUNK_1_SIZE)

249
   HP_CHK_GEN_TICKY(SIZE, R1_PTR & R2_PTR, stg_atomicModifyMutVarzh);
250

251
252
   mv = R1;
   f = R2;
253
254
255
256
257
258

   TICK_ALLOC_THUNK_2();
   CCCS_ALLOC(THUNK_2_SIZE);
   z = Hp - THUNK_2_SIZE + WDS(1);
   SET_HDR(z, stg_ap_2_upd_info, W_[CCCS]);
   LDV_RECORD_CREATE(z);
259
   StgThunk_payload(z,0) = f;
260
261
262
263
264
265

   TICK_ALLOC_THUNK_1();
   CCCS_ALLOC(THUNK_1_SIZE);
   y = z - THUNK_1_SIZE;
   SET_HDR(y, stg_sel_0_upd_info, W_[CCCS]);
   LDV_RECORD_CREATE(y);
266
   StgThunk_payload(y,0) = z;
267
268
269
270
271
272

   TICK_ALLOC_THUNK_1();
   CCCS_ALLOC(THUNK_1_SIZE);
   r = y - THUNK_1_SIZE;
   SET_HDR(r, stg_sel_1_upd_info, W_[CCCS]);
   LDV_RECORD_CREATE(r);
273
274
   StgThunk_payload(r,0) = z;

275
276
277
278
279
280
281
282
 retry:
   x = StgMutVar_var(mv);
   StgThunk_payload(z,1) = x;
#ifdef THREADED_RTS
   (h) = foreign "C" cas(mv + SIZEOF_StgHeader + OFFSET_StgMutVar_var, x, y) [];
   if (h != x) { goto retry; }
#else
   StgMutVar_var(mv) = y;
283
#endif
284

285
286
287
288
   if (GET_INFO(mv) == stg_MUT_VAR_CLEAN_info) {
     foreign "C" dirty_MUT_VAR(BaseReg "ptr", mv "ptr") [];
   }

289
290
291
292
293
294
295
296
297
   RET_P(r);
}

/* -----------------------------------------------------------------------------
   Weak Pointer Primitives
   -------------------------------------------------------------------------- */

STRING(stg_weak_msg,"New weak pointer at %p\n")

298
stg_mkWeakzh
299
300
301
302
303
304
305
306
307
308
309
{
  /* R1 = key
     R2 = value
     R3 = finalizer (or NULL)
  */
  W_ w;

  if (R3 == NULL) {
    R3 = stg_NO_FINALIZER_closure;
  }

310
  ALLOC_PRIM( SIZEOF_StgWeak, R1_PTR & R2_PTR & R3_PTR, stg_mkWeakzh );
311
312
313
314

  w = Hp - SIZEOF_StgWeak + WDS(1);
  SET_HDR(w, stg_WEAK_info, W_[CCCS]);

315
316
317
318
319
320
321
322
  // We don't care about cfinalizer here.
  // Should StgWeak_cfinalizer(w) be stg_NO_FINALIZER_closure or
  // something else?

  StgWeak_key(w)        = R1;
  StgWeak_value(w)      = R2;
  StgWeak_finalizer(w)  = R3;
  StgWeak_cfinalizer(w) = stg_NO_FINALIZER_closure;
323
324
325
326

  StgWeak_link(w)	= W_[weak_ptr_list];
  W_[weak_ptr_list] 	= w;

327
  IF_DEBUG(weak, foreign "C" debugBelch(stg_weak_msg,w) []);
328
329
330
331

  RET_P(w);
}

332
stg_mkWeakForeignEnvzh
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
{
  /* R1 = key
     R2 = value
     R3 = finalizer
     R4 = pointer
     R5 = has environment (0 or 1)
     R6 = environment
  */
  W_ w, payload_words, words, p;

  W_ key, val, fptr, ptr, flag, eptr;

  key  = R1;
  val  = R2;
  fptr = R3;
  ptr  = R4;
  flag = R5;
  eptr = R6;

352
  ALLOC_PRIM( SIZEOF_StgWeak, R1_PTR & R2_PTR, stg_mkWeakForeignEnvzh );
353
354
355
356
357
358

  w = Hp - SIZEOF_StgWeak + WDS(1);
  SET_HDR(w, stg_WEAK_info, W_[CCCS]);

  payload_words = 4;
  words         = BYTES_TO_WDS(SIZEOF_StgArrWords) + payload_words;
359
  ("ptr" p)     = foreign "C" allocate(MyCapability() "ptr", words) [];
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384

  TICK_ALLOC_PRIM(SIZEOF_StgArrWords,WDS(payload_words),0);
  SET_HDR(p, stg_ARR_WORDS_info, W_[CCCS]);

  StgArrWords_words(p)     = payload_words;
  StgArrWords_payload(p,0) = fptr;
  StgArrWords_payload(p,1) = ptr;
  StgArrWords_payload(p,2) = eptr;
  StgArrWords_payload(p,3) = flag;

  // We don't care about the value here.
  // Should StgWeak_value(w) be stg_NO_FINALIZER_closure or something else?

  StgWeak_key(w)        = key;
  StgWeak_value(w)      = val;
  StgWeak_finalizer(w)  = stg_NO_FINALIZER_closure;
  StgWeak_cfinalizer(w) = p;

  StgWeak_link(w)   = W_[weak_ptr_list];
  W_[weak_ptr_list] = w;

  IF_DEBUG(weak, foreign "C" debugBelch(stg_weak_msg,w) []);

  RET_P(w);
}
385

386
stg_finalizzeWeakzh
387
388
389
{
  /* R1 = weak ptr
   */
390
  W_ w, f, arr;
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417

  w = R1;

  // already dead?
  if (GET_INFO(w) == stg_DEAD_WEAK_info) {
      RET_NP(0,stg_NO_FINALIZER_closure);
  }

  // kill it
#ifdef PROFILING
  // @LDV profiling
  // A weak pointer is inherently used, so we do not need to call
  // LDV_recordDead_FILL_SLOP_DYNAMIC():
  //    LDV_recordDead_FILL_SLOP_DYNAMIC((StgClosure *)w);
  // or, LDV_recordDead():
  //    LDV_recordDead((StgClosure *)w, sizeofW(StgWeak) - sizeofW(StgProfHeader));
  // Furthermore, when PROFILING is turned on, dead weak pointers are exactly as 
  // large as weak pointers, so there is no need to fill the slop, either.
  // See stg_DEAD_WEAK_info in StgMiscClosures.hc.
#endif

  //
  // Todo: maybe use SET_HDR() and remove LDV_recordCreate()?
  //
  SET_INFO(w,stg_DEAD_WEAK_info);
  LDV_RECORD_CREATE(w);

418
419
420
  f   = StgWeak_finalizer(w);
  arr = StgWeak_cfinalizer(w);

421
  StgDeadWeak_link(w) = StgWeak_link(w);
422

423
424
425
426
427
428
429
  if (arr != stg_NO_FINALIZER_closure) {
    foreign "C" runCFinalizer(StgArrWords_payload(arr,0),
                              StgArrWords_payload(arr,1),
                              StgArrWords_payload(arr,2),
                              StgArrWords_payload(arr,3)) [];
  }

430
431
432
433
434
435
436
437
  /* return the finalizer */
  if (f == stg_NO_FINALIZER_closure) {
      RET_NP(0,stg_NO_FINALIZER_closure);
  } else {
      RET_NP(1,f);
  }
}

438
stg_deRefWeakzh
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
{
  /* R1 = weak ptr */
  W_ w, code, val;

  w = R1;
  if (GET_INFO(w) == stg_WEAK_info) {
    code = 1;
    val = StgWeak_value(w);
  } else {
    code = 0;
    val = w;
  }
  RET_NP(code,val);
}

/* -----------------------------------------------------------------------------
455
   Floating point operations.
456
457
   -------------------------------------------------------------------------- */

458
stg_decodeFloatzuIntzh
459
460
461
{ 
    W_ p;
    F_ arg;
462
463
464
    W_ mp_tmp1;
    W_ mp_tmp_w;

465
    STK_CHK_GEN( WDS(2), NO_PTRS, stg_decodeFloatzuIntzh );
466
467
468

    mp_tmp1  = Sp - WDS(1);
    mp_tmp_w = Sp - WDS(2);
469
470
471
472
473
474
475
476
477
478
479
    
    /* arguments: F1 = Float# */
    arg = F1;
    
    /* Perform the operation */
    foreign "C" __decodeFloat_Int(mp_tmp1 "ptr", mp_tmp_w "ptr", arg) [];
    
    /* returns: (Int# (mantissa), Int# (exponent)) */
    RET_NN(W_[mp_tmp1], W_[mp_tmp_w]);
}

480
stg_decodeDoublezu2Intzh
481
482
483
{ 
    D_ arg;
    W_ p;
484
485
486
487
488
    W_ mp_tmp1;
    W_ mp_tmp2;
    W_ mp_result1;
    W_ mp_result2;

489
    STK_CHK_GEN( WDS(4), NO_PTRS, stg_decodeDoublezu2Intzh );
490
491
492
493
494

    mp_tmp1    = Sp - WDS(1);
    mp_tmp2    = Sp - WDS(2);
    mp_result1 = Sp - WDS(3);
    mp_result2 = Sp - WDS(4);
495
496
497
498
499

    /* arguments: D1 = Double# */
    arg = D1;

    /* Perform the operation */
500
501
502
503
504
505
506
    foreign "C" __decodeDouble_2Int(mp_tmp1 "ptr", mp_tmp2 "ptr",
                                    mp_result1 "ptr", mp_result2 "ptr",
                                    arg) [];

    /* returns:
       (Int# (mant sign), Word# (mant high), Word# (mant low), Int# (expn)) */
    RET_NNNN(W_[mp_tmp1], W_[mp_tmp2], W_[mp_result1], W_[mp_result2]);
507
508
}

509
510
511
512
/* -----------------------------------------------------------------------------
 * Concurrency primitives
 * -------------------------------------------------------------------------- */

513
stg_forkzh
514
515
{
  /* args: R1 = closure to spark */
516

517
  MAYBE_GC(R1_PTR, stg_forkzh);
518

519
520
521
522
  W_ closure;
  W_ threadid;
  closure = R1;

523
  ("ptr" threadid) = foreign "C" createIOThread( MyCapability() "ptr", 
524
525
				RtsFlags_GcFlags_initialStkSize(RtsFlags), 
				closure "ptr") [];
526
527
528
529
530
531

  /* start blocked if the current thread is blocked */
  StgTSO_flags(threadid) = 
     StgTSO_flags(threadid) |  (StgTSO_flags(CurrentTSO) & 
                                (TSO_BLOCKEX::I32 | TSO_INTERRUPTIBLE::I32));

532
533
  foreign "C" scheduleThread(MyCapability() "ptr", threadid "ptr") [];

534
535
  // context switch soon, but not immediately: we don't want every
  // forkIO to force a context-switch.
536
  Capability_context_switch(MyCapability()) = 1 :: CInt;
537
538
539
540
  
  RET_P(threadid);
}

541
stg_forkOnzh
542
543
544
{
  /* args: R1 = cpu, R2 = closure to spark */

545
  MAYBE_GC(R2_PTR, stg_forkOnzh);
546
547
548
549
550
551
552

  W_ cpu;
  W_ closure;
  W_ threadid;
  cpu = R1;
  closure = R2;

553
  ("ptr" threadid) = foreign "C" createIOThread( MyCapability() "ptr", 
554
				RtsFlags_GcFlags_initialStkSize(RtsFlags), 
555
				closure "ptr") [];
556
557
558
559
560
561

  /* start blocked if the current thread is blocked */
  StgTSO_flags(threadid) = 
     StgTSO_flags(threadid) |  (StgTSO_flags(CurrentTSO) & 
                                (TSO_BLOCKEX::I32 | TSO_INTERRUPTIBLE::I32));

562
  foreign "C" scheduleThreadOn(MyCapability() "ptr", cpu, threadid "ptr") [];
563

564
565
  // context switch soon, but not immediately: we don't want every
  // forkIO to force a context-switch.
566
  Capability_context_switch(MyCapability()) = 1 :: CInt;
567
  
568
  RET_P(threadid);
569
570
}

571
stg_yieldzh
572
573
574
575
{
  jump stg_yield_noregs;
}

576
stg_myThreadIdzh
577
578
579
580
581
{
  /* no args. */
  RET_P(CurrentTSO);
}

582
stg_labelThreadzh
583
584
585
586
587
{
  /* args: 
	R1 = ThreadId#
	R2 = Addr# */
#ifdef DEBUG
588
  foreign "C" labelThread(R1 "ptr", R2 "ptr") [];
589
590
591
592
#endif
  jump %ENTRY_CODE(Sp(0));
}

593
stg_isCurrentThreadBoundzh
594
595
596
{
  /* no args */
  W_ r;
597
  (r) = foreign "C" isThreadBound(CurrentTSO) [];
598
599
600
  RET_N(r);
}

601
stg_threadStatuszh
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
{
    /* args: R1 :: ThreadId# */
    W_ tso;
    W_ why_blocked;
    W_ what_next;
    W_ ret;

    tso = R1;
    loop:
      if (TO_W_(StgTSO_what_next(tso)) == ThreadRelocated) {
          tso = StgTSO__link(tso);
          goto loop;
      }

    what_next   = TO_W_(StgTSO_what_next(tso));
    why_blocked = TO_W_(StgTSO_why_blocked(tso));
    // Note: these two reads are not atomic, so they might end up
    // being inconsistent.  It doesn't matter, since we
    // only return one or the other.  If we wanted to return the
    // contents of block_info too, then we'd have to do some synchronisation.

    if (what_next == ThreadComplete) {
        ret = 16;  // NB. magic, matches up with GHC.Conc.threadStatus
    } else {
        if (what_next == ThreadKilled) {
            ret = 17;
        } else {
            ret = why_blocked;
        }
    }
    RET_N(ret);
}
634
635
636
637
638
639
640
641
642

/* -----------------------------------------------------------------------------
 * TVar primitives
 * -------------------------------------------------------------------------- */

#define SP_OFF 0

// Catch retry frame ------------------------------------------------------------

643
INFO_TABLE_RET(stg_catch_retry_frame, CATCH_RETRY_FRAME,
644
#if defined(PROFILING)
645
  W_ unused1, W_ unused2,
646
#endif
647
  W_ unused3, P_ unused4, P_ unused5)
648
649
650
651
652
{
   W_ r, frame, trec, outer;

   frame = Sp;
   trec = StgTSO_trec(CurrentTSO);
653
   outer  = StgTRecHeader_enclosing_trec(trec);
654
   (r) = foreign "C" stmCommitNestedTransaction(MyCapability() "ptr", trec "ptr") [];
Simon Marlow's avatar
Simon Marlow committed
655
   if (r != 0) {
656
657
658
659
660
     /* Succeeded (either first branch or second branch) */
     StgTSO_trec(CurrentTSO) = outer;
     Sp = Sp + SIZEOF_StgCatchRetryFrame;
     jump %ENTRY_CODE(Sp(SP_OFF));
   } else {
tharris@microsoft.com's avatar
tharris@microsoft.com committed
661
     /* Did not commit: re-execute */
662
     W_ new_trec;
663
     ("ptr" new_trec) = foreign "C" stmStartTransaction(MyCapability() "ptr", outer "ptr") [];
664
     StgTSO_trec(CurrentTSO) = new_trec;
Simon Marlow's avatar
Simon Marlow committed
665
     if (StgCatchRetryFrame_running_alt_code(frame) != 0::I32) {
666
667
668
669
       R1 = StgCatchRetryFrame_alt_code(frame);
     } else {
       R1 = StgCatchRetryFrame_first_code(frame);
     }
670
     jump stg_ap_v_fast;
671
672
   }
}
673
674


Simon Marlow's avatar
Simon Marlow committed
675
// Atomically frame ------------------------------------------------------------
676

677
INFO_TABLE_RET(stg_atomically_frame, ATOMICALLY_FRAME,
678
#if defined(PROFILING)
679
  W_ unused1, W_ unused2,
680
#endif
681
  P_ code, P_ next_invariant_to_check, P_ result)
682
{
tharris@microsoft.com's avatar
tharris@microsoft.com committed
683
  W_ frame, trec, valid, next_invariant, q, outer;
684

685
686
687
  frame  = Sp;
  trec   = StgTSO_trec(CurrentTSO);
  result = R1;
688
  outer  = StgTRecHeader_enclosing_trec(trec);
tharris@microsoft.com's avatar
tharris@microsoft.com committed
689
690
691

  if (outer == NO_TREC) {
    /* First time back at the atomically frame -- pick up invariants */
692
    ("ptr" q) = foreign "C" stmGetInvariantsToCheck(MyCapability() "ptr", trec "ptr") [];
tharris@microsoft.com's avatar
tharris@microsoft.com committed
693
    StgAtomicallyFrame_next_invariant_to_check(frame) = q;
694
    StgAtomicallyFrame_result(frame) = result;
695
696

  } else {
tharris@microsoft.com's avatar
tharris@microsoft.com committed
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
    /* Second/subsequent time back at the atomically frame -- abort the
     * tx that's checking the invariant and move on to the next one */
    StgTSO_trec(CurrentTSO) = outer;
    q = StgAtomicallyFrame_next_invariant_to_check(frame);
    StgInvariantCheckQueue_my_execution(q) = trec;
    foreign "C" stmAbortTransaction(MyCapability() "ptr", trec "ptr") [];
    /* Don't free trec -- it's linked from q and will be stashed in the
     * invariant if we eventually commit. */
    q = StgInvariantCheckQueue_next_queue_entry(q);
    StgAtomicallyFrame_next_invariant_to_check(frame) = q;
    trec = outer;
  }

  q = StgAtomicallyFrame_next_invariant_to_check(frame);

  if (q != END_INVARIANT_CHECK_QUEUE) {
    /* We can't commit yet: another invariant to check */
714
    ("ptr" trec) = foreign "C" stmStartTransaction(MyCapability() "ptr", trec "ptr") [];
715
    StgTSO_trec(CurrentTSO) = trec;
tharris@microsoft.com's avatar
tharris@microsoft.com committed
716
717
718

    next_invariant = StgInvariantCheckQueue_invariant(q);
    R1 = StgAtomicInvariant_code(next_invariant);
719
    jump stg_ap_v_fast;
tharris@microsoft.com's avatar
tharris@microsoft.com committed
720
721
722
723

  } else {

    /* We've got no more invariants to check, try to commit */
724
    (valid) = foreign "C" stmCommitTransaction(MyCapability() "ptr", trec "ptr") [];
tharris@microsoft.com's avatar
tharris@microsoft.com committed
725
726
727
    if (valid != 0) {
      /* Transaction was valid: commit succeeded */
      StgTSO_trec(CurrentTSO) = NO_TREC;
728
      R1 = StgAtomicallyFrame_result(frame);
tharris@microsoft.com's avatar
tharris@microsoft.com committed
729
730
731
732
      Sp = Sp + SIZEOF_StgAtomicallyFrame;
      jump %ENTRY_CODE(Sp(SP_OFF));
    } else {
      /* Transaction was not valid: try again */
733
      ("ptr" trec) = foreign "C" stmStartTransaction(MyCapability() "ptr", NO_TREC "ptr") [];
tharris@microsoft.com's avatar
tharris@microsoft.com committed
734
735
736
737
738
      StgTSO_trec(CurrentTSO) = trec;
      StgAtomicallyFrame_next_invariant_to_check(frame) = END_INVARIANT_CHECK_QUEUE;
      R1 = StgAtomicallyFrame_code(frame);
      jump stg_ap_v_fast;
    }
739
740
741
  }
}

742
743
744
745
INFO_TABLE_RET(stg_atomically_waiting_frame, ATOMICALLY_FRAME,
#if defined(PROFILING)
  W_ unused1, W_ unused2,
#endif
746
  P_ code, P_ next_invariant_to_check, P_ result)
747
748
749
750
751
752
{
  W_ frame, trec, valid;

  frame = Sp;

  /* The TSO is currently waiting: should we stop waiting? */
753
  (valid) = foreign "C" stmReWait(MyCapability() "ptr", CurrentTSO "ptr") [];
Simon Marlow's avatar
Simon Marlow committed
754
  if (valid != 0) {
755
756
757
758
    /* Previous attempt is still valid: no point trying again yet */
    jump stg_block_noregs;
  } else {
    /* Previous attempt is no longer valid: try again */
759
    ("ptr" trec) = foreign "C" stmStartTransaction(MyCapability() "ptr", NO_TREC "ptr") [];
760
761
762
    StgTSO_trec(CurrentTSO) = trec;
    StgHeader_info(frame) = stg_atomically_frame_info;
    R1 = StgAtomicallyFrame_code(frame);
763
    jump stg_ap_v_fast;
764
  }
765
}
766
767
768
769
770
771
772
773
774
775

// STM catch frame --------------------------------------------------------------

#define SP_OFF 0

/* Catch frames are very similar to update frames, but when entering
 * one we just pop the frame off the stack and perform the correct
 * kind of return to the activation record underneath us on the stack.
 */

776
777
778
779
INFO_TABLE_RET(stg_catch_stm_frame, CATCH_STM_FRAME,
#if defined(PROFILING)
  W_ unused1, W_ unused2,
#endif
780
  P_ unused3, P_ unused4)
Simon Marlow's avatar
Simon Marlow committed
781
782
783
784
   {
      W_ r, frame, trec, outer;
      frame = Sp;
      trec = StgTSO_trec(CurrentTSO);
785
      outer  = StgTRecHeader_enclosing_trec(trec);
786
      (r) = foreign "C" stmCommitNestedTransaction(MyCapability() "ptr", trec "ptr") [];
Simon Marlow's avatar
Simon Marlow committed
787
788
789
790
791
792
793
794
      if (r != 0) {
        /* Commit succeeded */
        StgTSO_trec(CurrentTSO) = outer;
        Sp = Sp + SIZEOF_StgCatchSTMFrame;
        jump Sp(SP_OFF);
      } else {
        /* Commit failed */
        W_ new_trec;
795
        ("ptr" new_trec) = foreign "C" stmStartTransaction(MyCapability() "ptr", outer "ptr") [];
Simon Marlow's avatar
Simon Marlow committed
796
797
798
799
800
        StgTSO_trec(CurrentTSO) = new_trec;
        R1 = StgCatchSTMFrame_code(frame);
        jump stg_ap_v_fast;
      }
   }
801
802
803
804


// Primop definition ------------------------------------------------------------

805
stg_atomicallyzh
806
807
808
809
810
{
  W_ frame;
  W_ old_trec;
  W_ new_trec;
  
811
  // stmStartTransaction may allocate
812
  MAYBE_GC (R1_PTR, stg_atomicallyzh); 
813

814
  /* Args: R1 = m :: STM a */
815
  STK_CHK_GEN(SIZEOF_StgAtomicallyFrame + WDS(1), R1_PTR, stg_atomicallyzh);
816

817
818
819
820
  old_trec = StgTSO_trec(CurrentTSO);

  /* Nested transactions are not allowed; raise an exception */
  if (old_trec != NO_TREC) {
821
     R1 = base_ControlziExceptionziBase_nestedAtomically_closure;
822
     jump stg_raisezh;
823
824
  }

825
826
827
828
  /* Set up the atomically frame */
  Sp = Sp - SIZEOF_StgAtomicallyFrame;
  frame = Sp;

829
  SET_HDR(frame,stg_atomically_frame_info, W_[CCCS]);
830
  StgAtomicallyFrame_code(frame) = R1;
831
  StgAtomicallyFrame_result(frame) = NO_TREC;
tharris@microsoft.com's avatar
tharris@microsoft.com committed
832
  StgAtomicallyFrame_next_invariant_to_check(frame) = END_INVARIANT_CHECK_QUEUE;
833
834

  /* Start the memory transcation */
835
  ("ptr" new_trec) = foreign "C" stmStartTransaction(MyCapability() "ptr", old_trec "ptr") [R1];
836
837
838
  StgTSO_trec(CurrentTSO) = new_trec;

  /* Apply R1 to the realworld token */
839
  jump stg_ap_v_fast;
840
841
842
}


843
stg_catchSTMzh
844
845
846
847
848
{
  W_ frame;
  
  /* Args: R1 :: STM a */
  /* Args: R2 :: Exception -> STM a */
849
  STK_CHK_GEN(SIZEOF_StgCatchSTMFrame + WDS(1), R1_PTR & R2_PTR, stg_catchSTMzh);
850
851
852
853
854

  /* Set up the catch frame */
  Sp = Sp - SIZEOF_StgCatchSTMFrame;
  frame = Sp;

855
  SET_HDR(frame, stg_catch_stm_frame_info, W_[CCCS]);
856
  StgCatchSTMFrame_handler(frame) = R2;
tharris@microsoft.com's avatar
tharris@microsoft.com committed
857
858
859
860
861
862
  StgCatchSTMFrame_code(frame) = R1;

  /* Start a nested transaction to run the body of the try block in */
  W_ cur_trec;  
  W_ new_trec;
  cur_trec = StgTSO_trec(CurrentTSO);
863
  ("ptr" new_trec) = foreign "C" stmStartTransaction(MyCapability() "ptr", cur_trec "ptr");
tharris@microsoft.com's avatar
tharris@microsoft.com committed
864
  StgTSO_trec(CurrentTSO) = new_trec;
865
866

  /* Apply R1 to the realworld token */
867
  jump stg_ap_v_fast;
868
869
870
}


871
stg_catchRetryzh
872
873
874
875
876
{
  W_ frame;
  W_ new_trec;
  W_ trec;

877
  // stmStartTransaction may allocate
878
  MAYBE_GC (R1_PTR & R2_PTR, stg_catchRetryzh); 
879

880
881
  /* Args: R1 :: STM a */
  /* Args: R2 :: STM a */
882
  STK_CHK_GEN(SIZEOF_StgCatchRetryFrame + WDS(1), R1_PTR & R2_PTR, stg_catchRetryzh);
883
884
885

  /* Start a nested transaction within which to run the first code */
  trec = StgTSO_trec(CurrentTSO);
886
  ("ptr" new_trec) = foreign "C" stmStartTransaction(MyCapability() "ptr", trec "ptr") [R1,R2];
887
888
889
890
891
892
  StgTSO_trec(CurrentTSO) = new_trec;

  /* Set up the catch-retry frame */
  Sp = Sp - SIZEOF_StgCatchRetryFrame;
  frame = Sp;
  
893
  SET_HDR(frame, stg_catch_retry_frame_info, W_[CCCS]);
894
  StgCatchRetryFrame_running_alt_code(frame) = 0 :: CInt; // false;
895
896
897
898
  StgCatchRetryFrame_first_code(frame) = R1;
  StgCatchRetryFrame_alt_code(frame) = R2;

  /* Apply R1 to the realworld token */
899
  jump stg_ap_v_fast;
900
901
902
}


903
stg_retryzh
904
905
906
907
908
909
910
{
  W_ frame_type;
  W_ frame;
  W_ trec;
  W_ outer;
  W_ r;

911
  MAYBE_GC (NO_PTRS, stg_retryzh); // STM operations may allocate
912
913
914
915

  // Find the enclosing ATOMICALLY_FRAME or CATCH_RETRY_FRAME
retry_pop_stack:
  StgTSO_sp(CurrentTSO) = Sp;
916
  (frame_type) = foreign "C" findRetryFrameHelper(CurrentTSO "ptr") [];
917
918
  Sp = StgTSO_sp(CurrentTSO);
  frame = Sp;
tharris@microsoft.com's avatar
tharris@microsoft.com committed
919
  trec = StgTSO_trec(CurrentTSO);
920
  outer  = StgTRecHeader_enclosing_trec(trec);
921
922
923
924

  if (frame_type == CATCH_RETRY_FRAME) {
    // The retry reaches a CATCH_RETRY_FRAME before the atomic frame
    ASSERT(outer != NO_TREC);
tharris@microsoft.com's avatar
tharris@microsoft.com committed
925
926
927
    // Abort the transaction attempting the current branch
    foreign "C" stmAbortTransaction(MyCapability() "ptr", trec "ptr") [];
    foreign "C" stmFreeAbortedTRec(MyCapability() "ptr", trec "ptr") [];
Simon Marlow's avatar
Simon Marlow committed
928
    if (!StgCatchRetryFrame_running_alt_code(frame) != 0::I32) {
tharris@microsoft.com's avatar
tharris@microsoft.com committed
929
      // Retry in the first branch: try the alternative
930
      ("ptr" trec) = foreign "C" stmStartTransaction(MyCapability() "ptr", outer "ptr") [];
931
      StgTSO_trec(CurrentTSO) = trec;
932
      StgCatchRetryFrame_running_alt_code(frame) = 1 :: CInt; // true;
933
      R1 = StgCatchRetryFrame_alt_code(frame);
934
      jump stg_ap_v_fast;
935
    } else {
tharris@microsoft.com's avatar
tharris@microsoft.com committed
936
937
938
939
      // Retry in the alternative code: propagate the retry
      StgTSO_trec(CurrentTSO) = outer;
      Sp = Sp + SIZEOF_StgCatchRetryFrame;
      goto retry_pop_stack;
940
941
942
943
944
    }
  }

  // We've reached the ATOMICALLY_FRAME: attempt to wait 
  ASSERT(frame_type == ATOMICALLY_FRAME);
tharris@microsoft.com's avatar
tharris@microsoft.com committed
945
946
947
948
949
950
951
  if (outer != NO_TREC) {
    // We called retry while checking invariants, so abort the current
    // invariant check (merging its TVar accesses into the parents read
    // set so we'll wait on them)
    foreign "C" stmAbortTransaction(MyCapability() "ptr", trec "ptr") [];
    foreign "C" stmFreeAbortedTRec(MyCapability() "ptr", trec "ptr") [];
    trec = outer;
952
    StgTSO_trec(CurrentTSO) = trec;
953
    outer  = StgTRecHeader_enclosing_trec(trec);
tharris@microsoft.com's avatar
tharris@microsoft.com committed
954
  }
955
  ASSERT(outer == NO_TREC);
tharris@microsoft.com's avatar
tharris@microsoft.com committed
956

957
  (r) = foreign "C" stmWait(MyCapability() "ptr", CurrentTSO "ptr", trec "ptr") [];
Simon Marlow's avatar
Simon Marlow committed
958
  if (r != 0) {
959
    // Transaction was valid: stmWait put us on the TVars' queues, we now block
960
    StgHeader_info(frame) = stg_atomically_waiting_frame_info;
961
    Sp = frame;
962
    // Fix up the stack in the unregisterised case: the return convention is different.
963
964
    R3 = trec; // passing to stmWaitUnblock()
    jump stg_block_stmwait;
965
966
  } else {
    // Transaction was not valid: retry immediately
967
    ("ptr" trec) = foreign "C" stmStartTransaction(MyCapability() "ptr", outer "ptr") [];
968
969
970
    StgTSO_trec(CurrentTSO) = trec;
    R1 = StgAtomicallyFrame_code(frame);
    Sp = frame;
971
    jump stg_ap_v_fast;
972
973
974
975
  }
}


976
stg_checkzh
tharris@microsoft.com's avatar
tharris@microsoft.com committed
977
978
979
980
{
  W_ trec, closure;

  /* Args: R1 = invariant closure */
981
  MAYBE_GC (R1_PTR, stg_checkzh); 
tharris@microsoft.com's avatar
tharris@microsoft.com committed
982
983
984
985
986
987
988
989
990
991
992

  trec = StgTSO_trec(CurrentTSO);
  closure = R1;
  foreign "C" stmAddInvariantToCheck(MyCapability() "ptr", 
                                     trec "ptr",
                                     closure "ptr") [];

  jump %ENTRY_CODE(Sp(0));
}


993
stg_newTVarzh
994
995
{
  W_ tv;
996
  W_ new_value;
997
998
999

  /* Args: R1 = initialisation value */

1000
  MAYBE_GC (R1_PTR, stg_newTVarzh); 
1001
  new_value = R1;
1002
  ("ptr" tv) = foreign "C" stmNewTVar(MyCapability() "ptr", new_value "ptr") [];
1003
1004
1005
1006
  RET_P(tv);
}


1007
stg_readTVarzh
1008
1009
1010
1011
1012
1013
1014
{
  W_ trec;
  W_ tvar;
  W_ result;

  /* Args: R1 = TVar closure */

1015
  MAYBE_GC (R1_PTR, stg_readTVarzh); // Call to stmReadTVar may allocate
1016
1017
  trec = StgTSO_trec(CurrentTSO);
  tvar = R1;
1018
  ("ptr" result) = foreign "C" stmReadTVar(MyCapability() "ptr", trec "ptr", tvar "ptr") [];
1019
1020
1021
1022

  RET_P(result);
}

1023
stg_readTVarIOzh
1024
1025
1026
1027
1028
1029
1030
1031
1032
1033
{
    W_ result;

again:
    result = StgTVar_current_value(R1);
    if (%INFO_PTR(result) == stg_TREC_HEADER_info) {
        goto again;
    }
    RET_P(result);
}
1034

1035
stg_writeTVarzh
1036
1037
1038
1039
1040
1041
1042
1043
{
  W_ trec;
  W_ tvar;
  W_ new_value;
  
  /* Args: R1 = TVar closure */
  /*       R2 = New value    */

1044
  MAYBE_GC (R1_PTR & R2_PTR, stg_writeTVarzh); // Call to stmWriteTVar may allocate
1045
1046
1047
  trec = StgTSO_trec(CurrentTSO);
  tvar = R1;
  new_value = R2;
1048
  foreign "C" stmWriteTVar(MyCapability() "ptr", trec "ptr", tvar "ptr", new_value "ptr") [];
1049
1050
1051
1052
1053

  jump %ENTRY_CODE(Sp(0));
}


1054
1055
1056
1057
1058
1059
1060
1061
1062
1063
1064
1065
1066
1067
1068
1069
1070
1071
1072
1073
1074
1075
1076
1077
1078
1079
1080
1081
1082
1083
1084
1085
/* -----------------------------------------------------------------------------
 * MVar primitives
 *
 * take & putMVar work as follows.  Firstly, an important invariant:
 *
 *    If the MVar is full, then the blocking queue contains only
 *    threads blocked on putMVar, and if the MVar is empty then the
 *    blocking queue contains only threads blocked on takeMVar.
 *
 * takeMvar:
 *    MVar empty : then add ourselves to the blocking queue
 *    MVar full  : remove the value from the MVar, and
 *                 blocking queue empty     : return
 *                 blocking queue non-empty : perform the first blocked putMVar
 *                                            from the queue, and wake up the
 *                                            thread (MVar is now full again)
 *
 * putMVar is just the dual of the above algorithm.
 *
 * How do we "perform a putMVar"?  Well, we have to fiddle around with
 * the stack of the thread waiting to do the putMVar.  See
 * stg_block_putmvar and stg_block_takemvar in HeapStackCheck.c for
 * the stack layout, and the PerformPut and PerformTake macros below.
 *
 * It is important that a blocked take or put is woken up with the
 * take/put already performed, because otherwise there would be a
 * small window of vulnerability where the thread could receive an
 * exception and never perform its take or put, and we'd end up with a
 * deadlock.
 *
 * -------------------------------------------------------------------------- */

1086
stg_isEmptyMVarzh
1087
1088
1089
{
    /* args: R1 = MVar closure */

1090
    if (StgMVar_value(R1) == stg_END_TSO_QUEUE_closure) {
1091
	RET_N(1);
1092
1093
    } else {
	RET_N(0);
1094
1095
1096
    }
}

1097
stg_newMVarzh
1098
1099
1100
1101
{
    /* args: none */
    W_ mvar;

1102
    ALLOC_PRIM ( SIZEOF_StgMVar, NO_PTRS, stg_newMVarzh );
1103
1104
  
    mvar = Hp - SIZEOF_StgMVar + WDS(1);
1105
1106
    SET_HDR(mvar,stg_MVAR_DIRTY_info,W_[CCCS]);
        // MVARs start dirty: generation 0 has no mutable list
1107
1108
1109
1110
1111
1112
1113
1114
1115
1116
1117
1118
1119
1120
1121
    StgMVar_head(mvar)  = stg_END_TSO_QUEUE_closure;
    StgMVar_tail(mvar)  = stg_END_TSO_QUEUE_closure;
    StgMVar_value(mvar) = stg_END_TSO_QUEUE_closure;
    RET_P(mvar);
}


#define PerformTake(tso, value)				\
    W_[StgTSO_sp(tso) + WDS(1)] = value;		\
    W_[StgTSO_sp(tso) + WDS(0)] = stg_gc_unpt_r1_info;

#define PerformPut(tso,lval)			\
    StgTSO_sp(tso) = StgTSO_sp(tso) + WDS(3);	\
    lval = W_[StgTSO_sp(tso) - WDS(1)];

1122
stg_takeMVarzh
1123
1124
1125
1126
1127
1128
{
    W_ mvar, val, info, tso;

    /* args: R1 = MVar closure */
    mvar = R1;

1129
#if defined(THREADED_RTS)
1130
    ("ptr" info) = foreign "C" lockClosure(mvar "ptr") [];
1131
#else
1132
    info = GET_INFO(mvar);
1133
#endif
1134
1135
        
    if (info == stg_MVAR_CLEAN_info) {
1136
        foreign "C" dirty_MVAR(BaseReg "ptr", mvar "ptr") [];
1137
    }
1138
1139
1140
1141

    /* If the MVar is empty, put ourselves on its blocking queue,
     * and wait until we're woken up.
     */
1142
    if (StgMVar_value(mvar) == stg_END_TSO_QUEUE_closure) {
1143
1144
1145
	if (StgMVar_head(mvar) == stg_END_TSO_QUEUE_closure) {
	    StgMVar_head(mvar) = CurrentTSO;
	} else {
1146
1147
1148
            foreign "C" setTSOLink(MyCapability() "ptr", 
                                   StgMVar_tail(mvar) "ptr",
                                   CurrentTSO) [];
1149
	}
1150
	StgTSO__link(CurrentTSO)       = stg_END_TSO_QUEUE_closure;
1151
	StgTSO_block_info(CurrentTSO)  = mvar;
1152
1153
1154
1155
        // write barrier for throwTo(), which looks at block_info
        // if why_blocked==BlockedOnMVar.
        prim %write_barrier() [];
	StgTSO_why_blocked(CurrentTSO) = BlockedOnMVar::I16;
1156
1157
	StgMVar_tail(mvar) = CurrentTSO;
	
1158
        R1 = mvar;
1159
1160
1161
1162
1163
1164
1165
1166
1167
1168
1169
1170
1171
1172
1173
1174
	jump stg_block_takemvar;
  }

  /* we got the value... */
  val = StgMVar_value(mvar);

  if (StgMVar_head(mvar) != stg_END_TSO_QUEUE_closure)
  {
      /* There are putMVar(s) waiting... 
       * wake up the first thread on the queue
       */
      ASSERT(StgTSO_why_blocked(StgMVar_head(mvar)) == BlockedOnMVar::I16);

      /* actually perform the putMVar for the thread that we just woke up */
      tso = StgMVar_head(mvar);
      PerformPut(tso,StgMVar_value(mvar));
1175

1176
      if (TO_W_(StgTSO_dirty(tso)) == 0) {
1177
          foreign "C" dirty_TSO(MyCapability() "ptr", tso "ptr") [];
1178
      }
1179

1180
1181
      ("ptr" tso) = foreign "C" unblockOne_(MyCapability() "ptr", 
                                            StgMVar_head(mvar) "ptr", 1) [];
1182
      StgMVar_head(mvar) = tso;
1183

1184
1185
1186
      if (StgMVar_head(mvar) == stg_END_TSO_QUEUE_closure) {
	  StgMVar_tail(mvar) = stg_END_TSO_QUEUE_closure;
      }
1187

1188
#if defined(THREADED_RTS)