Mercurial > hg > graal-compiler

comparison graal/com.oracle.truffle.api/src/com/oracle/truffle/api/instrument/InstrumentationNode.java @ 20890:37912559d662

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Truffle/Instrumentation: Javadoc work on instrument listener interfaces.
author Michael Van De Vanter <michael.van.de.vanter@oracle.com>
date Fri, 10 Apr 2015 17:55:09 -0700
parents 907128d02b31
children
comparison
equal deleted inserted replaced
20889:0e647427eee4 20890:37912559d662
26 26
27 import com.oracle.truffle.api.frame.*; 27 import com.oracle.truffle.api.frame.*;
28 import com.oracle.truffle.api.nodes.*; 28 import com.oracle.truffle.api.nodes.*;
29 29
30 /** 30 /**
31 * A marker interface for Truffle {@linkplain Node nodes} that support <em>Instrumentation</em> and 31 * A marker interface for Truffle {@linkplain Node nodes} that internally implement the
32 * are should not be part of any Guest Language execution semantics. 32 * <em>Instrumentation Framework</em>. Such nodes should not be part of any Guest Language execution
33 * semantics, and should in general not be visible to ordinary Instrumentation clients.
33 */ 34 */
34 public interface InstrumentationNode { 35 public interface InstrumentationNode {
35 36
36 /** 37 /**
37 * A short description of the particular role played by the node, intended to support debugging. 38 * A short description of the particular role played by the node, intended to support debugging.
38 */ 39 */
39 String instrumentationInfo(); 40 String instrumentationInfo();
40 41
41 /** 42 /**
42 * Events at a Truffle node that get propagated through the Instrumentation Framework. 43 * Events that propagate through the {@linkplain InstrumentationNode implementation nodes} of
44 * the Instrumentation Framework, not visible in this form to Instrumentation clients.
43 */ 45 */
44 interface TruffleEvents { 46 interface TruffleEvents {
45 47
46 /** 48 /**
47 * An AST node's execute method is about to be called. 49 * An AST node's execute method is about to be called.
60 62
61 /** 63 /**
62 * An AST Node's execute method has just thrown an exception. 64 * An AST Node's execute method has just thrown an exception.
63 */ 65 */
64 void returnExceptional(Node node, VirtualFrame vFrame, Exception exception); 66 void returnExceptional(Node node, VirtualFrame vFrame, Exception exception);
65
66 } 67 }
67 } 68 }