mono/sgen/gc-internal-agnostic.h

   1 /**
   2  * \file
   3  * Mono-agnostic GC interface.
   4  *
   5  * Copyright (C) 2015 Xamarin Inc
   6  *
   7  * Licensed under the MIT license. See LICENSE file in the project root for full license information.
   8  */
   9
  10 #ifndef __MONO_METADATA_GCINTERNALAGNOSTIC_H__
  11 #define __MONO_METADATA_GCINTERNALAGNOSTIC_H__
  12
  13 #include <config.h>
  14 #include <glib.h>
  15 #include <stdio.h>
  16
  17 #include "mono/utils/mono-compiler.h"
  18 #include "mono/utils/parse.h"
  19 #include "mono/utils/memfuncs.h"
  20 #ifdef HAVE_SGEN_GC
  21 #include "mono/sgen/sgen-conf.h"
  22 #endif
  23
  24 /* h indicates whether to hide or just tag.
  25  * (-!!h ^ p) is used instead of (h ? ~p : p) to avoid multiple mentions of p.
  26  */
  27 #define MONO_GC_HIDE_POINTER(p,t,h) ((gpointer)(((-(size_t)!!(h) ^ (size_t)(p)) & ~(size_t)3) | ((t) & (size_t)3)))
  28 #define MONO_GC_REVEAL_POINTER(p,h) ((gpointer)((-(size_t)!!(h) ^ (size_t)(p)) & ~(size_t)3))
  29
  30 #define MONO_GC_POINTER_TAG(p) ((size_t)(p) & (size_t)3)
  31
  32 #define MONO_GC_HANDLE_OCCUPIED_MASK (1)
  33 #define MONO_GC_HANDLE_VALID_MASK (2)
  34 #define MONO_GC_HANDLE_TAG_MASK (MONO_GC_HANDLE_OCCUPIED_MASK | MONO_GC_HANDLE_VALID_MASK)
  35
  36 #define MONO_GC_HANDLE_METADATA_POINTER(p,h) (MONO_GC_HIDE_POINTER ((p), MONO_GC_HANDLE_OCCUPIED_MASK, (h)))
  37 #define MONO_GC_HANDLE_OBJECT_POINTER(p,h) (MONO_GC_HIDE_POINTER ((p), MONO_GC_HANDLE_OCCUPIED_MASK | MONO_GC_HANDLE_VALID_MASK, (h)))
  38
  39 #define MONO_GC_HANDLE_OCCUPIED(slot) ((size_t)(slot) & MONO_GC_HANDLE_OCCUPIED_MASK)
  40 #define MONO_GC_HANDLE_VALID(slot) ((size_t)(slot) & MONO_GC_HANDLE_VALID_MASK)
  41
  42 #define MONO_GC_HANDLE_TAG(slot) ((size_t)(slot) & MONO_GC_HANDLE_TAG_MASK)
  43
  44 #define MONO_GC_HANDLE_IS_OBJECT_POINTER(slot) (MONO_GC_HANDLE_TAG (slot) == (MONO_GC_HANDLE_OCCUPIED_MASK | MONO_GC_HANDLE_VALID_MASK))
  45 #define MONO_GC_HANDLE_IS_METADATA_POINTER(slot) (MONO_GC_HANDLE_TAG (slot) == MONO_GC_HANDLE_OCCUPIED_MASK)
  46
  47 typedef enum {
  48         HANDLE_TYPE_MIN = 0,
  49         HANDLE_WEAK = HANDLE_TYPE_MIN,
  50         HANDLE_WEAK_TRACK,
  51         HANDLE_NORMAL,
  52         HANDLE_PINNED,
  53         HANDLE_TYPE_MAX
  54 } GCHandleType;
  55
  56 #define GC_HANDLE_TYPE_IS_WEAK(x) ((x) <= HANDLE_WEAK_TRACK)
  57
  58 #define MONO_GC_HANDLE_TYPE_SHIFT (3)
  59 #define MONO_GC_HANDLE_TYPE_MASK ((1 << MONO_GC_HANDLE_TYPE_SHIFT) - 1)
  60 #define MONO_GC_HANDLE_TYPE(x) ((GCHandleType)(((x) & MONO_GC_HANDLE_TYPE_MASK) - 1))
  61 #define MONO_GC_HANDLE_SLOT(x) ((x) >> MONO_GC_HANDLE_TYPE_SHIFT)
  62 #define MONO_GC_HANDLE_TYPE_IS_WEAK(x) ((x) <= HANDLE_WEAK_TRACK)
  63 #define MONO_GC_HANDLE(slot, type) (((slot) << MONO_GC_HANDLE_TYPE_SHIFT) | (((type) & MONO_GC_HANDLE_TYPE_MASK) + 1))
  64
  65 typedef struct {
  66         gint32 minor_gc_count;
  67         gint32 major_gc_count;
  68         gint64 minor_gc_time;
  69         gint64 major_gc_time;
  70         gint64 major_gc_time_concurrent;
  71 } GCStats;
  72
  73 extern GCStats gc_stats;
  74
  75 #ifdef HAVE_SGEN_GC
  76 typedef SgenDescriptor MonoGCDescriptor;
  77 #define MONO_GC_DESCRIPTOR_NULL SGEN_DESCRIPTOR_NULL
  78 #else
  79 typedef void* MonoGCDescriptor;
  80 #define MONO_GC_DESCRIPTOR_NULL NULL
  81 #endif
  82
  83 gboolean mono_gc_parse_environment_string_extract_number (const char *str, size_t *out);
  84
  85 MonoGCDescriptor mono_gc_make_descr_for_object (gsize *bitmap, int numbits, size_t obj_size);
  86 MonoGCDescriptor mono_gc_make_descr_for_array (int vector, gsize *elem_bitmap, int numbits, size_t elem_size);
  87
  88 /* simple interface for data structures needed in the runtime */
  89 MonoGCDescriptor mono_gc_make_descr_from_bitmap (gsize *bitmap, int numbits);
  90
  91 /* Return a root descriptor for a vector with repeating refs bitmap */
  92 MonoGCDescriptor mono_gc_make_vector_descr (void);
  93
  94 /* Return a root descriptor for a root with all refs */
  95 MonoGCDescriptor mono_gc_make_root_descr_all_refs (int numbits);
  96
  97 /* Return the bitmap encoded by a descriptor */
  98 gsize* mono_gc_get_bitmap_for_descr (MonoGCDescriptor descr, int *numbits);
  99
 100 /*
 101 These functions must be used when it's possible that either destination is not
 102 word aligned or size is not a multiple of word size.
 103 */
 104 void mono_gc_bzero_atomic (void *dest, size_t size);
 105 void mono_gc_bzero_aligned (void *dest, size_t size);
 106 void mono_gc_memmove_atomic (void *dest, const void *src, size_t size);
 107 void mono_gc_memmove_aligned (void *dest, const void *src, size_t size);
 108
 109 FILE *mono_gc_get_logfile (void);
 110
 111 /* equivalent to options set via MONO_GC_PARAMS */
 112 void mono_gc_params_set (const char* options);
 113 /* equivalent to options set via MONO_GC_DEBUG */
 114 void mono_gc_debug_set (const char* options);
 115
 116 #endif