/* ----------------------------------------------------------------------------
- * $Id: Closures.h,v 1.34 2003/11/14 09:27:00 stolz Exp $
+ * $Id: Closures.h,v 1.35 2003/11/14 14:28:07 stolz Exp $
*
* (c) The GHC Team, 1998-1999
*
typedef struct {
CostCentreStack *ccs;
union {
- struct _RetainerSet *rs; /* Retainer Set */
- StgWord ldvw; /* Lag/Drag/Void Word */
+ struct _RetainerSet *rs; // Retainer Set
+ StgWord ldvw; // Lag/Drag/Void Word
} hp;
} StgProfHeader;
StgClosure *payload[FLEXIBLE_ARRAY];
} StgPAP;
-/* AP closures have the same layout, for convenience */
+// AP closures have the same layout, for convenience
typedef StgPAP StgAP;
typedef struct {
StgHeader header;
- StgWord size; /* number of words in payload */
+ StgWord size; // number of words in payload
StgClosure *fun;
- StgClosure *payload[FLEXIBLE_ARRAY]; /* contains a chunk of *stack* */
+ StgClosure *payload[FLEXIBLE_ARRAY]; // contains a chunk of *stack*
} StgAP_STACK;
typedef struct {
typedef struct {
StgHeader header;
- StgArrWords *instrs; /* a pointer to an ArrWords */
- StgArrWords *literals; /* a pointer to an ArrWords */
- StgMutArrPtrs *ptrs; /* a pointer to a MutArrPtrs */
- StgArrWords *itbls; /* a pointer to an ArrWords */
- StgHalfWord arity; /* arity of this BCO */
- StgHalfWord size; /* size of this BCO (in words) */
- StgWord bitmap[FLEXIBLE_ARRAY]; /* an StgLargeBitmap */
+ StgArrWords *instrs; // a pointer to an ArrWords
+ StgArrWords *literals; // a pointer to an ArrWords
+ StgMutArrPtrs *ptrs; // a pointer to a MutArrPtrs
+ StgArrWords *itbls; // a pointer to an ArrWords
+ StgHalfWord arity; // arity of this BCO
+ StgHalfWord size; // size of this BCO (in words)
+ StgWord bitmap[FLEXIBLE_ARRAY]; // an StgLargeBitmap
} StgBCO;
#define BCO_BITMAP(bco) ((StgLargeBitmap *)((StgBCO *)(bco))->bitmap)
/* ----------------------------------------------------------------------------
- * $Id: InfoTables.h,v 1.31 2003/11/14 09:27:00 stolz Exp $
+ * $Id: InfoTables.h,v 1.32 2003/11/14 14:28:08 stolz Exp $
*
* (c) The GHC Team, 1998-2002
*
the layout of a PAP to the GC).
-------------------------------------------------------------------------- */
-/*
- Small bitmaps: for a small bitmap, we store the size and bitmap in
- the same word, using the following macros. If the bitmap doesn't
- fit in a single word, we use a pointer to an StgLargeBitmap below.
-*/
+//
+// Small bitmaps: for a small bitmap, we store the size and bitmap in
+// the same word, using the following macros. If the bitmap doesn't
+// fit in a single word, we use a pointer to an StgLargeBitmap below.
+//
#define MK_SMALL_BITMAP(size,bits) (((bits)<<BITMAP_BITS_SHIFT) | (size))
#define BITMAP_SIZE(bitmap) ((bitmap) & BITMAP_SIZE_MASK)
#define BITMAP_BITS(bitmap) ((bitmap) >> BITMAP_BITS_SHIFT)
-/*
- A large bitmap.
-*/
+//
+// A large bitmap.
+//
typedef struct {
StgWord size;
StgWord bitmap[FLEXIBLE_ARRAY];
garbage-collect CAFs.
-------------------------------------------------------------------------- */
-/* An SRT is just an array of closure pointers: */
+// An SRT is just an array of closure pointers:
typedef StgClosure* StgSRT[];
-/* Each info table refers to some subset of the closure pointers in an
- SRT. It does this using a pair of an StgSRT pointer and a
- half-word bitmap. If the half-word bitmap isn't large enough, then
- we fall back to a large SRT, including an unbounded bitmap. If the
- half-word bitmap is set to all ones (0xffff), then the StgSRT
- pointer instead points to an StgLargeSRT: */
+// Each info table refers to some subset of the closure pointers in an
+// SRT. It does this using a pair of an StgSRT pointer and a
+// half-word bitmap. If the half-word bitmap isn't large enough, then
+// we fall back to a large SRT, including an unbounded bitmap. If the
+// half-word bitmap is set to all ones (0xffff), then the StgSRT
+// pointer instead points to an StgLargeSRT:
typedef struct StgLargeSRT_ {
StgSRT *srt;
StgLargeBitmap l;
Info Tables
------------------------------------------------------------------------- */
-/*
- Stuff describing the closure layout. Well, actually, it might
- contain the selector index for a THUNK_SELECTOR. This union is one
- word long.
-*/
+//
+// Stuff describing the closure layout. Well, actually, it might
+// contain the selector index for a THUNK_SELECTOR. This union is one
+// word long.
+//
typedef union {
- struct { /* Heap closure payload layout: */
- StgHalfWord ptrs; /* number of pointers */
- StgHalfWord nptrs; /* number of non-pointers */
+ struct { // Heap closure payload layout:
+ StgHalfWord ptrs; // number of pointers
+ StgHalfWord nptrs; // number of non-pointers
} payload;
- StgWord bitmap; /* word-sized bit pattern describing */
- /* a stack frame: see below */
+ StgWord bitmap; // word-sized bit pattern describing
+ // a stack frame: see below
- StgLargeBitmap* large_bitmap; /* pointer to large bitmap structure */
+ StgLargeBitmap* large_bitmap; // pointer to large bitmap structure
- StgWord selector_offset; /* used in THUNK_SELECTORs */
+ StgWord selector_offset; // used in THUNK_SELECTORs
} StgClosureInfo;
-/*
- The "standard" part of an info table. Every info table has this bit.
-*/
+//
+// The "standard" part of an info table. Every info table has this bit.
+//
typedef struct _StgInfoTable {
#ifndef TABLES_NEXT_TO_CODE
MAYBE_EMPTY_STRUCT(StgDebugInfo,debug)
#endif
- StgClosureInfo layout; /* closure layout info (one word) */
+ StgClosureInfo layout; // closure layout info (one word)
- StgHalfWord type; /* closure type */
- StgHalfWord srt_bitmap; /* number of entries in SRT (or constructor tag) */
+ StgHalfWord type; // closure type
+ StgHalfWord srt_bitmap; // number of entries in SRT (or constructor tag)
#ifdef TABLES_NEXT_TO_CODE
StgCode code[FLEXIBLE_ARRAY];
typedef struct _StgFunInfoTable {
#if defined(TABLES_NEXT_TO_CODE)
- StgFun *slow_apply; /* apply to args on the stack */
- StgWord bitmap; /* arg ptr/nonptr bitmap */
- StgSRT *srt; /* pointer to the SRT table */
- StgHalfWord fun_type; /* function type */
- StgHalfWord arity; /* function arity */
+ StgFun *slow_apply; // apply to args on the stack
+ StgWord bitmap; // arg ptr/nonptr bitmap
+ StgSRT *srt; // pointer to the SRT table
+ StgHalfWord fun_type; // function type
+ StgHalfWord arity; // function arity
StgInfoTable i;
#else
StgInfoTable i;
- StgHalfWord fun_type; /* function type */
- StgHalfWord arity; /* function arity */
- StgSRT *srt; /* pointer to the SRT table */
- StgWord bitmap; /* arg ptr/nonptr bitmap */
- StgFun *slow_apply; /* apply to args on the stack */
+ StgHalfWord fun_type; // function type
+ StgHalfWord arity; // function arity
+ StgSRT *srt; // pointer to the SRT table
+ StgWord bitmap; // arg ptr/nonptr bitmap
+ StgFun *slow_apply; // apply to args on the stack
#endif
} StgFunInfoTable;
Return info tables
-------------------------------------------------------------------------- */
-/* When info tables are laid out backwards, we can omit the SRT
- pointer iff srt_bitmap is zero. */
+// When info tables are laid out backwards, we can omit the SRT
+// pointer iff srt_bitmap is zero.
typedef struct _StgRetInfoTable {
#if !defined(TABLES_NEXT_TO_CODE)
StgInfoTable i;
#endif
- StgSRT *srt; /* pointer to the SRT table */
+ StgSRT *srt; // pointer to the SRT table
#if defined(TABLES_NEXT_TO_CODE)
StgInfoTable i;
#endif
Thunk info tables
-------------------------------------------------------------------------- */
-/* When info tables are laid out backwards, we can omit the SRT
- pointer iff srt_bitmap is zero. */
+// When info tables are laid out backwards, we can omit the SRT
+// pointer iff srt_bitmap is zero.
typedef struct _StgThunkInfoTable {
#if !defined(TABLES_NEXT_TO_CODE)
StgInfoTable i;
#endif
- StgSRT *srt; /* pointer to the SRT table */
+ StgSRT *srt; // pointer to the SRT table
#if defined(TABLES_NEXT_TO_CODE)
StgInfoTable i;
#endif