377 lines
13 KiB
C
377 lines
13 KiB
C
/***********************************************************************/
|
|
/* */
|
|
/* Objective Caml */
|
|
/* */
|
|
/* Damien Doligez, projet Para, INRIA Rocquencourt */
|
|
/* */
|
|
/* Copyright 1996 Institut National de Recherche en Informatique et */
|
|
/* en Automatique. All rights reserved. This file is distributed */
|
|
/* under the terms of the GNU Library General Public License, with */
|
|
/* the special exception on linking described in file ../LICENSE. */
|
|
/* */
|
|
/***********************************************************************/
|
|
|
|
/* $Id$ */
|
|
|
|
/* Allocation macros and functions */
|
|
|
|
#ifndef _memory_
|
|
#define _memory_
|
|
|
|
|
|
#include "config.h"
|
|
/* <private> */
|
|
#include "gc.h"
|
|
#include "major_gc.h"
|
|
#include "minor_gc.h"
|
|
/* </private> */
|
|
#include "misc.h"
|
|
#include "mlvalues.h"
|
|
|
|
CAMLextern value alloc_shr (mlsize_t, tag_t);
|
|
void adjust_gc_speed (mlsize_t, mlsize_t);
|
|
CAMLextern void modify (value *, value);
|
|
CAMLextern void initialize (value *, value);
|
|
CAMLextern value check_urgent_gc (value);
|
|
CAMLextern void * stat_alloc (asize_t); /* Size in bytes. */
|
|
CAMLextern void stat_free (void *);
|
|
CAMLextern void * stat_resize (void *, asize_t); /* Size in bytes. */
|
|
char *alloc_for_heap (asize_t request); /* Size in bytes. */
|
|
void free_for_heap (char *mem);
|
|
int add_to_heap (char *mem);
|
|
color_t allocation_color (void *hp);
|
|
|
|
/* void shrink_heap (char *); Only used in compact.c */
|
|
|
|
/* <private> */
|
|
|
|
#ifdef DEBUG
|
|
#define DEBUG_clear(result, wosize) do{ \
|
|
unsigned long caml__DEBUG_i; \
|
|
for (caml__DEBUG_i = 0; caml__DEBUG_i < (wosize); ++ caml__DEBUG_i){ \
|
|
Field ((result), caml__DEBUG_i) = Debug_uninit_minor; \
|
|
} \
|
|
}while(0)
|
|
#else
|
|
#define DEBUG_clear(result, wosize)
|
|
#endif
|
|
|
|
#define Alloc_small(result, wosize, tag) do{ CAMLassert (wosize >= 1); \
|
|
CAMLassert ((tag_t) tag < 256); \
|
|
young_ptr -= Bhsize_wosize (wosize); \
|
|
if (young_ptr < young_limit){ \
|
|
young_ptr += Bhsize_wosize (wosize); \
|
|
Setup_for_gc; \
|
|
minor_collection (); \
|
|
Restore_after_gc; \
|
|
young_ptr -= Bhsize_wosize (wosize); \
|
|
} \
|
|
Hd_hp (young_ptr) = Make_header ((wosize), (tag), Caml_black); \
|
|
(result) = Val_hp (young_ptr); \
|
|
DEBUG_clear ((result), (wosize)); \
|
|
}while(0)
|
|
|
|
/* You must use [Modify] to change a field of an existing shared block,
|
|
unless you are sure the value being overwritten is not a shared block and
|
|
the value being written is not a young block. */
|
|
/* [Modify] never calls the GC. */
|
|
/* [Modify] can also be used to do assignment on data structures that are
|
|
not in the (major) heap. In this case, it is a bit slower than
|
|
simple assignment.
|
|
In particular, you can use [Modify] when you don't know whether the
|
|
block being changed is in the minor heap or the major heap.
|
|
*/
|
|
|
|
#define Modify(fp, val) do{ \
|
|
value _old_ = *(fp); \
|
|
*(fp) = (val); \
|
|
if (Is_in_heap (fp)){ \
|
|
if (gc_phase == Phase_mark) darken (_old_, NULL); \
|
|
if (Is_block (val) && Is_young (val) \
|
|
&& ! (Is_block (_old_) && Is_young (_old_))){ \
|
|
*ref_table_ptr++ = (fp); \
|
|
if (ref_table_ptr >= ref_table_limit){ \
|
|
CAMLassert (ref_table_ptr == ref_table_limit); \
|
|
realloc_ref_table (); \
|
|
} \
|
|
} \
|
|
} \
|
|
}while(0)
|
|
|
|
/* </private> */
|
|
|
|
struct caml__roots_block {
|
|
struct caml__roots_block *next;
|
|
long ntables;
|
|
long nitems;
|
|
value *tables [5];
|
|
};
|
|
|
|
CAMLextern struct caml__roots_block *local_roots; /* defined in roots.c */
|
|
|
|
/* The following macros are used to declare C local variables and
|
|
function parameters of type [value].
|
|
|
|
The function body must start with one of the [CAMLparam] macros.
|
|
If the function has no parameter of type [value], use [CAMLparam0].
|
|
If the function has 1 to 5 [value] parameters, use the corresponding
|
|
[CAMLparam] with the parameters as arguments.
|
|
If the function has more than 5 [value] parameters, use [CAMLparam5]
|
|
for the first 5 parameters, and one or more calls to the [CAMLxparam]
|
|
macros for the others.
|
|
If the function takes an array of [value]s as argument, use
|
|
[CAMLparamN] to declare it (or [CAMLxparamN] if you already have a
|
|
call to [CAMLparam] for some other arguments).
|
|
|
|
If you need local variables of type [value], declare them with one
|
|
or more calls to the [CAMLlocal] macros.
|
|
Use [CAMLlocalN] to declare an array of [value]s.
|
|
|
|
Your function may raise and exception or return a [value] with the
|
|
[CAMLreturn] macro. Its argument is simply the [value] returned by
|
|
your function. Do NOT directly return a [value] with the [return]
|
|
keyword. If your function returns void, use [CAMLreturn0].
|
|
|
|
All the identifiers beginning with "caml__" are reserved by Caml.
|
|
Do not use them for anything (local or global variables, struct or
|
|
union tags, macros, etc.)
|
|
*/
|
|
|
|
#define CAMLparam0() \
|
|
struct caml__roots_block *caml__frame = local_roots
|
|
|
|
#define CAMLparam1(x) \
|
|
CAMLparam0 (); \
|
|
CAMLxparam1 (x)
|
|
|
|
#define CAMLparam2(x, y) \
|
|
CAMLparam0 (); \
|
|
CAMLxparam2 (x, y)
|
|
|
|
#define CAMLparam3(x, y, z) \
|
|
CAMLparam0 (); \
|
|
CAMLxparam3 (x, y, z)
|
|
|
|
#define CAMLparam4(x, y, z, t) \
|
|
CAMLparam0 (); \
|
|
CAMLxparam4 (x, y, z, t)
|
|
|
|
#define CAMLparam5(x, y, z, t, u) \
|
|
CAMLparam0 (); \
|
|
CAMLxparam5 (x, y, z, t, u)
|
|
|
|
#define CAMLparamN(x, size) \
|
|
CAMLparam0 (); \
|
|
CAMLxparamN (x, (size))
|
|
|
|
|
|
#define CAMLxparam1(x) \
|
|
struct caml__roots_block caml__roots_##x; \
|
|
int caml__dummy_##x = ( \
|
|
(caml__roots_##x.next = local_roots), \
|
|
(local_roots = &caml__roots_##x), \
|
|
(caml__roots_##x.nitems = 1), \
|
|
(caml__roots_##x.ntables = 1), \
|
|
(caml__roots_##x.tables [0] = &x), \
|
|
0)
|
|
|
|
#define CAMLxparam2(x, y) \
|
|
struct caml__roots_block caml__roots_##x; \
|
|
int caml__dummy_##x = ( \
|
|
(caml__roots_##x.next = local_roots), \
|
|
(local_roots = &caml__roots_##x), \
|
|
(caml__roots_##x.nitems = 1), \
|
|
(caml__roots_##x.ntables = 2), \
|
|
(caml__roots_##x.tables [0] = &x), \
|
|
(caml__roots_##x.tables [1] = &y), \
|
|
0)
|
|
|
|
#define CAMLxparam3(x, y, z) \
|
|
struct caml__roots_block caml__roots_##x; \
|
|
int caml__dummy_##x = ( \
|
|
(caml__roots_##x.next = local_roots), \
|
|
(local_roots = &caml__roots_##x), \
|
|
(caml__roots_##x.nitems = 1), \
|
|
(caml__roots_##x.ntables = 3), \
|
|
(caml__roots_##x.tables [0] = &x), \
|
|
(caml__roots_##x.tables [1] = &y), \
|
|
(caml__roots_##x.tables [2] = &z), \
|
|
0)
|
|
|
|
#define CAMLxparam4(x, y, z, t) \
|
|
struct caml__roots_block caml__roots_##x; \
|
|
int caml__dummy_##x = ( \
|
|
(caml__roots_##x.next = local_roots), \
|
|
(local_roots = &caml__roots_##x), \
|
|
(caml__roots_##x.nitems = 1), \
|
|
(caml__roots_##x.ntables = 4), \
|
|
(caml__roots_##x.tables [0] = &x), \
|
|
(caml__roots_##x.tables [1] = &y), \
|
|
(caml__roots_##x.tables [2] = &z), \
|
|
(caml__roots_##x.tables [3] = &t), \
|
|
0)
|
|
|
|
#define CAMLxparam5(x, y, z, t, u) \
|
|
struct caml__roots_block caml__roots_##x; \
|
|
int caml__dummy_##x = ( \
|
|
(caml__roots_##x.next = local_roots), \
|
|
(local_roots = &caml__roots_##x), \
|
|
(caml__roots_##x.nitems = 1), \
|
|
(caml__roots_##x.ntables = 5), \
|
|
(caml__roots_##x.tables [0] = &x), \
|
|
(caml__roots_##x.tables [1] = &y), \
|
|
(caml__roots_##x.tables [2] = &z), \
|
|
(caml__roots_##x.tables [3] = &t), \
|
|
(caml__roots_##x.tables [4] = &u), \
|
|
0)
|
|
|
|
#define CAMLxparamN(x, size) \
|
|
struct caml__roots_block caml__roots_##x; \
|
|
int caml__dummy_##x = ( \
|
|
(caml__roots_##x.next = local_roots), \
|
|
(local_roots = &caml__roots_##x), \
|
|
(caml__roots_##x.nitems = (size)), \
|
|
(caml__roots_##x.ntables = 1), \
|
|
(caml__roots_##x.tables[0] = &(x[0])), \
|
|
0)
|
|
|
|
#define CAMLlocal1(x) \
|
|
value x = 0; \
|
|
CAMLxparam1 (x)
|
|
|
|
#define CAMLlocal2(x, y) \
|
|
value x = 0, y = 0; \
|
|
CAMLxparam2 (x, y)
|
|
|
|
#define CAMLlocal3(x, y, z) \
|
|
value x = 0, y = 0, z = 0; \
|
|
CAMLxparam3 (x, y, z)
|
|
|
|
#define CAMLlocal4(x, y, z, t) \
|
|
value x = 0, y = 0, z = 0, t = 0; \
|
|
CAMLxparam4 (x, y, z, t)
|
|
|
|
#define CAMLlocal5(x, y, z, t, u) \
|
|
value x = 0, y = 0, z = 0, t = 0, u = 0; \
|
|
CAMLxparam5 (x, y, z, t, u)
|
|
|
|
#define CAMLlocalN(x, size) \
|
|
value x [(size)] = { 0, /* 0, 0, ... */ }; \
|
|
CAMLxparamN (x, (size))
|
|
|
|
|
|
#define CAMLreturn0 do{ \
|
|
local_roots = caml__frame; \
|
|
return; \
|
|
}while (0)
|
|
|
|
#define CAMLreturn(result) do{ \
|
|
local_roots = caml__frame; \
|
|
return (result); \
|
|
}while(0)
|
|
|
|
/* convenience macro */
|
|
#define Store_field(block, offset, val) do{ \
|
|
mlsize_t caml__temp_offset = (offset); \
|
|
value caml__temp_val = (val); \
|
|
modify (&Field ((block), caml__temp_offset), caml__temp_val); \
|
|
}while(0)
|
|
|
|
/*
|
|
NOTE: [Begin_roots] and [End_roots] are superseded by [CAMLparam]*,
|
|
[CAMLxparam]*, [CAMLlocal]*, [CAMLreturn].
|
|
|
|
[Begin_roots] and [End_roots] are used for C variables that are GC roots.
|
|
It must contain all values in C local variables and function parameters
|
|
at the time the minor GC is called.
|
|
Usage:
|
|
After initialising your local variables to legal Caml values, but before
|
|
calling allocation functions, insert [Begin_roots_n(v1, ... vn)], where
|
|
v1 ... vn are your variables of type [value] that you want to be updated
|
|
across allocations.
|
|
At the end, insert [End_roots()].
|
|
|
|
Note that [Begin_roots] opens a new block, and [End_roots] closes it.
|
|
Thus they must occur in matching pairs at the same brace nesting level.
|
|
|
|
You can use [Val_unit] as a dummy initial value for your variables.
|
|
*/
|
|
|
|
#define Begin_root Begin_roots1
|
|
|
|
#define Begin_roots1(r0) { \
|
|
struct caml__roots_block caml__roots_block; \
|
|
caml__roots_block.next = local_roots; \
|
|
local_roots = &caml__roots_block; \
|
|
caml__roots_block.nitems = 1; \
|
|
caml__roots_block.ntables = 1; \
|
|
caml__roots_block.tables[0] = &(r0);
|
|
|
|
#define Begin_roots2(r0, r1) { \
|
|
struct caml__roots_block caml__roots_block; \
|
|
caml__roots_block.next = local_roots; \
|
|
local_roots = &caml__roots_block; \
|
|
caml__roots_block.nitems = 1; \
|
|
caml__roots_block.ntables = 2; \
|
|
caml__roots_block.tables[0] = &(r0); \
|
|
caml__roots_block.tables[1] = &(r1);
|
|
|
|
#define Begin_roots3(r0, r1, r2) { \
|
|
struct caml__roots_block caml__roots_block; \
|
|
caml__roots_block.next = local_roots; \
|
|
local_roots = &caml__roots_block; \
|
|
caml__roots_block.nitems = 1; \
|
|
caml__roots_block.ntables = 3; \
|
|
caml__roots_block.tables[0] = &(r0); \
|
|
caml__roots_block.tables[1] = &(r1); \
|
|
caml__roots_block.tables[2] = &(r2);
|
|
|
|
#define Begin_roots4(r0, r1, r2, r3) { \
|
|
struct caml__roots_block caml__roots_block; \
|
|
caml__roots_block.next = local_roots; \
|
|
local_roots = &caml__roots_block; \
|
|
caml__roots_block.nitems = 1; \
|
|
caml__roots_block.ntables = 4; \
|
|
caml__roots_block.tables[0] = &(r0); \
|
|
caml__roots_block.tables[1] = &(r1); \
|
|
caml__roots_block.tables[2] = &(r2); \
|
|
caml__roots_block.tables[3] = &(r3);
|
|
|
|
#define Begin_roots5(r0, r1, r2, r3, r4) { \
|
|
struct caml__roots_block caml__roots_block; \
|
|
caml__roots_block.next = local_roots; \
|
|
local_roots = &caml__roots_block; \
|
|
caml__roots_block.nitems = 1; \
|
|
caml__roots_block.ntables = 5; \
|
|
caml__roots_block.tables[0] = &(r0); \
|
|
caml__roots_block.tables[1] = &(r1); \
|
|
caml__roots_block.tables[2] = &(r2); \
|
|
caml__roots_block.tables[3] = &(r3); \
|
|
caml__roots_block.tables[4] = &(r4);
|
|
|
|
#define Begin_roots_block(table, size) { \
|
|
struct caml__roots_block caml__roots_block; \
|
|
caml__roots_block.next = local_roots; \
|
|
local_roots = &caml__roots_block; \
|
|
caml__roots_block.nitems = (size); \
|
|
caml__roots_block.ntables = 1; \
|
|
caml__roots_block.tables[0] = (table);
|
|
|
|
#define End_roots() local_roots = caml__roots_block.next; }
|
|
|
|
|
|
/* [register_global_root] registers a global C variable as a memory root
|
|
for the duration of the program, or until [remove_global_root] is
|
|
called. */
|
|
|
|
CAMLextern void register_global_root (value *);
|
|
|
|
/* [remove_global_root] removes a memory root registered on a global C
|
|
variable with [register_global_root]. */
|
|
|
|
CAMLextern void remove_global_root (value *);
|
|
|
|
|
|
#endif /* _memory_ */
|
|
|