Implement a heap profiler for the Dart managed heap.

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 82 matching lines @@
  * can be used to store objects across scopes. Persistent handles have
  * the lifetime of the current isolate unless they are explicitly
  * deallocated (see Dart_DeletePersistentHandle).
  */
 typedef struct _Dart_Handle* Dart_Handle;
 
 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?
  *
  * Requires there to be a current isolate.
  */
 DART_EXPORT bool Dart_IsError(Dart_Handle handle);
 
 /**
  * Gets the error message from an error handle.
  *
@@ skipping 264 matching lines @@
  * \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_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 ---
 
 /**
  * An isolate creation and initialization callback function.
  *
  * This callback, provided by the embedder, is called when the vm
  * needs to create an isolate. The callback should create an isolate
  * by calling Dart_CreateIsolate and load any scripts required for
  * execution.
  *
@@ skipping 1685 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_