Mercurial > hg > truffle
annotate truffle/com.oracle.truffle.api/src/com/oracle/truffle/api/instrument/package-info.java @ 22248:6d328e688339
Truffle/Instrumentation: Javadoc cleanup
author | Michael Van De Vanter <michael.van.de.vanter@oracle.com> |
---|---|
date | Wed, 23 Sep 2015 21:48:02 -0700 |
parents | c1c9c6d79f40 |
children | e7643754d982 |
rev | line source |
---|---|
21972
ff6f34159b8a
Providing package-info for most of API packages. Feel free to provide your package-info.java for anything that has API in its name.
Jaroslav Tulach <jaroslav.tulach@oracle.com>
parents:
diff
changeset
|
1 /* |
22004
11e0412c5b0e
Make headers valid for checkstyle again.
Christian Humer <christian.humer@gmail.com>
parents:
22003
diff
changeset
|
2 * Copyright (c) 2015, Oracle and/or its affiliates. All rights reserved. |
11e0412c5b0e
Make headers valid for checkstyle again.
Christian Humer <christian.humer@gmail.com>
parents:
22003
diff
changeset
|
3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. |
21972
ff6f34159b8a
Providing package-info for most of API packages. Feel free to provide your package-info.java for anything that has API in its name.
Jaroslav Tulach <jaroslav.tulach@oracle.com>
parents:
diff
changeset
|
4 * |
22004
11e0412c5b0e
Make headers valid for checkstyle again.
Christian Humer <christian.humer@gmail.com>
parents:
22003
diff
changeset
|
5 * This code is free software; you can redistribute it and/or modify it |
11e0412c5b0e
Make headers valid for checkstyle again.
Christian Humer <christian.humer@gmail.com>
parents:
22003
diff
changeset
|
6 * under the terms of the GNU General Public License version 2 only, as |
11e0412c5b0e
Make headers valid for checkstyle again.
Christian Humer <christian.humer@gmail.com>
parents:
22003
diff
changeset
|
7 * published by the Free Software Foundation. Oracle designates this |
11e0412c5b0e
Make headers valid for checkstyle again.
Christian Humer <christian.humer@gmail.com>
parents:
22003
diff
changeset
|
8 * particular file as subject to the "Classpath" exception as provided |
11e0412c5b0e
Make headers valid for checkstyle again.
Christian Humer <christian.humer@gmail.com>
parents:
22003
diff
changeset
|
9 * by Oracle in the LICENSE file that accompanied this code. |
21972
ff6f34159b8a
Providing package-info for most of API packages. Feel free to provide your package-info.java for anything that has API in its name.
Jaroslav Tulach <jaroslav.tulach@oracle.com>
parents:
diff
changeset
|
10 * |
22004
11e0412c5b0e
Make headers valid for checkstyle again.
Christian Humer <christian.humer@gmail.com>
parents:
22003
diff
changeset
|
11 * This code is distributed in the hope that it will be useful, but WITHOUT |
11e0412c5b0e
Make headers valid for checkstyle again.
Christian Humer <christian.humer@gmail.com>
parents:
22003
diff
changeset
|
12 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or |
11e0412c5b0e
Make headers valid for checkstyle again.
Christian Humer <christian.humer@gmail.com>
parents:
22003
diff
changeset
|
13 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License |
11e0412c5b0e
Make headers valid for checkstyle again.
Christian Humer <christian.humer@gmail.com>
parents:
22003
diff
changeset
|
14 * version 2 for more details (a copy is included in the LICENSE file that |
21972
ff6f34159b8a
Providing package-info for most of API packages. Feel free to provide your package-info.java for anything that has API in its name.
Jaroslav Tulach <jaroslav.tulach@oracle.com>
parents:
diff
changeset
|
15 * accompanied this code). |
ff6f34159b8a
Providing package-info for most of API packages. Feel free to provide your package-info.java for anything that has API in its name.
Jaroslav Tulach <jaroslav.tulach@oracle.com>
parents:
diff
changeset
|
16 * |
22004
11e0412c5b0e
Make headers valid for checkstyle again.
Christian Humer <christian.humer@gmail.com>
parents:
22003
diff
changeset
|
17 * You should have received a copy of the GNU General Public License version |
11e0412c5b0e
Make headers valid for checkstyle again.
Christian Humer <christian.humer@gmail.com>
parents:
22003
diff
changeset
|
18 * 2 along with this work; if not, write to the Free Software Foundation, |
11e0412c5b0e
Make headers valid for checkstyle again.
Christian Humer <christian.humer@gmail.com>
parents:
22003
diff
changeset
|
19 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. |
21972
ff6f34159b8a
Providing package-info for most of API packages. Feel free to provide your package-info.java for anything that has API in its name.
Jaroslav Tulach <jaroslav.tulach@oracle.com>
parents:
diff
changeset
|
20 * |
22004
11e0412c5b0e
Make headers valid for checkstyle again.
Christian Humer <christian.humer@gmail.com>
parents:
22003
diff
changeset
|
21 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA |
11e0412c5b0e
Make headers valid for checkstyle again.
Christian Humer <christian.humer@gmail.com>
parents:
22003
diff
changeset
|
22 * or visit www.oracle.com if you need additional information or have any |
11e0412c5b0e
Make headers valid for checkstyle again.
Christian Humer <christian.humer@gmail.com>
parents:
22003
diff
changeset
|
23 * questions. |
21972
ff6f34159b8a
Providing package-info for most of API packages. Feel free to provide your package-info.java for anything that has API in its name.
Jaroslav Tulach <jaroslav.tulach@oracle.com>
parents:
diff
changeset
|
24 */ |
ff6f34159b8a
Providing package-info for most of API packages. Feel free to provide your package-info.java for anything that has API in its name.
Jaroslav Tulach <jaroslav.tulach@oracle.com>
parents:
diff
changeset
|
25 |
ff6f34159b8a
Providing package-info for most of API packages. Feel free to provide your package-info.java for anything that has API in its name.
Jaroslav Tulach <jaroslav.tulach@oracle.com>
parents:
diff
changeset
|
26 /** |
22235
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
27 * <h4>The Truffle Instrumentation Framework</h4> |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
28 * <p> |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
29 * This framework permits client |
22248
6d328e688339
Truffle/Instrumentation: Javadoc cleanup
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22247
diff
changeset
|
30 * {@linkplain com.oracle.truffle.api.instrument.Instrumenter.Tool tools}, |
22235
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
31 * either builtin or third-party, to observe with <em>very low overhead</em> the execution of a |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
32 * {@linkplain com.oracle.truffle.api.TruffleLanguage Truffle Language} program at the level of |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
33 * <em>AST execution events</em>: |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
34 * <ul> |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
35 * <li>a Truffle |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
36 * {@linkplain com.oracle.truffle.api.nodes.Node Node} is about to be executed, or</li> |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
37 * <li>a Truffle |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
38 * {@linkplain com.oracle.truffle.api.nodes.Node Node} execution has just completed.</li> |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
39 * </ul> |
22248
6d328e688339
Truffle/Instrumentation: Javadoc cleanup
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22247
diff
changeset
|
40 * The framework supports many kinds of tools, for example simple collectors of data such as the |
6d328e688339
Truffle/Instrumentation: Javadoc cleanup
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22247
diff
changeset
|
41 * CoverageTracker. |
22235
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
42 * It also supports Truffle's built-in |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
43 * {@linkplain com.oracle.truffle.api.debug.Debugger debugging services}, as well as utilities |
22248
6d328e688339
Truffle/Instrumentation: Javadoc cleanup
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22247
diff
changeset
|
44 * that maintain {@linkplain com.oracle.truffle.api.debug.LineToProbesMap maps of source code locations} |
22235
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
45 * for other tools such as {@linkplain com.oracle.truffle.api.debug.Debugger debugging}. |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
46 * |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
47 * <h4>Instrumentation Services</h4> |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
48 * <p> |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
49 * API access to instrumentation services is provided by the |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
50 * {@linkplain com.oracle.truffle.api.instrument.Instrumenter Instrumenter} that is part of |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
51 * the Truffle execution environment. These services fall into several categories: |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
52 * |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
53 * <ul> |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
54 * |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
55 * <li><strong>AST Markup: probing</strong> |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
56 * <ul> |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
57 * <li>Execution events can only be observed at AST locations that have been |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
58 * {@linkplain com.oracle.truffle.api.instrument.Instrumenter#probe(com.oracle.truffle.api.nodes.Node) probed}, |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
59 * which results in the creation of a |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
60 * {@linkplain com.oracle.truffle.api.instrument.Probe Probe} that is permanently associated with a |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
61 * particular segment of source code, e.g. a "statement", that corresponds to an AST location.</li> |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
62 * <li>Probing is only supported at |
22247
c1c9c6d79f40
Truffle/Instrumentation: remove method Instrumenter.isInstrumentable()
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22235
diff
changeset
|
63 * {@linkplain com.oracle.truffle.api.nodes.Node Nodes} where supported by specific language implementations.</li> |
22235
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
64 * <li>The relationship between a |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
65 * {@linkplain com.oracle.truffle.api.instrument.Probe Probe} and |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
66 * a source code location persists across Truffle <em>cloning</em> of ASTs, which is to say, a single |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
67 * {@linkplain com.oracle.truffle.api.instrument.Probe Probe} corresponds to (and keeps track of) |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
68 * the equivalent location in every clone of the original AST.</li> |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
69 * <li>Probing is specified by |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
70 * {@linkplain com.oracle.truffle.api.instrument.Instrumenter#registerASTProber(ASTProber) registering} |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
71 * an instance of |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
72 * {@linkplain com.oracle.truffle.api.instrument.ASTProber ASTProber}. |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
73 * A default prober provided by each {@linkplain com.oracle.truffle.api.TruffleLanguage TruffelLanguage} |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
74 * will be registered automatically.</li> |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
75 * <li>All AST probing must be complete before any AST execution has started.</li> |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
76 * </ul></li> |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
77 * |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
78 * <li><strong>AST Markup: tagging</strong> |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
79 * <ul> |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
80 * <li>Additional information can be added at any time to a |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
81 * {@linkplain com.oracle.truffle.api.instrument.Probe Probe} by |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
82 * {@linkplain com.oracle.truffle.api.instrument.Probe#tagAs(SyntaxTag, Object) adding} to its set of |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
83 * {@linkplain com.oracle.truffle.api.instrument.SyntaxTag tags}.</li> |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
84 * |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
85 * <li>{@linkplain com.oracle.truffle.api.instrument.StandardSyntaxTag Standard tags} should |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
86 * be used for common, language-agnostic concepts such as |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
87 * {@linkplain com.oracle.truffle.api.instrument.StandardSyntaxTag#STATEMENT STATEMENT}, and this |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
88 * is usually done by each language's default |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
89 * {@linkplain com.oracle.truffle.api.instrument.ASTProber ASTProber} while |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
90 * {@linkplain com.oracle.truffle.api.instrument.Probe Probes} are being created.</li> |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
91 * <li>{@linkplain com.oracle.truffle.api.instrument.SyntaxTag Tags} serve to configure the behavior |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
92 * of clients during program execution. For example, knowing which |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
93 * {@linkplain com.oracle.truffle.api.instrument.Probe Probes} are on |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
94 * {@linkplain com.oracle.truffle.api.instrument.StandardSyntaxTag#STATEMENT STATEMENT nodes} |
22248
6d328e688339
Truffle/Instrumentation: Javadoc cleanup
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22247
diff
changeset
|
95 * informs both the CoverageTracker and the |
22235
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
96 * {@linkplain com.oracle.truffle.api.debug.Debugger debugger} while "stepping".</li> |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
97 * <li>{@linkplain com.oracle.truffle.api.instrument.SyntaxTag tags} can also be added at any |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
98 * time by any client for any purpose, including private |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
99 * {@linkplain com.oracle.truffle.api.instrument.SyntaxTag Tags} about which other clients |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
100 * can learn nothing.</li> |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
101 * </ul></li> |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
102 * |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
103 * <li><strong>Markup Discovery: finding probes</strong> |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
104 * <ul> |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
105 * <li>Clients can be observe {@linkplain com.oracle.truffle.api.instrument.Probe Probes} |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
106 * being {@linkplain com.oracle.truffle.api.instrument.Instrumenter#probe(com.oracle.truffle.api.nodes.Node) created} and |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
107 * {@linkplain com.oracle.truffle.api.instrument.SyntaxTag Tags} being |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
108 * {@linkplain com.oracle.truffle.api.instrument.Probe#tagAs(SyntaxTag, Object) added} by |
22248
6d328e688339
Truffle/Instrumentation: Javadoc cleanup
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22247
diff
changeset
|
109 * {@linkplain com.oracle.truffle.api.instrument.Instrumenter#addProbeListener(ProbeListener) registering} a |
6d328e688339
Truffle/Instrumentation: Javadoc cleanup
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22247
diff
changeset
|
110 * {@linkplain com.oracle.truffle.api.instrument.ProbeListener ProbeListener}.</li> |
22235
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
111 * <li>Clients can also |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
112 * {@linkplain com.oracle.truffle.api.instrument.Instrumenter#findProbesTaggedAs(SyntaxTag) find} all existing |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
113 * {@linkplain com.oracle.truffle.api.instrument.Probe Probes}, possibly filtering the search by |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
114 * {@linkplain com.oracle.truffle.api.instrument.SyntaxTag tag}.</li> |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
115 * </ul></li> |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
116 * |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
117 * <li><strong>Observing Execution: event listening:</strong> |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
118 * <ul> |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
119 * <li>Clients can be notified of <em>AST execution events</em> by creating one of several kinds of |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
120 * <em>event listener</em> and <em>attaching</em> it to a |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
121 * {@linkplain com.oracle.truffle.api.instrument.Probe Probe}. This creates an |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
122 * {@linkplain com.oracle.truffle.api.instrument.Instrument Instrument} that notifies the listener |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
123 * of every subsequent execution event at the AST location corresponding to the |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
124 * {@linkplain com.oracle.truffle.api.instrument.Probe Probe}.</li> |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
125 * <li>An |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
126 * {@linkplain com.oracle.truffle.api.instrument.Instrument Instrument} can be |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
127 * {@linkplain com.oracle.truffle.api.instrument.Instrument#dispose() disposed}, at which time |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
128 * it is removed from service at every clone of the AST, incurs no further overhead, and is |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
129 * permanently unusable.</li> |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
130 * <li>Many clients need only implement a |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
131 * {@linkplain com.oracle.truffle.api.instrument.SimpleInstrumentListener SimpleInstrumentListener}, |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
132 * whose notification methods provide only the instance of the |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
133 * {@linkplain com.oracle.truffle.api.instrument.Probe Probe} to which it was attached. This |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
134 * provides access to the corresponding |
22248
6d328e688339
Truffle/Instrumentation: Javadoc cleanup
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22247
diff
changeset
|
135 * {@linkplain com.oracle.truffle.api.source.SourceSection source code location} and any |
22235
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
136 * {@linkplain com.oracle.truffle.api.instrument.SyntaxTag tags} that had been applied there.</li> |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
137 * <li>Clients that require deeper access to execution state implement a |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
138 * {@linkplain com.oracle.truffle.api.instrument.StandardInstrumentListener StandardInstrumentListener} |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
139 * whose notification methods provide access to the concrete |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
140 * {@linkplain com.oracle.truffle.api.nodes.Node AST location} and current |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
141 * {@linkplain com.oracle.truffle.api.frame.Frame stack frame}.</li> |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
142 * <li>Clients can also create an |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
143 * {@linkplain com.oracle.truffle.api.instrument.Instrument Instrument} (whose design is currently |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
144 * under revision) that supports (effectively) inserting a Truffle AST fragment into the AST |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
145 * location, where it will be executed subject to full Truffle optimization.</li> |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
146 * </ul></li> |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
147 * |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
148 * <li><strong>Wide-area Instrumentation: traps</strong> |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
149 * <ul> |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
150 * <li>A specialized form of Instrumentation is provided that efficiently attaches a single |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
151 * listener called a |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
152 * {@linkplain com.oracle.truffle.api.instrument.SyntaxTagTrap tag trap} to every |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
153 * {@linkplain com.oracle.truffle.api.instrument.Probe Probe} containing a specified |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
154 * {@linkplain com.oracle.truffle.api.instrument.SyntaxTag tag}.</li> |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
155 * <li>One (but no more than one) |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
156 * {@linkplain com.oracle.truffle.api.instrument.SyntaxTagTrap tag trap} may optionally be set |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
157 * to be notified <em>before</em> every <em>AST execution event</em> where the specified |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
158 * {@linkplain com.oracle.truffle.api.instrument.SyntaxTag tag} is present.</li> |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
159 * <li>One (but no more than one) |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
160 * {@linkplain com.oracle.truffle.api.instrument.SyntaxTagTrap tag trap} may optionally be set |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
161 * to be notified <em>after</em> every <em>AST execution event</em> where the specified |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
162 * {@linkplain com.oracle.truffle.api.instrument.SyntaxTag tag} is present.</li> |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
163 * <li>The |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
164 * {@linkplain com.oracle.truffle.api.instrument.SyntaxTagTrap tag trap} mechanism is independent |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
165 * of listeners that may be attached to |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
166 * {@linkplain com.oracle.truffle.api.instrument.Probe Probe}. It is especially valuable for |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
167 * applications such as the debugger, where during "stepping" the program should be halted at |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
168 * any node tagged with |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
169 * {@linkplain com.oracle.truffle.api.instrument.StandardSyntaxTag#STATEMENT STATEMENT}.</li> |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
170 * </ul></li> |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
171 * |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
172 * <li><strong>Data Gathering Utilities: tools</strong> |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
173 * <ul> |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
174 * <li>The Instrumentation Framework supports extensible set of utilities that can be |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
175 * {@linkplain com.oracle.truffle.api.instrument.Instrumenter#install(com.oracle.truffle.api.instrument.Instrumenter.Tool) |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
176 * installed}, at which time they start collecting information that can be queried at any time.</li> |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
177 * <li>Once installed, these |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
178 * {@linkplain com.oracle.truffle.api.instrument.Instrumenter.Tool tools} can be dynamically |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
179 * {@linkplain com.oracle.truffle.api.instrument.Instrumenter.Tool#setEnabled(boolean) disabled and re-enabled} and eventually |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
180 * {@linkplain com.oracle.truffle.api.instrument.Instrumenter.Tool#dispose() disposed} when no longer needed.</li> |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
181 * <li>A useful example is the |
22248
6d328e688339
Truffle/Instrumentation: Javadoc cleanup
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22247
diff
changeset
|
182 * {@linkplain com.oracle.truffle.api.debug.LineToProbesMap LineToProbesMap}, which incrementally builds and maintains a map of |
22235
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
183 * {@linkplain com.oracle.truffle.api.instrument.Probe Probes} indexed by |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
184 * {@linkplain com.oracle.truffle.api.source.LineLocation source code line}. Truffle |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
185 * {@linkplain com.oracle.truffle.api.debug.Debugger debugging services} depend heavily on this utility.</li> |
22248
6d328e688339
Truffle/Instrumentation: Javadoc cleanup
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22247
diff
changeset
|
186 * <li>The CoverageTracker maintains counts of execution events where a |
22235
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
187 * {@linkplain com.oracle.truffle.api.instrument.Probe Probe} has been tagged with |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
188 * {@linkplain com.oracle.truffle.api.instrument.StandardSyntaxTag#STATEMENT STATEMENT}, indexed by source code line.</li> |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
189 * </ul></li> |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
190 * </ul> |
e110ab9f91fe
Truffle/Instrumentation: package-info for com.oracle.truffle.api.instrument
Michael Van De Vanter <michael.van.de.vanter@oracle.com>
parents:
22004
diff
changeset
|
191 * |
21972
ff6f34159b8a
Providing package-info for most of API packages. Feel free to provide your package-info.java for anything that has API in its name.
Jaroslav Tulach <jaroslav.tulach@oracle.com>
parents:
diff
changeset
|
192 */ |
ff6f34159b8a
Providing package-info for most of API packages. Feel free to provide your package-info.java for anything that has API in its name.
Jaroslav Tulach <jaroslav.tulach@oracle.com>
parents:
diff
changeset
|
193 package com.oracle.truffle.api.instrument; |
ff6f34159b8a
Providing package-info for most of API packages. Feel free to provide your package-info.java for anything that has API in its name.
Jaroslav Tulach <jaroslav.tulach@oracle.com>
parents:
diff
changeset
|
194 |