Give isolates names to be used during debugging.

runtime/include/dart_api.h

 // Copyright (c) 2011, 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 227 matching lines @@
  *   C string containing an error message in the case of failures.
  *
  * \return The embedder returns false if the creation and initialization was not
  *   successful and true if successful. The embedder is responsible for
  *   maintaining consistency in the case of errors (e.g: isolate is created,
  *   but loading of scripts fails then the embedder should ensure that
  *   Dart_ShutdownIsolate is called on the isolate).
  *   In the case of errors the caller is responsible for freeing the buffer
  *   returned in error containing an error string.
  */
-typedef bool (*Dart_IsolateCreateCallback)(void* callback_data, char** error);
+typedef bool (*Dart_IsolateCreateCallback)(const char* name_prefix,

[Ivan Posva, 2012/01/20 16:28:29]

name_prefix and callback_data are not documented anywhere.

+                                           void* callback_data,
+                                           char** error);
 
 /**
  * An isolate interrupt callback function.
  *
  * This callback, provided by the embedder, is called when an isolate
  * is interrupted as a result of a call to Dart_InterruptIsolate().
  * When the callback is called, Dart_CurrentIsolate can be used to
  * figure out which isolate is being interrupted.
  *
  * \param current_isolate The isolate being interrupted.
@@ skipping 49 matching lines @@
  */
 typedef struct _Dart_Isolate* Dart_Isolate;
 
 /**
  * Creates a new isolate. The new isolate becomes the current isolate.
  *
  * A snapshot can be used to restore the VM quickly to a saved state
  * and is useful for fast startup. If snapshot data is provided, the
  * isolate will be started using that snapshot data.
  *
  * Requires there to be no current isolate.

[Ivan Posva, 2012/01/20 16:28:29]

I don't think this is the case. Please check with Siva, but as far as I remember
it just overrides the current isolate.

  *
  * \param snapshot A buffer containing a VM snapshot or NULL if no
  *   snapshot is provided.
  *
  * \return The new isolate is returned. May be NULL if an error
  *   occurs duing isolate initialization.
  */
-DART_EXPORT Dart_Isolate Dart_CreateIsolate(const uint8_t* snapshot,
+DART_EXPORT Dart_Isolate Dart_CreateIsolate(const char* name_prefix,

[Ivan Posva, 2012/01/20 16:28:29]

name_prefix and callback_data are not documented.

+                                            const uint8_t* snapshot,
                                             void* callback_data,
                                             char** error);
 // TODO(turnidge): Document behavior when there is already a current
 // isolate.
 
 /**
  * Shuts down the current isolate. After this call, the current
  * isolate is NULL.
  *
  * Requires there to be a current isolate.
@@ skipping 1044 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_