Mercurial > hg > graal-jvmci-8
diff graal/com.oracle.truffle.api/src/com/oracle/truffle/api/instrument/AdvancedInstrumentResultListener.java @ 21354:575032310b2c
Truffle/Instrumentation: runtime failures executing an AdvancedInstrument root are now reported automatically via a new mehtod onAdvancedInstrumentResultListener.
author | Michael Van De Vanter <michael.van.de.vanter@oracle.com> |
---|---|
date | Tue, 12 May 2015 14:48:33 -0700 |
parents | 876e710523c5 |
children | 442b57a7f208 |
line wrap: on
line diff
--- a/graal/com.oracle.truffle.api/src/com/oracle/truffle/api/instrument/AdvancedInstrumentResultListener.java Tue May 12 12:57:47 2015 -0700 +++ b/graal/com.oracle.truffle.api/src/com/oracle/truffle/api/instrument/AdvancedInstrumentResultListener.java Tue May 12 14:48:33 2015 -0700 @@ -24,6 +24,7 @@ */ package com.oracle.truffle.api.instrument; +import com.oracle.truffle.api.CompilerDirectives.TruffleBoundary; import com.oracle.truffle.api.frame.*; import com.oracle.truffle.api.nodes.*; @@ -42,7 +43,10 @@ * Notifies listener that a client-provided {@linkplain AdvancedInstrumentRoot AST fragment} has * been executed by an {@linkplain Instrument#create(AdvancedInstrumentRootFactory, String) * Advanced Instrument} with the specified result, possibly {@code null}. - * + * <p> + * <strong>Note: </strong> Truffle will attempt to optimize implementations through partial + * evaluation; annotate with {@link TruffleBoundary} if this should not be permitted. + * * @param node the guest-language AST node to which the host Instrument's {@link Probe} is * attached * @param vFrame execution frame at the guest-language AST node @@ -54,6 +58,9 @@ * Notifies listener that execution of client-provided {@linkplain AdvancedInstrumentRoot AST * fragment} filed during execution by a @linkplain * Instrument#create(AdvancedInstrumentRootFactory, String) Advanced Instrument}. + * <p> + * <strong>Note: </strong> Truffle will attempt to optimize implementations through partial + * evaluation; annotate with {@link TruffleBoundary} if this should not be permitted. * * @param node the guest-language AST node to which the host Instrument's {@link Probe} is * attached