Add runtime and native entry tags

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 2194 matching lines @@
  *   for the native function.
  *
  * See Dart_SetNativeResolver.
  */
 typedef Dart_NativeFunction (*Dart_NativeEntryResolver)(Dart_Handle name,
                                                         int num_of_arguments,
                                                         bool* auto_setup_scope);
 /* TODO(turnidge): Consider renaming to NativeFunctionResolver or
  * NativeResolver. */
 
+/**
+ * Native entry reverse resolution callback.

[siva, 2014/04/08 16:27:54]

Native entry symbol lookup callback.

[Cutch, 2014/04/09 17:40:59]

Done.

+ *
+ * For libraries and scripts which have native functions, the embedder
+ * can provide a native entry reverse resolver. This callback is used to map

[siva, 2014/04/08 16:27:54]

can provide a callback for mapping a native entry to a symbol. This callback
maps

[Cutch, 2014/04/09 17:40:59]

Done.

+ * a native function entry PC to the native function name. If no native entry
+ * can be found, the callback should return NULL.
+ *
+ * The parameters to the native reverse resolver function are:
+ * \param nf A Dart_NativeFunction.
+ *
+ * \return A const C string containing the name of the native function or NULL.
+ *
+ * See Dart_SetNativeResolver.
+ */
+typedef const char* (*Dart_NativeEntryReverseResolver)(Dart_NativeFunction nf);

[siva, 2014/04/08 16:27:54]

Should the return value be a const char* or a uint8_t* where the symbol is
returned in UTF8 format?

[Cutch, 2014/04/09 17:40:59]

UTF8.

+
+
 /*
  * ===========
  * Environment
  * ===========
  */
 
 /**
  * An environment lookup callback function.
  *
  * \param name The name of the value to lookup in the environment.
@@ skipping 16 matching lines @@
 /**
  * Sets the callback used to resolve native functions for a library.
  *
  * \param library A library.
  * \param resolver A native entry resolver.
  *
  * \return A valid handle if the native resolver was set successfully.
  */
 DART_EXPORT Dart_Handle Dart_SetNativeResolver(
     Dart_Handle library,
-    Dart_NativeEntryResolver resolver);
+    Dart_NativeEntryResolver resolver,
+    Dart_NativeEntryReverseResolver reverse_resolver);

[siva, 2014/04/08 16:27:54]

Dart_NativeEntrySymbol

[Cutch, 2014/04/09 17:40:59]

Done.

 /* TODO(turnidge): Rename to Dart_LibrarySetNativeResolver? */
 
 
 /*
  * =====================
  * Scripts and Libraries
  * =====================
  */
 /* TODO(turnidge): Finish documenting this section. */
 
@@ skipping 279 matching lines @@
  * NOTE: If multiple callbacks with the same name are registered, only the
  * last callback registered will be remembered.
  */
 DART_EXPORT void Dart_RegisterRootServiceRequestCallback(
     const char* name,
     Dart_ServiceRequestCallback callback,
     void* user_data);
 
 
 #endif  /* INCLUDE_DART_API_H_ */  /* NOLINT */