Implement a garbage collection prologue and epilogue callback mechanism.

runtime/include/dart_api.h

 // Copyright (c) 2012, the Dart project authors.  Please see the AUTHORS file
 // for details. All rights reserved. Use of this source code is governed by a
 // BSD-style license that can be found in the LICENSE file.
 
 #ifndef INCLUDE_DART_API_H_
 #define INCLUDE_DART_API_H_
 
 /** \mainpage Dart Embedding API Reference
  *
  * Dart is a class-based programming language for creating structured
@@ skipping 254 matching lines @@
  * \param num_values the size of the values set
  *
  * \return Success if the weak reference set could be created.
  *   Otherwise, returns an error handle.
  */
 DART_EXPORT Dart_Handle Dart_NewWeakReferenceSet(Dart_Handle* keys,
                                                  intptr_t num_keys,
                                                  Dart_Handle* values,
                                                  intptr_t num_values);
 
+// --- Garbage Collection Callbacks --

[turnidge, 2012/03/07 00:25:16]

Could add general comment here (see other sections).

[cshapiro, 2012/03/07 03:06:10]

Done.

+
+typedef void (*Dart_GcPrologueCallback)();
+typedef void (*Dart_GcEpilogueCallback)();

[turnidge, 2012/03/07 00:25:16]

Comment these in a way similar to other function typedefs.

[cshapiro, 2012/03/07 03:06:10]

Done.

+
+/**
+ * Adds a garbage collection prologue callback.
+ *
+ * \param callback A function pointer to a prologue callback function.
+ *   This function must not have been previously added as a prologue
+ *   callback.
+ *
+ * \return Success if the callback was added.  Otherwise, returns an
+ *   error handle.
+ */
+DART_EXPORT Dart_Handle Dart_NewGcPrologueCallback(

[turnidge, 2012/03/07 00:25:16]

Consider s/New/add? 

[cshapiro, 2012/03/07 03:06:10]

I've make the switch.  These are now the only add and remove functions in the
API.  Let me know how it looks.  I can go either way.

+    Dart_GcPrologueCallback callback);
+
+/**
+ * Removes a garbage collection prologue callback.
+ *
+ * \param callback A function pointer to a prologue callback function.
+ *   This function must have been added as a prologue callback.
+ *
+ * \return Success if the callback was removed.  Otherwise, returns an
+ *   error handle.
+ */
+DART_EXPORT Dart_Handle Dart_DeleteGcPrologueCallback(

[turnidge, 2012/03/07 00:25:16]

s/Delete/Remove?

[cshapiro, 2012/03/07 03:06:10]

See above.

+    Dart_GcPrologueCallback callback);
+
+/**
+ * Adds a garbage collection epilogue callback.
+ *
+ * \param callback A function pointer to an epilogue callback
+ *   function.  This function must not have been previously added as
+ *   an epilogue callback.
+ *
+ * \return Success if the callback was added.  Otherwise, returns an
+ *   error handle.
+ */
+DART_EXPORT Dart_Handle Dart_NewGcEpilogueCallback(
+    Dart_GcEpilogueCallback callback);
+
+/**
+ * Removes a garbage collection epilogue callback.
+ *
+ * \param callback A function pointer to an epilogue callback
+ *   function.  This function must have been added as an epilogue
+ *   callback.
+ *
+ * \return Success if the callback was removed.  Otherwise, returns an
+ *   error handle.
+ */
+DART_EXPORT Dart_Handle Dart_DeleteGcEpilogueCallback(
+    Dart_GcEpilogueCallback callback);
 
 // --- Initialization and Globals ---
 
 /**
  * An isolate creation and initialization callback function.
  *
  * This callback, provided by the embedder, is called when an isolate needs
  * to be created. The callback should create an isolate and load the
  * required scripts for execution.
  *
@@ skipping 1565 matching lines @@
 
 // --- Profiling support ----
 
 // External pprof support for gathering and dumping symbolic
 // information that can be used for better profile reports for
 // dynamically generated code.
 DART_EXPORT void Dart_InitPprofSupport();
 DART_EXPORT void Dart_GetPprofSymbolInfo(void** buffer, int* buffer_size);
 
 #endif  // INCLUDE_DART_API_H_