mono/metadata/sgen-protocol.h

   1 /*
   2  * sgen-protocol.h: Binary protocol of internal activity, to aid
   3  * debugging.
   4  *
   5  * Copyright 2001-2003 Ximian, Inc
   6  * Copyright 2003-2010 Novell, Inc.
   7  * Copyright (C) 2012 Xamarin Inc
   8  *
   9  * This library is free software; you can redistribute it and/or
  10  * modify it under the terms of the GNU Library General Public
  11  * License 2.0 as published by the Free Software Foundation;
  12  *
  13  * This library is distributed in the hope that it will be useful,
  14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  16  * Library General Public License for more details.
  17  *
  18  * You should have received a copy of the GNU Library General Public
  19  * License 2.0 along with this library; if not, write to the Free
  20  * Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  21  */
  22
  23 #ifndef __MONO_SGENPROTOCOL_H__
  24 #define __MONO_SGENPROTOCOL_H__
  25
  26 #include "sgen-gc.h"
  27
  28 enum {
  29         SGEN_PROTOCOL_COLLECTION_FORCE,
  30         SGEN_PROTOCOL_COLLECTION_BEGIN,
  31         SGEN_PROTOCOL_COLLECTION_END,
  32         SGEN_PROTOCOL_CONCURRENT_START,
  33         SGEN_PROTOCOL_CONCURRENT_UPDATE_FINISH,
  34         SGEN_PROTOCOL_WORLD_STOPPING,
  35         SGEN_PROTOCOL_WORLD_STOPPED,
  36         SGEN_PROTOCOL_WORLD_RESTARTING,
  37         SGEN_PROTOCOL_WORLD_RESTARTED,
  38         SGEN_PROTOCOL_ALLOC,
  39         SGEN_PROTOCOL_COPY,
  40         SGEN_PROTOCOL_PIN_STAGE,
  41         SGEN_PROTOCOL_PIN,
  42         SGEN_PROTOCOL_MARK,
  43         SGEN_PROTOCOL_SCAN_BEGIN,
  44         SGEN_PROTOCOL_SCAN_VTYPE_BEGIN,
  45         SGEN_PROTOCOL_WBARRIER,
  46         SGEN_PROTOCOL_GLOBAL_REMSET,
  47         SGEN_PROTOCOL_PTR_UPDATE,
  48         SGEN_PROTOCOL_CLEANUP,
  49         SGEN_PROTOCOL_EMPTY,
  50         SGEN_PROTOCOL_THREAD_SUSPEND,
  51         SGEN_PROTOCOL_THREAD_RESTART,
  52         SGEN_PROTOCOL_THREAD_REGISTER,
  53         SGEN_PROTOCOL_THREAD_UNREGISTER,
  54         SGEN_PROTOCOL_MISSING_REMSET,
  55         SGEN_PROTOCOL_ALLOC_PINNED,
  56         SGEN_PROTOCOL_ALLOC_DEGRADED,
  57         SGEN_PROTOCOL_CARD_SCAN,
  58         SGEN_PROTOCOL_CEMENT,
  59         SGEN_PROTOCOL_CEMENT_RESET,
  60         SGEN_PROTOCOL_DISLINK_UPDATE,
  61         SGEN_PROTOCOL_DISLINK_UPDATE_STAGED,
  62         SGEN_PROTOCOL_DISLINK_PROCESS_STAGED,
  63         SGEN_PROTOCOL_DOMAIN_UNLOAD_BEGIN,
  64         SGEN_PROTOCOL_DOMAIN_UNLOAD_END,
  65         SGEN_PROTOCOL_GRAY_ENQUEUE,
  66         SGEN_PROTOCOL_GRAY_DEQUEUE,
  67 };
  68
  69 typedef struct {
  70         int generation;
  71 } SGenProtocolCollectionForce;
  72
  73 typedef struct {
  74         int index, generation;
  75 } SGenProtocolCollection;
  76
  77 typedef struct {
  78         long long timestamp;
  79 } SGenProtocolWorldStopping;
  80
  81 typedef struct {
  82         long long timestamp;
  83         long long total_major_cards;
  84         long long marked_major_cards;
  85         long long total_los_cards;
  86         long long marked_los_cards;
  87 } SGenProtocolWorldStopped;
  88
  89 typedef struct {
  90         int generation;
  91         long long timestamp;
  92         long long total_major_cards;
  93         long long marked_major_cards;
  94         long long total_los_cards;
  95         long long marked_los_cards;
  96 } SGenProtocolWorldRestarting;
  97
  98 typedef struct {
  99         int generation;
 100         long long timestamp;
 101 } SGenProtocolWorldRestarted;
 102
 103 typedef struct {
 104         gpointer obj;
 105         gpointer vtable;
 106         int size;
 107 } SGenProtocolAlloc;
 108
 109 typedef struct {
 110         gpointer from;
 111         gpointer to;
 112         gpointer vtable;
 113         int size;
 114 } SGenProtocolCopy;
 115
 116 typedef struct {
 117         gpointer addr_ptr;
 118         gpointer addr;
 119 } SGenProtocolPinStage;
 120
 121 typedef struct {
 122         gpointer obj;
 123         gpointer vtable;
 124         int size;
 125 } SGenProtocolPin;
 126
 127 typedef struct {
 128         gpointer obj;
 129         gpointer vtable;
 130         int size;
 131 } SGenProtocolMark;
 132
 133 typedef struct {
 134         gpointer obj;
 135         gpointer vtable;
 136         int size;
 137 } SGenProtocolScanBegin;
 138
 139 typedef struct {
 140         gpointer obj;
 141         int size;
 142 } SGenProtocolScanVTypeBegin;
 143
 144 typedef struct {
 145         gpointer ptr;
 146         gpointer value;
 147         gpointer value_vtable;
 148 } SGenProtocolWBarrier;
 149
 150 typedef struct {
 151         gpointer ptr;
 152         gpointer value;
 153         gpointer value_vtable;
 154 } SGenProtocolGlobalRemset;
 155
 156 typedef struct {
 157         gpointer ptr;
 158         gpointer old_value;
 159         gpointer new_value;
 160         gpointer vtable;
 161         int size;
 162 } SGenProtocolPtrUpdate;
 163
 164 typedef struct {
 165         gpointer ptr;
 166         gpointer vtable;
 167         int size;
 168 } SGenProtocolCleanup;
 169
 170 typedef struct {
 171         gpointer start;
 172         int size;
 173 } SGenProtocolEmpty;
 174
 175 typedef struct {
 176         gpointer thread, stopped_ip;
 177 } SGenProtocolThreadSuspend;
 178
 179 typedef struct {
 180         gpointer thread;
 181 } SGenProtocolThreadRestart;
 182
 183 typedef struct {
 184         gpointer thread;
 185 } SGenProtocolThreadRegister;
 186
 187 typedef struct {
 188         gpointer thread;
 189 } SGenProtocolThreadUnregister;
 190
 191 typedef struct {
 192         gpointer obj;
 193         gpointer obj_vtable;
 194         int offset;
 195         gpointer value;
 196         gpointer value_vtable;
 197         int value_pinned;
 198 } SGenProtocolMissingRemset;
 199
 200 typedef struct {
 201         gpointer start;
 202         int size;
 203 } SGenProtocolCardScan;
 204
 205 typedef struct {
 206         gpointer obj;
 207         gpointer vtable;
 208         int size;
 209 } SGenProtocolCement;
 210
 211 typedef struct {
 212         gpointer link;
 213         gpointer obj;
 214         int track;
 215         int staged;
 216 } SGenProtocolDislinkUpdate;
 217
 218 typedef struct {
 219         gpointer link;
 220         gpointer obj;
 221         int track;
 222         int index;
 223 } SGenProtocolDislinkUpdateStaged;
 224
 225 typedef struct {
 226         gpointer link;
 227         gpointer obj;
 228         int index;
 229 } SGenProtocolDislinkProcessStaged;
 230
 231 typedef struct {
 232         gpointer domain;
 233 } SGenProtocolDomainUnload;
 234
 235 typedef struct {
 236         gpointer queue;
 237         gpointer cursor;
 238         gpointer value;
 239 } SGenProtocolGrayQueue;
 240
 241 /* missing: finalizers, roots, non-store wbarriers */
 242
 243 void binary_protocol_init (const char *filename, long long limit) MONO_INTERNAL;
 244 gboolean binary_protocol_is_enabled (void) MONO_INTERNAL;
 245
 246 void binary_protocol_flush_buffers (gboolean force) MONO_INTERNAL;
 247
 248 void binary_protocol_collection_force (int generation) MONO_INTERNAL;
 249 void binary_protocol_collection_begin (int index, int generation) MONO_INTERNAL;
 250 void binary_protocol_collection_end (int index, int generation) MONO_INTERNAL;
 251 void binary_protocol_concurrent_start (void) MONO_INTERNAL;
 252 void binary_protocol_concurrent_update_finish (void) MONO_INTERNAL;
 253 void binary_protocol_world_stopping (long long timestamp) MONO_INTERNAL;
 254 void binary_protocol_world_stopped (long long timestamp, long long total_major_cards,
 255                 long long marked_major_cards, long long total_los_cards, long long marked_los_cards) MONO_INTERNAL;
 256 void binary_protocol_world_restarting (int generation, long long timestamp,
 257                 long long total_major_cards, long long marked_major_cards, long long total_los_cards, long long marked_los_cards) MONO_INTERNAL;
 258 void binary_protocol_world_restarted (int generation, long long timestamp) MONO_INTERNAL;
 259
 260 void binary_protocol_thread_suspend (gpointer thread, gpointer stopped_ip) MONO_INTERNAL;
 261 void binary_protocol_thread_restart (gpointer thread) MONO_INTERNAL;
 262 void binary_protocol_thread_register (gpointer thread) MONO_INTERNAL;
 263 void binary_protocol_thread_unregister (gpointer thread) MONO_INTERNAL;
 264 void binary_protocol_missing_remset (gpointer obj, gpointer obj_vtable, int offset,
 265                 gpointer value, gpointer value_vtable, int value_pinned) MONO_INTERNAL;
 266
 267 void binary_protocol_cement (gpointer ptr, gpointer vtable, int size) MONO_INTERNAL;
 268 void binary_protocol_cement_reset (void) MONO_INTERNAL;
 269
 270 void binary_protocol_domain_unload_begin (gpointer domain) MONO_INTERNAL;
 271 void binary_protocol_domain_unload_end (gpointer domain) MONO_INTERNAL;
 272
 273 #ifdef SGEN_HEAVY_BINARY_PROTOCOL
 274
 275 #define binary_protocol_is_heavy_enabled()      binary_protocol_is_enabled ()
 276
 277 void binary_protocol_alloc (gpointer obj, gpointer vtable, int size) MONO_INTERNAL;
 278 void binary_protocol_alloc_pinned (gpointer obj, gpointer vtable, int size) MONO_INTERNAL;
 279 void binary_protocol_alloc_degraded (gpointer obj, gpointer vtable, int size) MONO_INTERNAL;
 280 void binary_protocol_copy (gpointer from, gpointer to, gpointer vtable, int size) MONO_INTERNAL;
 281 void binary_protocol_pin_stage (gpointer addr_ptr, gpointer addr) MONO_INTERNAL;
 282 void binary_protocol_pin (gpointer obj, gpointer vtable, int size) MONO_INTERNAL;
 283 void binary_protocol_mark (gpointer obj, gpointer vtable, int size) MONO_INTERNAL;
 284 void binary_protocol_scan_begin (gpointer obj, gpointer vtable, int size) MONO_INTERNAL;
 285 void binary_protocol_scan_vtype_begin (gpointer start, int size) MONO_INTERNAL;
 286 void binary_protocol_wbarrier (gpointer ptr, gpointer value, gpointer value_vtable) MONO_INTERNAL;
 287 void binary_protocol_global_remset (gpointer ptr, gpointer value, gpointer value_vtable) MONO_INTERNAL;
 288 void binary_protocol_ptr_update (gpointer ptr, gpointer old_value, gpointer new_value, gpointer vtable, int size) MONO_INTERNAL;
 289 void binary_protocol_cleanup (gpointer ptr, gpointer vtable, int size) MONO_INTERNAL;
 290 void binary_protocol_empty (gpointer start, int size) MONO_INTERNAL;
 291 void binary_protocol_card_scan (gpointer start, int size) MONO_INTERNAL;
 292 void binary_protocol_dislink_update (gpointer link, gpointer obj, int track, int staged) MONO_INTERNAL;
 293 void binary_protocol_dislink_update_staged (gpointer link, gpointer obj, int track, int index) MONO_INTERNAL;
 294 void binary_protocol_dislink_process_staged (gpointer link, gpointer obj, int index) MONO_INTERNAL;
 295 void binary_protocol_gray_enqueue (gpointer queue, gpointer cursor, gpointer value) MONO_INTERNAL;
 296 void binary_protocol_gray_dequeue (gpointer queue, gpointer cursor, gpointer value) MONO_INTERNAL;
 297
 298 #else
 299
 300 #define binary_protocol_is_heavy_enabled()      FALSE
 301
 302 #define binary_protocol_alloc(obj, vtable, size)
 303 #define binary_protocol_alloc_pinned(obj, vtable, size)
 304 #define binary_protocol_alloc_degraded(obj, vtable, size)
 305 #define binary_protocol_copy(from, to, vtable, size)
 306 #define binary_protocol_pin_stage(addr_ptr, addr)
 307 #define binary_protocol_pin(obj, vtable, size)
 308 #define binary_protocol_mark(obj, vtable, size)
 309 #define binary_protocol_scan_begin(obj, vtable, size)
 310 #define binary_protocol_scan_vtype_begin(obj, size)
 311 #define binary_protocol_wbarrier(ptr, value, value_vtable)
 312 #define binary_protocol_global_remset(ptr, value, value_vtable)
 313 #define binary_protocol_ptr_update(ptr, old_value, new_value, vtable, size)
 314 #define binary_protocol_cleanup(ptr, vtable, size)
 315 #define binary_protocol_empty(start, size)
 316 #define binary_protocol_card_scan(start, size)
 317 #define binary_protocol_dislink_update(link,obj,track,staged)
 318 #define binary_protocol_dislink_update_staged(link,obj,track,index)
 319 #define binary_protocol_dislink_process_staged(link,obj,index)
 320 #define binary_protocol_gray_enqueue(queue,cursor,value)
 321 #define binary_protocol_gray_dequeue(queue,cursor,value)
 322
 323 #endif
 324
 325 #endif