Implement a heap profiler for the Dart managed heap.

runtime/include/dart_api.h

Index: runtime/include/dart_api.h
diff --git a/runtime/include/dart_api.h b/runtime/include/dart_api.h
index c610c5e02353e707c27f6cf393c4e7514bd936ed..17ad1f175cd96cbcb522bba1e8e5aa578592ca35 100755
--- a/runtime/include/dart_api.h
+++ b/runtime/include/dart_api.h
@@ -100,6 +100,10 @@ typedef void (*Dart_WeakPersistentHandleFinalizer)(Dart_Handle handle,
                                                    void* peer);
 typedef void (*Dart_PeerFinalizer)(void* peer);
 
+typedef void (*Dart_HeapProfileWriteCallback)(const void* data,

[turnidge, 2012/05/29 17:50:01]

Maybe add short comment above this.

[cshapiro, 2012/06/01 04:27:02]

Certainly.  Done.

+                                              intptr_t length,
+                                              void* stream);
+
 /**
  * Is this an error handle?
  *
@@ -384,6 +388,19 @@ DART_EXPORT Dart_Handle Dart_AddGcEpilogueCallback(
 DART_EXPORT Dart_Handle Dart_RemoveGcEpilogueCallback(
     Dart_GcEpilogueCallback callback);
 
+/**
+ * Generates a heap profile.
+ *
+ * \param callback A function pointer that will be repeatedly invoked
+ *   with heap profile data.
+ * \param context A pointer that will be passed to the callback.  This
+ *   is a convenient way to provide an open stream to the callback.
+ *
+ * \return Success if the heap profile is successful.
+ */
+DART_EXPORT Dart_Handle Dart_HeapProfile(Dart_HeapProfileWriteCallback callback,
+                                         void* context);
+
 // --- Initialization and Globals ---
 
 /**