Add new Dart API function Dart_IsolateData which returns the peer isolate data associated with an i…

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
@@ skipping 858 matching lines @@
 DART_EXPORT void Dart_ShutdownIsolate();
 /* TODO(turnidge): Document behavior when there is no current isolate. */
 
 /**
  * Returns the current isolate. Will return NULL if there is no
  * current isolate.
  */
 DART_EXPORT Dart_Isolate Dart_CurrentIsolate();
 
 /**
- * Returns the callback data which was passed to the isolate when it
- * was created.
+ * Returns the callback data associated with the current Isolate. This data was
+ * passed to the isolate when it was created.
  */
 DART_EXPORT void* Dart_CurrentIsolateData();
 
 /**
+ * Returns the callback data associated with the specified Isolate. This data
+ * was passed to the isolate when it was created.
+ * The embedder is responsible for ensuring that the consistency of this data
+ * with respect to the lifecycle of an Isolate.
+ */
+DART_EXPORT void* Dart_IsolateData(Dart_Isolate isolate);
+
+/**
  * Returns the debugging name for the current isolate.
  *
  * This name is unique to each isolate and should only be used to make
  * debugging messages more comprehensible.
  */
 DART_EXPORT Dart_Handle Dart_DebugName();
 
 /**
  * Enters an isolate. After calling this function,
  * the current isolate will be set to the provided isolate.
@@ skipping 97 matching lines @@
  */
 #define ILLEGAL_PORT ((Dart_Port) 0)
 
 /**
  * A message notification callback.
  *
  * This callback allows the embedder to provide an alternate wakeup
  * mechanism for the delivery of inter-isolate messages.  It is the
  * responsibility of the embedder to call Dart_HandleMessage to
  * process the message.
+ *

[Ivan Posva, 2014/02/07 00:17:46]

I don't think we should state this here since we might want to weaken this
guarantee long-term.

[siva, 2014/02/07 00:35:42]

Removed.

On 2014/02/07 00:17:46, Ivan Posva wrote:

+ * The VM guarantees that the destination isolate 'dest_isolate' will not
+ * be shutdown while this callback is executed.
  */
 typedef void (*Dart_MessageNotifyCallback)(Dart_Isolate dest_isolate);
 
 /**
  * Allows embedders to provide an alternative wakeup mechanism for the
  * delivery of inter-isolate messages. This setting only applies to
  * the current isolate.
  *
  * Most embedders will only call this function once, before isolate
  * execution begins. If this function is called after isolate
@@ skipping 1439 matching lines @@
  * be loaded in and the isolate can be run by the embedder.
  *
  * NOTE: It is not safe to call this from multiple threads concurrently.
  *
  * \return Returns NULL if an error occurred.
  */
 DART_EXPORT Dart_Isolate Dart_GetServiceIsolate(void* callback_data);
 
 
 #endif  /* INCLUDE_DART_API_H_ */  /* NOLINT */