Index: runtime/include/dart_tools_api.h |
diff --git a/runtime/include/dart_tools_api.h b/runtime/include/dart_tools_api.h |
index 270ce8140f90f0008223c5134f534f6845419fa8..d13f960dec22674432fe9fa3cdf7f82ff185a124 100644 |
--- a/runtime/include/dart_tools_api.h |
+++ b/runtime/include/dart_tools_api.h |
@@ -17,7 +17,6 @@ |
* This reference is generated from the header include/dart_tools_api.h. |
*/ |
- |
/* |
* ======== |
* Debugger |
@@ -41,14 +40,12 @@ typedef Dart_Port Dart_IsolateId; |
*/ |
#define ILLEGAL_ISOLATE_ID ILLEGAL_PORT |
- |
/** |
* Null value for breakpoint id. Guaranteed never to be associated |
* with a valid breakpoint. |
*/ |
#define ILLEGAL_BREAKPOINT_ID 0 |
- |
typedef void Dart_ExceptionThrownHandler(Dart_IsolateId isolate_id, |
Dart_Handle exception_object, |
Dart_StackTrace stack_trace); |
@@ -59,7 +56,6 @@ typedef enum { |
kShutdown, |
} Dart_IsolateEvent; |
- |
/** |
* Represents a location in Dart code. |
*/ |
@@ -69,7 +65,6 @@ typedef struct { |
int32_t token_pos; // Code address. |
} Dart_CodeLocation; |
- |
typedef void Dart_IsolateEventHandler(Dart_IsolateId isolate_id, |
Dart_IsolateEvent kind); |
@@ -81,7 +76,6 @@ typedef void Dart_BreakpointResolvedHandler(Dart_IsolateId isolate_id, |
intptr_t bp_id, |
const Dart_CodeLocation& location); |
- |
/** |
* Caches a given \object and returns an object id. The object id is only |
* valid while the VM is paused. The cache is invalidated when the VM |
@@ -93,7 +87,6 @@ typedef void Dart_BreakpointResolvedHandler(Dart_IsolateId isolate_id, |
*/ |
DART_EXPORT intptr_t Dart_CacheObject(Dart_Handle object_in); |
- |
/** |
* Returns a cached object given the \obj_id. |
* |
@@ -101,7 +94,6 @@ DART_EXPORT intptr_t Dart_CacheObject(Dart_Handle object_in); |
*/ |
DART_EXPORT Dart_Handle Dart_GetCachedObject(intptr_t obj_id); |
- |
/** |
* Returns a list of ids (integers) of all the libraries loaded in the |
* current isolate. |
@@ -112,7 +104,6 @@ DART_EXPORT Dart_Handle Dart_GetCachedObject(intptr_t obj_id); |
*/ |
DART_EXPORT Dart_Handle Dart_GetLibraryIds(); |
- |
/** |
* Returns true if the debugger can step into code of the given library. |
* |
@@ -123,7 +114,6 @@ DART_EXPORT Dart_Handle Dart_GetLibraryIds(); |
DART_EXPORT Dart_Handle Dart_GetLibraryDebuggable(intptr_t library_id, |
bool* is_debuggable); |
- |
/** |
* Requets that debugging be enabled for the given library. |
* |
@@ -134,7 +124,6 @@ DART_EXPORT Dart_Handle Dart_GetLibraryDebuggable(intptr_t library_id, |
DART_EXPORT Dart_Handle Dart_SetLibraryDebuggable(intptr_t library_id, |
bool is_debuggable); |
- |
/** |
* Returns a list of urls (strings) of all the scripts loaded in the |
* given library. |
@@ -145,7 +134,6 @@ DART_EXPORT Dart_Handle Dart_SetLibraryDebuggable(intptr_t library_id, |
*/ |
DART_EXPORT Dart_Handle Dart_GetScriptURLs(Dart_Handle library_url); |
- |
/** |
* Returns a string containing the source code of the given script |
* in the given library. |
@@ -158,7 +146,6 @@ DART_EXPORT Dart_Handle Dart_GetScriptURLs(Dart_Handle library_url); |
DART_EXPORT Dart_Handle Dart_ScriptGetSource(intptr_t library_id, |
Dart_Handle script_url_in); |
- |
/** |
* Returns an array containing line number and token offset info |
* for the given script. |
@@ -179,7 +166,6 @@ DART_EXPORT Dart_Handle Dart_ScriptGetSource(intptr_t library_id, |
DART_EXPORT Dart_Handle Dart_ScriptGetTokenInfo(intptr_t library_id, |
Dart_Handle script_url_in); |
- |
/** |
* Returns a string containing a generated source code of the given script |
* in the given library. This is essentially used to pretty print dart code |
@@ -193,7 +179,6 @@ DART_EXPORT Dart_Handle Dart_ScriptGetTokenInfo(intptr_t library_id, |
DART_EXPORT Dart_Handle Dart_GenerateScriptSource(Dart_Handle library_url_in, |
Dart_Handle script_url_in); |
- |
/** |
* Sets a breakpoint at line \line_number in \script_url, or the closest |
* following line (within the same function) where a breakpoint can be set. |
@@ -215,7 +200,6 @@ DART_EXPORT Dart_Handle Dart_SetBreakpoint(Dart_Handle script_url, |
*/ |
DART_EXPORT Dart_Handle Dart_RemoveBreakpoint(intptr_t bp_id); |
- |
/** |
* Get the script URL of the breakpoint with the given id \pb_id. |
* |
@@ -226,7 +210,6 @@ DART_EXPORT Dart_Handle Dart_RemoveBreakpoint(intptr_t bp_id); |
*/ |
DART_EXPORT Dart_Handle Dart_GetBreakpointURL(intptr_t bp_id); |
- |
/** |
* Get the line number of the breakpoint with the given id \pb_id. |
* |
@@ -237,7 +220,6 @@ DART_EXPORT Dart_Handle Dart_GetBreakpointURL(intptr_t bp_id); |
*/ |
DART_EXPORT Dart_Handle Dart_GetBreakpointLine(intptr_t bp_id); |
- |
/** |
* Sets a one-time breakpoint at the entry of the given function. |
* If class_name is the empty string, looks for a library function |
@@ -252,7 +234,6 @@ DART_EXPORT Dart_Handle Dart_SetBreakpointAtEntry(Dart_Handle library, |
Dart_Handle class_name, |
Dart_Handle function_name); |
- |
/** |
* Sets a breakpoint at the entry of the given function. If class_name |
* is the empty string, looks for a library function with the given |
@@ -266,7 +247,6 @@ DART_EXPORT Dart_Handle Dart_OneTimeBreakAtEntry(Dart_Handle library, |
Dart_Handle class_name, |
Dart_Handle function_name); |
- |
/** |
* Can be called from the breakpoint handler. Sets the debugger to |
* single step mode. |
@@ -275,7 +255,6 @@ DART_EXPORT Dart_Handle Dart_OneTimeBreakAtEntry(Dart_Handle library, |
*/ |
DART_EXPORT Dart_Handle Dart_SetStepOver(); |
- |
/** |
* Can be called from the breakpoint handler. Causes the debugger to |
* break after at the beginning of the next function call. |
@@ -284,7 +263,6 @@ DART_EXPORT Dart_Handle Dart_SetStepOver(); |
*/ |
DART_EXPORT Dart_Handle Dart_SetStepInto(); |
- |
/** |
* Can be called from the breakpoint handler. Causes the debugger to |
* break after returning from the current Dart function. |
@@ -293,7 +271,6 @@ DART_EXPORT Dart_Handle Dart_SetStepInto(); |
*/ |
DART_EXPORT Dart_Handle Dart_SetStepOut(); |
- |
/** |
* Installs a handler callback function that gets called by the VM |
* when a breakpoint location has been reached or when stepping. |
@@ -302,7 +279,6 @@ DART_EXPORT Dart_Handle Dart_SetStepOut(); |
*/ |
DART_EXPORT void Dart_SetPausedEventHandler(Dart_PausedEventHandler handler); |
- |
/** |
* Installs a callback function that gets called by the VM when |
* a breakpoint has been resolved to an actual url and line number. |
@@ -346,7 +322,6 @@ typedef enum { |
DART_EXPORT Dart_Handle |
Dart_SetExceptionPauseInfo(Dart_ExceptionPauseInfo pause_info); |
- |
/** |
* Returns on which exceptions the debugger pauses. |
* |
@@ -364,7 +339,6 @@ DART_EXPORT Dart_ExceptionPauseInfo Dart_GetExceptionPauseInfo(); |
*/ |
DART_EXPORT Dart_Handle Dart_GetStackTrace(Dart_StackTrace* trace); |
- |
/** |
* Returns in \trace the stack trace associated with the error given in \handle. |
* |
@@ -375,7 +349,6 @@ DART_EXPORT Dart_Handle Dart_GetStackTrace(Dart_StackTrace* trace); |
DART_EXPORT Dart_Handle Dart_GetStackTraceFromError(Dart_Handle error, |
Dart_StackTrace* trace); |
- |
/** |
* Returns in \length the number of activation frames in the given |
* stack trace. |
@@ -387,7 +360,6 @@ DART_EXPORT Dart_Handle Dart_GetStackTraceFromError(Dart_Handle error, |
DART_EXPORT Dart_Handle Dart_StackTraceLength(Dart_StackTrace trace, |
intptr_t* length); |
- |
/** |
* Returns in \frame the activation frame with index \frame_index. |
* The activation frame at the top of stack has index 0. |
@@ -400,7 +372,6 @@ DART_EXPORT Dart_Handle Dart_GetActivationFrame(Dart_StackTrace trace, |
int frame_index, |
Dart_ActivationFrame* frame); |
- |
/** |
* Returns information about the given activation frame. |
* \function_name receives a string handle with the qualified |
@@ -424,7 +395,6 @@ Dart_ActivationFrameInfo(Dart_ActivationFrame activation_frame, |
intptr_t* line_number, |
intptr_t* column_number); |
- |
/** |
* Returns code location of the given activation frame. |
* |
@@ -481,7 +451,6 @@ Dart_ActivationFrameGetFramePointer(Dart_ActivationFrame activation_frame, |
DART_EXPORT Dart_Handle |
Dart_GetLocalVariables(Dart_ActivationFrame activation_frame); |
- |
/** |
* Returns origin class of a function. |
* |
@@ -493,7 +462,6 @@ Dart_GetLocalVariables(Dart_ActivationFrame activation_frame); |
*/ |
DART_EXPORT Dart_Handle Dart_GetFunctionOrigin(Dart_Handle function); |
- |
/** |
* Returns an array containing all the global variable names and values of |
* the library with given \library_id. |
@@ -506,7 +474,6 @@ DART_EXPORT Dart_Handle Dart_GetFunctionOrigin(Dart_Handle function); |
*/ |
DART_EXPORT Dart_Handle Dart_GetGlobalVariables(intptr_t library_id); |
- |
/** |
* Execute the expression given in string \expr in the context |
* of stack frame \activation_frame. |
@@ -515,7 +482,6 @@ DART_EXPORT Dart_Handle |
Dart_ActivationFrameEvaluate(Dart_ActivationFrame activation_frame, |
Dart_Handle expr_in); |
- |
/** |
* Execute the expression given in string \expr in the context |
* of \target. |
@@ -536,7 +502,6 @@ Dart_ActivationFrameEvaluate(Dart_ActivationFrame activation_frame, |
*/ |
DART_EXPORT Dart_Handle Dart_EvaluateExpr(Dart_Handle target, Dart_Handle expr); |
- |
/** |
* Returns the class of the given \object. |
* |
@@ -546,7 +511,6 @@ DART_EXPORT Dart_Handle Dart_EvaluateExpr(Dart_Handle target, Dart_Handle expr); |
*/ |
DART_EXPORT Dart_Handle Dart_GetObjClass(Dart_Handle object); |
- |
/** |
* Returns in \class_id the class id of the given \object. The id is valid |
* for the lifetime of the isolate. |
@@ -558,7 +522,6 @@ DART_EXPORT Dart_Handle Dart_GetObjClass(Dart_Handle object); |
DART_EXPORT Dart_Handle Dart_GetObjClassId(Dart_Handle object, |
intptr_t* class_id); |
- |
/** |
* Returns the supertype of the given instantiated type \cls. |
* |
@@ -568,7 +531,6 @@ DART_EXPORT Dart_Handle Dart_GetObjClassId(Dart_Handle object, |
*/ |
DART_EXPORT Dart_Handle Dart_GetSupertype(Dart_Handle type); |
- |
/** |
* Returns handle to class with class id \class_id. |
* |
@@ -578,7 +540,6 @@ DART_EXPORT Dart_Handle Dart_GetSupertype(Dart_Handle type); |
*/ |
DART_EXPORT Dart_Handle Dart_GetClassFromId(intptr_t class_id); |
- |
/** |
* Returns info about the given class \cls_id. |
* |
@@ -601,7 +562,6 @@ DART_EXPORT Dart_Handle Dart_GetClassInfo(intptr_t class_id, |
intptr_t* super_class_id, |
Dart_Handle* static_fields); |
- |
/** Returns info about the given closure \closure. |
* |
* \param name receives handle to closure name (string). |
@@ -622,7 +582,6 @@ DART_EXPORT Dart_Handle Dart_GetClosureInfo(Dart_Handle closure, |
Dart_Handle* signature, |
Dart_CodeLocation* location); |
- |
/** |
* Returns an array containing all instance field names and values of |
* the given \object. |
@@ -637,7 +596,6 @@ DART_EXPORT Dart_Handle Dart_GetClosureInfo(Dart_Handle closure, |
*/ |
DART_EXPORT Dart_Handle Dart_GetInstanceFields(Dart_Handle object); |
- |
/** |
* Returns an array containing all static field names and values of |
* the given type \target. |
@@ -652,7 +610,6 @@ DART_EXPORT Dart_Handle Dart_GetInstanceFields(Dart_Handle object); |
*/ |
DART_EXPORT Dart_Handle Dart_GetStaticFields(Dart_Handle target); |
- |
/** |
* Returns a handle to the library \library_id. |
* |
@@ -662,7 +619,6 @@ DART_EXPORT Dart_Handle Dart_GetStaticFields(Dart_Handle target); |
*/ |
DART_EXPORT Dart_Handle Dart_GetLibraryFromId(intptr_t library_id); |
- |
/** |
* Returns in \library_id the library id of the given \library. |
* |
@@ -671,7 +627,6 @@ DART_EXPORT Dart_Handle Dart_GetLibraryFromId(intptr_t library_id); |
DART_EXPORT Dart_Handle Dart_LibraryId(Dart_Handle library, |
intptr_t* library_id); |
- |
/** |
* Returns an array containing all variable names and values of |
* the given library \library_id. |
@@ -686,7 +641,6 @@ DART_EXPORT Dart_Handle Dart_LibraryId(Dart_Handle library, |
*/ |
DART_EXPORT Dart_Handle Dart_GetLibraryFields(intptr_t library_id); |
- |
/** |
* Returns an array containing all imported libraries of |
* the given library \library_id. |
@@ -702,7 +656,6 @@ DART_EXPORT Dart_Handle Dart_GetLibraryFields(intptr_t library_id); |
*/ |
DART_EXPORT Dart_Handle Dart_GetLibraryImports(intptr_t library_id); |
- |
/** |
* Returns the url of the library \library_id. |
* |
@@ -712,7 +665,6 @@ DART_EXPORT Dart_Handle Dart_GetLibraryImports(intptr_t library_id); |
*/ |
DART_EXPORT Dart_Handle Dart_GetLibraryURL(intptr_t library_id); |
- |
/** |
* Returns the isolate object corresponding to the isolate id. |
* |
@@ -721,7 +673,6 @@ DART_EXPORT Dart_Handle Dart_GetLibraryURL(intptr_t library_id); |
*/ |
DART_EXPORT Dart_Isolate Dart_GetIsolate(Dart_IsolateId isolate_id); |
- |
/** |
* Returns the isolate id for an isolate. |
* |
@@ -729,7 +680,6 @@ DART_EXPORT Dart_Isolate Dart_GetIsolate(Dart_IsolateId isolate_id); |
*/ |
DART_EXPORT Dart_IsolateId Dart_GetIsolateId(Dart_Isolate isolate); |
- |
/* |
* ======= |
* Service |
@@ -781,7 +731,6 @@ typedef bool (*Dart_ServiceRequestCallback)(const char* method, |
void* user_data, |
const char** json_object); |
- |
/** |
* Register a Dart_ServiceRequestCallback to be called to handle |
* requests for the named rpc on a specific isolate. The callback will |
@@ -799,7 +748,6 @@ DART_EXPORT void Dart_RegisterIsolateServiceRequestCallback( |
Dart_ServiceRequestCallback callback, |
void* user_data); |
- |
/** |
* Register a Dart_ServiceRequestCallback to be called to handle |
* requests for the named rpc. The callback will be invoked without a |
@@ -817,7 +765,6 @@ DART_EXPORT void Dart_RegisterRootServiceRequestCallback( |
Dart_ServiceRequestCallback callback, |
void* user_data); |
- |
/* |
* ======== |
* Event Streams |
@@ -952,7 +899,6 @@ DART_EXPORT int64_t Dart_TimelineGetMicros(); |
/** Disable all timeline stream recording */ |
#define DART_TIMELINE_STREAM_DISABLE 0 |
- |
/** |
* Start recording timeline events for the entire VM (including all isolates). |
* |
@@ -962,7 +908,6 @@ DART_EXPORT int64_t Dart_TimelineGetMicros(); |
*/ |
DART_EXPORT void Dart_GlobalTimelineSetRecordedStreams(int64_t stream_mask); |
- |
typedef enum { |
/** Indicates a new stream is being output */ |
Dart_StreamConsumer_kStart = 0, |