Mercurial > hg > truffle

changeset 13567:2f67ba090923

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Truffle: extensions to the DebugManager interface in the Instrumentation Framework
author Michael Van De Vanter <michael.van.de.vanter@oracle.com>
date Tue, 07 Jan 2014 18:28:40 -0800
parents f2b3452744ef
children f29a358cf3da
files graal/com.oracle.truffle.api/src/com/oracle/truffle/api/DebugManager.java
diffstat 1 files changed, 30 insertions(+), 4 deletions(-) [+]
line wrap: on
line diff
--- a/graal/com.oracle.truffle.api/src/com/oracle/truffle/api/DebugManager.java	Tue Jan 07 18:26:59 2014 -0800
+++ b/graal/com.oracle.truffle.api/src/com/oracle/truffle/api/DebugManager.java	Tue Jan 07 18:28:40 2014 -0800
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2013, 2013, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2013, 2014, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -24,16 +24,24 @@
  */
 package com.oracle.truffle.api;
 
+import com.oracle.truffle.api.frame.*;
+import com.oracle.truffle.api.nodes.*;
+import com.oracle.truffle.api.nodes.instrument.*;
 import com.oracle.truffle.api.source.*;
 
 /**
  * Language-agnostic access to AST-based debugging support.
  * <p>
- * <strong>WARNING:</strong> this interface is under development and will change substantially.
+ * <strong>Disclaimer:</strong> this interface is under development and will change.
  */
 public interface DebugManager {
 
     /**
+     * Gets a list of current breakpoints.
+     */
+    LineBreakpoint[] getBreakpoints();
+
+    /**
      * Sets a breakpoint at a line-based location.
      */
     LineBreakpoint setBreakpoint(SourceLineLocation lineLocation);
@@ -45,9 +53,14 @@
     LineBreakpoint setConditionalBreakpoint(SourceLineLocation lineLocation, String condition);
 
     /**
-     * Gets a list of current breakpoints.
+     * Sets a breakpoint at a line-based location that will remove itself when hit.
      */
-    LineBreakpoint[] getBreakpoints();
+    LineBreakpoint setOneShotBreakpoint(SourceLineLocation lineLocation);
+
+    /**
+     * Is there a line-based breakpoint set at a location?
+     */
+    boolean hasBreakpoint(SourceLineLocation lineLocation);
 
     /**
      * Removes a breakpoint at a line-based location.
@@ -55,6 +68,19 @@
     void removeBreakpoint(SourceLineLocation lineLocation);
 
     /**
+     * Notification from Truffle execution that execution should halt in a debugging context.
+     */
+    /**
+     * Receives notification of a suspended execution context; execution resumes when this method
+     * returns.
+     * 
+     * @param astNode a guest language AST node that represents the current execution site, assumed
+     *            not to be any kind of {@link InstrumentationNode},
+     * @param frame execution frame at the site where execution suspended
+     */
+    void haltedAt(Node astNode, MaterializedFrame frame);
+
+    /**
      * Description of a line-based breakpoint.
      */
     interface LineBreakpoint {