Debugger wire protocol: setting breakpoints

runtime/include/dart_debugger_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_DEBUGGER_API_H_
 #define INCLUDE_DART_DEBUGGER_API_H_
 
 #include "include/dart_api.h"
 
 typedef struct _Dart_Breakpoint* Dart_Breakpoint;
 
 typedef struct _Dart_StackTrace* Dart_StackTrace;
 
 typedef struct _Dart_ActivationFrame* Dart_ActivationFrame;
 
 typedef void Dart_BreakpointHandler(
                  Dart_Breakpoint breakpoint,
                  Dart_StackTrace stack_trace);
 
+typedef void Dart_BreakpointResolvedHandler(
+                 intptr_t bp_id,
+                 Dart_Handle url,
+                 intptr_t line_number);
 
 /**
  * Returns a list of urls (strings) of all the libraries loaded in the
  * current isolate.
  *
  * Requires there to be a current isolate.
  *
  * \return A handle to a list of string handles.
  */
 DART_EXPORT Dart_Handle Dart_GetLibraryURLs();
@@ skipping 16 matching lines @@
  *
  * Requires there to be a current isolate.
  *
  * \return A handle to string containing the source text if no error
  * occurs.
  */
 DART_EXPORT Dart_Handle Dart_GetScriptSource(
                             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.
  *
  * Requires there to be a current isolate.
  *
+ * \return A handle containing the breakpoint id, which is an integer
+ * value, or an error object if a breakpoint could not be set.
+ */
+DART_EXPORT Dart_Handle Dart_SetBreakpoint(
+                            Dart_Handle script_url,
+                            intptr_t line_number);
+
+/**
+ * Deletes the breakpoint with the given id \pb_id.
+ *
+ * Requires there to be a current isolate.
+ *
+ * \return A handle to the True object if no error occurs.
+ */
+DART_EXPORT Dart_Handle Dart_RemoveBreakpoint(intptr_t bp_id);
+
+
+/**
+ * Get the script URL of the breakpoint with the given id \pb_id.
+ *
+ * Requires there to be a current isolate.
+ *
+ * \return A handle to the URL (string) of the script, or an error
+ * object.
+ */
+DART_EXPORT Dart_Handle Dart_GetBreakpointURL(intptr_t bp_id);
+
+
+/**
+ * Get the line number of the breakpoint with the given id \pb_id.
+ *
+ * Requires there to be a current isolate.
+ *
+ * \return A handle to the line number (integer) of the script,
+ * or an error object.
+ */
+DART_EXPORT Dart_Handle Dart_GetBreakpointLine(intptr_t bp_id);
+
+
+/**
+ * DEPRECATED -- use Dart_SetBreakpoint instead.
+ *
+ * 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.
+ *
+ * Requires there to be a current isolate.
+ *
  * \breakpoint If non-null, will point to the breakpoint object
  *   if a breakpoint was successfully created.
  *
  * \return A handle to the True object if no error occurs.
  */
 DART_EXPORT Dart_Handle Dart_SetBreakpointAtLine(
                             Dart_Handle script_url,
                             Dart_Handle line_number,
                             Dart_Breakpoint* breakpoint);
 
@@ skipping 11 matching lines @@
  * \return A handle to the True object if no error occurs.
  */
 DART_EXPORT Dart_Handle Dart_SetBreakpointAtEntry(
                             Dart_Handle library,
                             Dart_Handle class_name,
                             Dart_Handle function_name,
                             Dart_Breakpoint* breakpoint);
 
 
 /**
+ * DEPRECATED -- use Dart_RemoveBreakpoint instead.
+ *
  * Deletes the given \breakpoint.
  *
  * Requires there to be a current isolate.
  *
  * \return A handle to the True object if no error occurs.
  */
 DART_EXPORT Dart_Handle Dart_DeleteBreakpoint(
                             Dart_Breakpoint breakpoint);
 
 
@@ skipping 26 matching lines @@
 
 /**
  * Installs a handler callback function that gets called by the VM
  * when a breakpoint has been reached.
  *
  * Requires there to be a current isolate.
  */
 DART_EXPORT void Dart_SetBreakpointHandler(
                             Dart_BreakpointHandler bp_handler);
 
+/**
+ * Installs a callback function that gets called by the VM when
+ * a breakpoint has been resolved to an actual url and line number.
+ *
+ * Requires there to be a current isolate.
+ */
+DART_EXPORT void Dart_SetBreakpointResolvedHandler(
+                            Dart_BreakpointResolvedHandler handler);
+
+
+/**
+ * Returns in \trace the the current stack trace, or NULL if the
+ * VM is not paused.
+ *
+ * Requires there to be a current isolate.
+ *
+ * \return A handle to the True object if no error occurs.
+ */
+DART_EXPORT Dart_Handle Dart_GetStackTrace(Dart_StackTrace* trace);
+
 
 /**
  * Returns in \length the number of activation frames in the given
  * stack trace.
  *
  * Requires there to be a current isolate.
  *
  * \return A handle to the True object if no error occurs.
  */
 DART_EXPORT Dart_Handle Dart_StackTraceLength(
@@ skipping 95 matching lines @@
  * \return A handle to an array containing field names and
  * corresponding field values. The array is empty if the class has
  * no static fields. If non-empty, field names are at array offsets 2*n,
  * values at offset 2*n+1. Field values may also be a handle to an
  * error object if an error was encountered evaluating the field.
  */
 DART_EXPORT Dart_Handle Dart_GetStaticFields(Dart_Handle cls);
 
 
 #endif  // INCLUDE_DART_DEBUGGER_API_H_