ghc/includes/StgMacros.h

   1 /* -----------------------------------------------------------------------------
   2  * $Id: StgMacros.h,v 1.15 1999/11/02 17:04:28 simonmar Exp $
   3  *
   4  * (c) The GHC Team, 1998-1999
   5  *
   6  * Macros used for writing STG-ish C code.
   7  *
   8  * ---------------------------------------------------------------------------*/
   9
  10 #ifndef STGMACROS_H
  11 #define STGMACROS_H
  12
  13 /* -----------------------------------------------------------------------------
  14   The following macros create function headers.
  15
  16   Each basic block is represented by a C function with no arguments.
  17   We therefore always begin with either
  18
  19   extern F_ f(void)
  20
  21   or
  22
  23   static F_ f(void)
  24
  25   The macros can be used either to define the function itself, or to provide
  26   prototypes (by following with a ';').
  27
  28   Note: the various I*_ shorthands in the second block below are used to
  29   declare forward references to local symbols. These shorthands *have* to
  30   use the 'extern' type specifier and not 'static'. The reason for this is
  31   that 'static' declares a reference as being a static/local variable,
  32   and *not* as a forward reference to a static variable.
  33
  34   This might seem obvious, but it had me stumped as to why my info tables
  35   were suddenly all filled with 0s.
  36
  37     -- sof 1/99
  38
  39   --------------------------------------------------------------------------- */
  40
  41 #define STGFUN(f)       StgFunPtr f(void)
  42 #define EXTFUN(f)       extern StgFunPtr f(void)
  43 #define EXTFUN_RTS(f)   extern DLL_IMPORT_RTS StgFunPtr f(void)
  44 #define FN_(f)          F_ f(void)
  45 #define IFN_(f)         static F_ f(void)
  46 #define IF_(f)          static F_ f(void)
  47 #define EF_(f)          extern F_ f(void)
  48 #define EDF_(f)         extern DLLIMPORT F_ f(void)
  49
  50 #define ED_             extern
  51 #define EDD_            extern DLLIMPORT
  52 #define ED_RO_          extern const
  53 #define ID_             extern
  54 #define ID_RO_          extern const
  55 #define EI_             extern INFO_TBL_CONST StgInfoTable
  56 #define EDI_            extern DLLIMPORT INFO_TBL_CONST StgInfoTable
  57 #define II_             extern INFO_TBL_CONST StgInfoTable
  58 #define EC_             extern StgClosure
  59 #define EDC_            extern DLLIMPORT StgClosure
  60 #define IC_             extern StgClosure
  61 #define ECP_(x)         extern const StgClosure *(x)[]
  62 #define EDCP_(x)        extern DLLIMPORT StgClosure *(x)[]
  63 #define ICP_(x)         extern const StgClosure *(x)[]
  64
  65 /* -----------------------------------------------------------------------------
  66    Stack Tagging.
  67
  68    For a  block of non-pointer words on the stack, we precede the
  69    block with a small-integer tag giving the number of non-pointer
  70    words in the block.
  71    -------------------------------------------------------------------------- */
  72
  73 #ifndef DEBUG_EXTRA
  74 #define ARGTAG_MAX 16           /* probably arbitrary */
  75 #define ARG_TAG(n)  (n)
  76 #define ARG_SIZE(n) stgCast(StgWord,n)
  77
  78 typedef enum {
  79     REALWORLD_TAG = 0,
  80     INT_TAG    = sizeofW(StgInt),
  81     INT64_TAG  = sizeofW(StgInt64),
  82     WORD_TAG   = sizeofW(StgWord),
  83     ADDR_TAG   = sizeofW(StgAddr),
  84     CHAR_TAG   = sizeofW(StgChar),
  85     FLOAT_TAG  = sizeofW(StgFloat),
  86     DOUBLE_TAG = sizeofW(StgDouble),
  87     STABLE_TAG = sizeofW(StgWord),
  88 } StackTag;
  89
  90 #else /* DEBUG_EXTRA */
  91
  92 typedef enum {
  93     ILLEGAL_TAG,
  94     REALWORLD_TAG,
  95     INT_TAG    ,
  96     INT64_TAG  ,
  97     WORD_TAG   ,
  98     ADDR_TAG   ,
  99     CHAR_TAG   ,
 100     FLOAT_TAG  ,
 101     DOUBLE_TAG ,
 102     STABLE_TAG ,
 103     ARGTAG_MAX = DOUBLE_TAG
 104 } StackTag;
 105
 106 /* putting this in a .h file generates many copies - but its only a
 107  * debugging build.
 108  */
 109 static StgWord stg_arg_size[] = {
 110     [REALWORLD_TAG] = 0,
 111     [INT_TAG   ] = sizeofW(StgInt),
 112     [INT64_TAG ] = sizeofW(StgInt64),
 113     [WORD_TAG  ] = sizeofW(StgWord),
 114     [ADDR_TAG  ] = sizeofW(StgAddr),
 115     [CHAR_TAG  ] = sizeofW(StgChar),
 116     [FLOAT_TAG ] = sizeofW(StgFloat),
 117     [DOUBLE_TAG] = sizeofW(StgDouble),
 118     [STABLE_TAG] = sizeofW(StgWord)
 119 };
 120
 121 #define ARG_SIZE(tag) stg_arg_size[stgCast(StgWord,tag)]
 122
 123 #endif /* DEBUG_EXTRA */
 124
 125 static inline int IS_ARG_TAG( StgWord p );
 126 static inline int IS_ARG_TAG( StgWord p ) { return p <= ARGTAG_MAX; }
 127
 128 /* -----------------------------------------------------------------------------
 129    Argument checks.
 130
 131    If (Sp + <n_args>) > Su { JMP_(stg_update_PAP); }
 132
 133    Sp points to the topmost used word on the stack, and Su points to
 134    the most recently pushed update frame.
 135
 136    Remember that <n_args> must include any tagging of unboxed values.
 137
 138    ARGS_CHK_LOAD_NODE is for top-level functions, whose entry
 139    convention doesn't require that Node is loaded with a pointer to
 140    the closure.  Thus we must load node before calling stg_updatePAP if
 141    the argument check fails.
 142    -------------------------------------------------------------------------- */
 143
 144 #define ARGS_CHK(n)                             \
 145         if ((P_)(Sp + (n)) > (P_)Su) {          \
 146                 JMP_(stg_update_PAP);           \
 147         }
 148
 149 #define ARGS_CHK_LOAD_NODE(n,closure)           \
 150         if ((P_)(Sp + (n)) > (P_)Su) {          \
 151                 R1.p = (P_)closure;             \
 152                 JMP_(stg_update_PAP);           \
 153         }
 154
 155 /* -----------------------------------------------------------------------------
 156    Heap/Stack Checks.
 157
 158    When failing a check, we save a return address on the stack and
 159    jump to a pre-compiled code fragment that saves the live registers
 160    and returns to the scheduler.
 161
 162    The return address in most cases will be the beginning of the basic
 163    block in which the check resides, since we need to perform the check
 164    again on re-entry because someone else might have stolen the resource
 165    in the meantime.
 166    ------------------------------------------------------------------------- */
 167
 168 #define STK_CHK(headroom,ret,r,layout,tag_assts)                \
 169         if (Sp - headroom < SpLim) {                            \
 170             EXTFUN_RTS(stg_chk_##layout);                       \
 171             tag_assts                                           \
 172             (r) = (P_)ret;                                      \
 173             JMP_(stg_chk_##layout);                             \
 174         }
 175
 176 #define HP_CHK(headroom,ret,r,layout,tag_assts)                 \
 177         if ((Hp += headroom) > HpLim) {                         \
 178             EXTFUN_RTS(stg_chk_##layout);                       \
 179             tag_assts                                           \
 180             (r) = (P_)ret;                                      \
 181             JMP_(stg_chk_##layout);                             \
 182         }
 183
 184 #define HP_STK_CHK(stk_headroom,hp_headroom,ret,r,layout,tag_assts) \
 185         if (Sp - stk_headroom < SpLim || (Hp += hp_headroom) > HpLim) { \
 186             EXTFUN_RTS(stg_chk_##layout);                       \
 187             tag_assts                                           \
 188             (r) = (P_)ret;                                      \
 189             JMP_(stg_chk_##layout);                             \
 190         }
 191
 192 /* -----------------------------------------------------------------------------
 193    A Heap Check in a case alternative are much simpler: everything is
 194    on the stack and covered by a liveness mask already, and there is
 195    even a return address with an SRT info table there as well.
 196
 197    Just push R1 and return to the scheduler saying 'EnterGHC'
 198
 199    {STK,HP,HP_STK}_CHK_NP are the various checking macros for
 200    bog-standard case alternatives, thunks, and non-top-level
 201    functions.  In all these cases, node points to a closure that we
 202    can just enter to restart the heap check (the NP stands for 'node points').
 203
 204    HpLim points to the LAST WORD of valid allocation space.
 205    -------------------------------------------------------------------------- */
 206
 207 #define STK_CHK_NP(headroom,ptrs,tag_assts)                     \
 208         if ((Sp - (headroom)) < SpLim) {                        \
 209             EXTFUN_RTS(stg_gc_enter_##ptrs);                    \
 210             tag_assts                                           \
 211             JMP_(stg_gc_enter_##ptrs);                          \
 212         }
 213
 214 #define HP_CHK_NP(headroom,ptrs,tag_assts)                      \
 215         if ((Hp += (headroom)) > HpLim) {                       \
 216             EXTFUN_RTS(stg_gc_enter_##ptrs);                    \
 217             tag_assts                                           \
 218             JMP_(stg_gc_enter_##ptrs);                          \
 219         }
 220
 221 #define HP_CHK_SEQ_NP(headroom,ptrs,tag_assts)                  \
 222         if ((Hp += (headroom)) > HpLim) {                       \
 223             EXTFUN_RTS(stg_gc_seq_##ptrs);                      \
 224             tag_assts                                           \
 225             JMP_(stg_gc_seq_##ptrs);                            \
 226         }
 227
 228 #define HP_STK_CHK_NP(stk_headroom, hp_headroom, ptrs, tag_assts) \
 229         if ((Sp - (stk_headroom)) < SpLim || (Hp += (hp_headroom)) > HpLim) { \
 230             EXTFUN_RTS(stg_gc_enter_##ptrs);                    \
 231             tag_assts                                           \
 232             JMP_(stg_gc_enter_##ptrs);                          \
 233         }
 234
 235
 236 /* Heap checks for branches of a primitive case / unboxed tuple return */
 237
 238 #define GEN_HP_CHK_ALT(headroom,lbl,tag_assts)                  \
 239         if ((Hp += (headroom)) > HpLim) {                       \
 240             EXTFUN_RTS(lbl);                                    \
 241             tag_assts                                           \
 242             JMP_(lbl);                                          \
 243         }
 244
 245 #define HP_CHK_NOREGS(headroom,tag_assts) \
 246     GEN_HP_CHK_ALT(headroom,stg_gc_noregs,tag_assts);
 247 #define HP_CHK_UNPT_R1(headroom,tag_assts)  \
 248     GEN_HP_CHK_ALT(headroom,stg_gc_unpt_r1,tag_assts);
 249 #define HP_CHK_UNBX_R1(headroom,tag_assts)  \
 250     GEN_HP_CHK_ALT(headroom,stg_gc_unbx_r1,tag_assts);
 251 #define HP_CHK_F1(headroom,tag_assts)       \
 252     GEN_HP_CHK_ALT(headroom,stg_gc_f1,tag_assts);
 253 #define HP_CHK_D1(headroom,tag_assts)       \
 254     GEN_HP_CHK_ALT(headroom,stg_gc_d1,tag_assts);
 255
 256 #define HP_CHK_L1(headroom,tag_assts)       \
 257     GEN_HP_CHK_ALT(headroom,stg_gc_d1,tag_assts);
 258
 259 #define HP_CHK_UT_ALT(headroom, ptrs, nptrs, r, ret, tag_assts) \
 260     GEN_HP_CHK_ALT(headroom, stg_gc_ut_##ptrs##_##nptrs, \
 261                      tag_assts r = (P_)ret;)
 262
 263 /* -----------------------------------------------------------------------------
 264    Generic Heap checks.
 265
 266    These are slow, but have the advantage of being usable in a variety
 267    of situations.
 268
 269    The one restriction is that any relevant SRTs must already be pointed
 270    to from the stack.  The return address doesn't need to have an info
 271    table attached: hence it can be any old code pointer.
 272
 273    The liveness mask is a logical 'XOR' of NO_PTRS and zero or more
 274    Rn_PTR constants defined below.  All registers will be saved, but
 275    the garbage collector needs to know which ones contain pointers.
 276
 277    Good places to use a generic heap check:
 278
 279         - case alternatives (the return address with an SRT is already
 280           on the stack).
 281
 282         - primitives (no SRT required).
 283
 284    The stack layout is like this:
 285
 286           DblReg1-2
 287           FltReg1-4
 288           R1-8
 289           return address
 290           liveness mask
 291           stg_gen_chk_info
 292
 293    so the liveness mask depends on the size of an StgDouble (FltRegs
 294    and R<n> are guaranteed to be 1 word in size).
 295
 296    -------------------------------------------------------------------------- */
 297
 298 /* VERY MAGIC CONSTANTS!
 299  * must agree with code in HeapStackCheck.c, stg_gen_chk
 300  */
 301
 302 #if SIZEOF_DOUBLE > SIZEOF_VOID_P
 303 #define ALL_NON_PTRS   0xffff
 304 #else /* SIZEOF_DOUBLE == SIZEOF_VOID_P */
 305 #define ALL_NON_PTRS   0x3fff
 306 #endif
 307
 308 #define LIVENESS_MASK(ptr_regs)  (ALL_NON_PTRS ^ (ptr_regs))
 309
 310 #define NO_PTRS   0
 311 #define R1_PTR    1<<0
 312 #define R2_PTR    1<<1
 313 #define R3_PTR    1<<2
 314 #define R4_PTR    1<<3
 315 #define R5_PTR    1<<4
 316 #define R6_PTR    1<<5
 317 #define R7_PTR    1<<6
 318 #define R8_PTR    1<<7
 319
 320 #define HP_CHK_GEN(headroom,liveness,reentry,tag_assts) \
 321    if ((Hp += (headroom)) > HpLim ) {                   \
 322         EF_(stg_gen_chk);                               \
 323         tag_assts                                       \
 324         R9.w = (W_)LIVENESS_MASK(liveness);             \
 325         R10.w = (W_)reentry;                            \
 326         JMP_(stg_gen_chk);                              \
 327    }
 328
 329 #define HP_CHK_GEN_TICKY(headroom,liveness,reentry,tag_assts)   \
 330    HP_CHK_GEN(headroom,liveness,reentry,tag_assts);             \
 331    TICK_ALLOC_HEAP_NOCTR(headroom)
 332
 333 #define STK_CHK_GEN(headroom,liveness,reentry,tag_assts)        \
 334    if ((Sp - (headroom)) < SpLim) {                             \
 335         EF_(stg_gen_chk);                                       \
 336         tag_assts                                               \
 337         R9.w = (W_)LIVENESS_MASK(liveness);                     \
 338         R10.w = (W_)reentry;                                    \
 339         JMP_(stg_gen_chk);                                      \
 340    }
 341
 342 #define MAYBE_GC(liveness,reentry)              \
 343    if (doYouWantToGC()) {                       \
 344         EF_(stg_gen_hp);                        \
 345         R9.w = (W_)LIVENESS_MASK(liveness);     \
 346         R10.w = (W_)reentry;                    \
 347         JMP_(stg_gen_hp);                       \
 348    }
 349
 350 /* -----------------------------------------------------------------------------
 351    Voluntary Yields/Blocks
 352
 353    We only have a generic version of this at the moment - if it turns
 354    out to be slowing us down we can make specialised ones.
 355    -------------------------------------------------------------------------- */
 356
 357 EF_(stg_gen_yield);
 358 EF_(stg_gen_block);
 359
 360 #define YIELD(liveness,reentry)                 \
 361   {                                             \
 362    R9.w  = (W_)LIVENESS_MASK(liveness);         \
 363    R10.w = (W_)reentry;                         \
 364    JMP_(stg_gen_yield);                         \
 365   }
 366
 367 #define BLOCK(liveness,reentry)                 \
 368   {                                             \
 369    R9.w  = (W_)LIVENESS_MASK(liveness);         \
 370    R10.w = (W_)reentry;                         \
 371    JMP_(stg_gen_block);                         \
 372   }
 373
 374 #define BLOCK_NP(ptrs)                          \
 375   {                                             \
 376     EF_(stg_block_##ptrs);                      \
 377     JMP_(stg_block_##ptrs);                     \
 378   }
 379
 380 /* -----------------------------------------------------------------------------
 381    CCall_GC needs to push a dummy stack frame containing the contents
 382    of volatile registers and variables.
 383
 384    We use a RET_DYN frame the same as for a dynamic heap check.
 385    ------------------------------------------------------------------------- */
 386
 387 #if COMPILING_RTS
 388 EI_(stg_gen_chk_info);
 389 #else
 390 EDI_(stg_gen_chk_info);
 391 #endif
 392 /* -----------------------------------------------------------------------------
 393    Vectored Returns
 394
 395    RETVEC(p,t) where 'p' is a pointer to the info table for a
 396    vectored return address, returns the address of the return code for
 397    tag 't'.
 398
 399    Return vectors are placed in *reverse order* immediately before the info
 400    table for the return address.  Hence the formula for computing the
 401    actual return address is (addr - sizeof(InfoTable) - tag - 1).
 402    The extra subtraction of one word is because tags start at zero.
 403    -------------------------------------------------------------------------- */
 404
 405 #ifdef TABLES_NEXT_TO_CODE
 406 #define RET_VEC(p,t) (*((P_)(p) - sizeofW(StgInfoTable) - t - 1))
 407 #else
 408 #define RET_VEC(p,t) (((StgInfoTable *)p)->vector[t])
 409 #endif
 410
 411 /* -----------------------------------------------------------------------------
 412    Misc
 413    -------------------------------------------------------------------------- */
 414
 415 /* set the tag register (if we have one) */
 416 #define SET_TAG(t)  /* nothing */
 417
 418 #ifdef EAGER_BLACKHOLING
 419 #  ifdef SMP
 420 #    define UPD_BH_UPDATABLE(info)              \
 421         TICK_UPD_BH_UPDATABLE();                \
 422         LOCK_THUNK(info);                       \
 423         SET_INFO(R1.cl,&BLACKHOLE_info)
 424 #    define UPD_BH_SINGLE_ENTRY(info)           \
 425         TICK_UPD_BH_SINGLE_ENTRY();             \
 426         LOCK_THUNK(info);                       \
 427         SET_INFO(R1.cl,&BLACKHOLE_info)
 428 #  else
 429 #    define UPD_BH_UPDATABLE(info)              \
 430         TICK_UPD_BH_UPDATABLE();                \
 431         SET_INFO(R1.cl,&BLACKHOLE_info)
 432 #    define UPD_BH_SINGLE_ENTRY(info)           \
 433         TICK_UPD_BH_SINGLE_ENTRY();             \
 434         SET_INFO(R1.cl,&SE_BLACKHOLE_info)
 435 #  endif
 436 #else /* !EAGER_BLACKHOLING */
 437 #  define UPD_BH_UPDATABLE(thunk)    /* nothing */
 438 #  define UPD_BH_SINGLE_ENTRY(thunk) /* nothing */
 439 #endif /* EAGER_BLACKHOLING */
 440
 441 #define UPD_FRAME_UPDATEE(p)  (((StgUpdateFrame *)(p))->updatee)
 442 #define UPDATE_SU_FROM_UPD_FRAME(p) (Su=((StgUpdateFrame *)(p))->link)
 443
 444 /* -----------------------------------------------------------------------------
 445    Moving Floats and Doubles
 446
 447    ASSIGN_FLT is for assigning a float to memory (usually the
 448               stack/heap).  The memory address is guaranteed to be
 449               StgWord aligned (currently == sizeof(long)).
 450
 451    PK_FLT     is for pulling a float out of memory.  The memory is
 452               guaranteed to be StgWord aligned.
 453    -------------------------------------------------------------------------- */
 454
 455 static inline void        ASSIGN_FLT (W_ [], StgFloat);
 456 static inline StgFloat    PK_FLT     (W_ []);
 457
 458 #if ALIGNMENT_FLOAT <= ALIGNMENT_LONG
 459
 460 static inline void     ASSIGN_FLT(W_ p_dest[], StgFloat src) { *(StgFloat *)p_dest = src; }
 461 static inline StgFloat PK_FLT    (W_ p_src[])                { return *(StgFloat *)p_src; }
 462
 463 #else  /* ALIGNMENT_FLOAT > ALIGNMENT_UNSIGNED_INT */
 464
 465 static inline void ASSIGN_FLT(W_ p_dest[], StgFloat src)
 466 {
 467     float_thing y;
 468     y.f = src;
 469     *p_dest = y.fu;
 470 }
 471
 472 static inline StgFloat PK_FLT(W_ p_src[])
 473 {
 474     float_thing y;
 475     y.fu = *p_src;
 476     return(y.f);
 477 }
 478
 479 #endif /* ALIGNMENT_FLOAT > ALIGNMENT_LONG */
 480
 481 #if ALIGNMENT_DOUBLE <= ALIGNMENT_LONG
 482
 483 static inline void        ASSIGN_DBL (W_ [], StgDouble);
 484 static inline StgDouble   PK_DBL     (W_ []);
 485
 486 static inline void      ASSIGN_DBL(W_ p_dest[], StgDouble src) { *(StgDouble *)p_dest = src; }
 487 static inline StgDouble PK_DBL    (W_ p_src[])                 { return *(StgDouble *)p_src; }
 488
 489 #else   /* ALIGNMENT_DOUBLE > ALIGNMENT_LONG */
 490
 491 /* Sparc uses two floating point registers to hold a double.  We can
 492  * write ASSIGN_DBL and PK_DBL by directly accessing the registers
 493  * independently - unfortunately this code isn't writable in C, we
 494  * have to use inline assembler.
 495  */
 496 #if sparc_TARGET_ARCH
 497
 498 #define ASSIGN_DBL(dst0,src) \
 499     { StgPtr dst = (StgPtr)(dst0); \
 500       __asm__("st %2,%0\n\tst %R2,%1" : "=m" (((P_)(dst))[0]), \
 501         "=m" (((P_)(dst))[1]) : "f" (src)); \
 502     }
 503
 504 #define PK_DBL(src0) \
 505     ( { StgPtr src = (StgPtr)(src0); \
 506         register double d; \
 507       __asm__("ld %1,%0\n\tld %2,%R0" : "=f" (d) : \
 508         "m" (((P_)(src))[0]), "m" (((P_)(src))[1])); d; \
 509     } )
 510
 511 #else /* ! sparc_TARGET_ARCH */
 512
 513 static inline void        ASSIGN_DBL (W_ [], StgDouble);
 514 static inline StgDouble   PK_DBL     (W_ []);
 515
 516 typedef struct
 517   { StgWord dhi;
 518     StgWord dlo;
 519   } unpacked_double;
 520
 521 typedef union
 522   { StgDouble d;
 523     unpacked_double du;
 524   } double_thing;
 525
 526 static inline void ASSIGN_DBL(W_ p_dest[], StgDouble src)
 527 {
 528     double_thing y;
 529     y.d = src;
 530     p_dest[0] = y.du.dhi;
 531     p_dest[1] = y.du.dlo;
 532 }
 533
 534 /* GCC also works with this version, but it generates
 535    the same code as the previous one, and is not ANSI
 536
 537 #define ASSIGN_DBL( p_dest, src ) \
 538         *p_dest = ((double_thing) src).du.dhi; \
 539         *(p_dest+1) = ((double_thing) src).du.dlo \
 540 */
 541
 542 static inline StgDouble PK_DBL(W_ p_src[])
 543 {
 544     double_thing y;
 545     y.du.dhi = p_src[0];
 546     y.du.dlo = p_src[1];
 547     return(y.d);
 548 }
 549
 550 #endif /* ! sparc_TARGET_ARCH */
 551
 552 #endif /* ALIGNMENT_DOUBLE > ALIGNMENT_UNSIGNED_INT */
 553
 554 #ifdef SUPPORT_LONG_LONGS
 555
 556 typedef struct
 557   { StgWord dhi;
 558     StgWord dlo;
 559   } unpacked_double_word;
 560
 561 typedef union
 562   { StgInt64 i;
 563     unpacked_double_word iu;
 564   } int64_thing;
 565
 566 typedef union
 567   { StgWord64 w;
 568     unpacked_double_word wu;
 569   } word64_thing;
 570
 571 static inline void ASSIGN_Word64(W_ p_dest[], StgWord64 src)
 572 {
 573     word64_thing y;
 574     y.w = src;
 575     p_dest[0] = y.wu.dhi;
 576     p_dest[1] = y.wu.dlo;
 577 }
 578
 579 static inline StgWord64 PK_Word64(W_ p_src[])
 580 {
 581     word64_thing y;
 582     y.wu.dhi = p_src[0];
 583     y.wu.dlo = p_src[1];
 584     return(y.w);
 585 }
 586
 587 static inline void ASSIGN_Int64(W_ p_dest[], StgInt64 src)
 588 {
 589     int64_thing y;
 590     y.i = src;
 591     p_dest[0] = y.iu.dhi;
 592     p_dest[1] = y.iu.dlo;
 593 }
 594
 595 static inline StgInt64 PK_Int64(W_ p_src[])
 596 {
 597     int64_thing y;
 598     y.iu.dhi = p_src[0];
 599     y.iu.dlo = p_src[1];
 600     return(y.i);
 601 }
 602 #endif
 603
 604 /* -----------------------------------------------------------------------------
 605    Catch frames
 606    -------------------------------------------------------------------------- */
 607
 608 extern DLL_IMPORT_DATA const StgPolyInfoTable catch_frame_info;
 609
 610 /* -----------------------------------------------------------------------------
 611    Seq frames
 612
 613    A seq frame is very like an update frame, except that it doesn't do
 614    an update...
 615    -------------------------------------------------------------------------- */
 616
 617 extern DLL_IMPORT_DATA const StgPolyInfoTable seq_frame_info;
 618
 619 #define PUSH_SEQ_FRAME(sp)                                      \
 620         {                                                       \
 621                 StgSeqFrame *__frame;                           \
 622                 TICK_SEQF_PUSHED();                             \
 623                 __frame = (StgSeqFrame *)(sp);                  \
 624                 SET_HDR_(__frame,&seq_frame_info,CCCS);         \
 625                 __frame->link = Su;                             \
 626                 Su = (StgUpdateFrame *)__frame;                 \
 627         }
 628
 629 /* -----------------------------------------------------------------------------
 630    Split markers
 631    -------------------------------------------------------------------------- */
 632
 633 #if defined(USE_SPLIT_MARKERS)
 634 #define __STG_SPLIT_MARKER(n) FN_(__stg_split_marker##n) { }
 635 #else
 636 #define __STG_SPLIT_MARKER(n) /* nothing */
 637 #endif
 638
 639 /* -----------------------------------------------------------------------------
 640    Closure and Info Macros with casting.
 641
 642    We don't want to mess around with casts in the generated C code, so
 643    we use these casting versions of the closure/info tables macros.
 644    -------------------------------------------------------------------------- */
 645
 646 #define SET_HDR_(c,info,ccs) \
 647    SET_HDR((StgClosure *)(c),(StgInfoTable *)(info),ccs)
 648
 649 /* -----------------------------------------------------------------------------
 650    Saving context for exit from the STG world, and loading up context
 651    on entry to STG code.
 652
 653    We save all the STG registers (that is, the ones that are mapped to
 654    machine registers) in their places in the TSO.
 655
 656    The stack registers go into the current stack object, and the
 657    current nursery is updated from the heap pointer.
 658
 659    These functions assume that BaseReg is loaded appropriately (if
 660    we have one).
 661    -------------------------------------------------------------------------- */
 662
 663 #ifndef NO_REGS
 664
 665 static __inline__ void
 666 SaveThreadState(void)
 667 {
 668   /* Don't need to save REG_Base, it won't have changed. */
 669
 670   CurrentTSO->sp       = Sp;
 671   CurrentTSO->su       = Su;
 672   CurrentTSO->splim    = SpLim;
 673   CloseNursery(Hp);
 674
 675 #ifdef REG_CurrentTSO
 676   SAVE_CurrentTSO = CurrentTSO;
 677 #endif
 678 #ifdef REG_CurrentNursery
 679   SAVE_CurrentNursery = CurrentNursery;
 680 #endif
 681 #if defined(PROFILING)
 682   CurrentTSO->prof.CCCS = CCCS;
 683 #endif
 684 }
 685
 686 static __inline__ void
 687 LoadThreadState (void)
 688 {
 689   Sp    = CurrentTSO->sp;
 690   Su    = CurrentTSO->su;
 691   SpLim = CurrentTSO->splim;
 692   OpenNursery(Hp,HpLim);
 693
 694 #ifdef REG_CurrentTSO
 695   CurrentTSO = SAVE_CurrentTSO;
 696 #endif
 697 #ifdef REG_CurrentNursery
 698   CurrentNursery = SAVE_CurrentNursery;
 699 #endif
 700 # if defined(PROFILING)
 701   CCCS = CurrentTSO->prof.CCCS;
 702 # endif
 703 }
 704
 705 #endif /* NO_REGS */
 706
 707 /*
 708  * Suspending/resuming threads for doing external C-calls (_ccall_GC).
 709  * These functions are defined in rts/Schedule.c.
 710  */
 711 StgInt        suspendThread ( StgRegTable *cap );
 712 StgRegTable * resumeThread  ( StgInt );
 713
 714 #endif /* STGMACROS_H */
 715