org.graalvm.compiler.truffle.runtime.hotspot

Class HotSpotOptimizedCallTarget

java.lang.Object

org.graalvm.compiler.truffle.runtime.OptimizedCallTarget

org.graalvm.compiler.truffle.runtime.hotspot.HotSpotOptimizedCallTarget

All Implemented Interfaces:

com.oracle.truffle.api.CallTarget, com.oracle.truffle.api.ReplaceObserver, com.oracle.truffle.api.RootCallTarget, CompilableTruffleAST, OptimizedAssumptionDependency

public final class HotSpotOptimizedCallTarget
extends OptimizedCallTarget
implements OptimizedAssumptionDependency

A HotSpot specific OptimizedCallTarget whose machine code (if any) is represented by an associated InstalledCode.

Nested Class Summary

Nested classes/interfaces inherited from class org.graalvm.compiler.truffle.runtime.OptimizedCallTarget

OptimizedCallTarget.ArgumentsProfile, OptimizedCallTarget.ReturnProfile

Nested classes/interfaces inherited from interface org.graalvm.compiler.truffle.common.OptimizedAssumptionDependency

OptimizedAssumptionDependency.Access

Field Summary

Fields inherited from class org.graalvm.compiler.truffle.runtime.OptimizedCallTarget

engine, id, initialized, speculationLog

Constructor Summary

Constructors

Constructor and Description
HotSpotOptimizedCallTarget(OptimizedCallTarget sourceCallTarget, com.oracle.truffle.api.nodes.RootNode rootNode)

Method Summary

Modifier and Type	Method and Description
long	getCodeAddress() Gets the address of the machine code for this call target.
CompilableTruffleAST	getCompilable() Gets the Truffle AST whose machine code is represented by this object.
SpeculationLog	getCompilationSpeculationLog() Gets a speculation log to be used for a single Truffle compilation.
boolean	isValid() Determines if this call target has valid machine code that can be entered attached to it.
boolean	isValidLastTier() Determines if this call target has valid machine code attached to it, and that this code was compiled in the last tier.
void	onAssumptionInvalidated(Object source, CharSequence reason) Called when a depended-on assumption is invalidated, with the intention to invalidate the machine code referenced by this object.
void	setInstalledCode(InstalledCode code) This method may only be called during compilation, and only by the compiling thread.
boolean	soleExecutionEntryPoint() Determines if a reference to this object is the only way the machine code can be executed.

Methods inherited from class org.graalvm.compiler.truffle.runtime.OptimizedCallTarget

accept, asJavaConstant, calculateNonTrivialNodes, call, callBoundary, callDirect, callIndirect, callInlined, callOSR, cancelCompilation, compile, compiledTier, computeBlockCompilations, createFrame, dequeueInlined, doInvoke, ensureInitialized, equals, firstTierCall, getCallAndLoopCount, getCallCount, getCallNodes, getCallSiteForSplit, getDebugProperties, getInitializedArgumentsProfile, getInitializedReturnProfile, getInitializedTimestamp, getKnownCallSiteCount, getName, getNodeRewritingAssumptionConstant, getNonTrivialNodeCount, getOptionValue, getOptionValues, getRootNode, getSingleCallNode, getSourceCallTarget, getSpeculationLog, getValidRootAssumptionConstant, hashCode, highestCompiledTier, injectArgumentsProfile, invalidate, isInitialized, isSameOrSplit, isSingleCaller, isSourceCallTarget, isSplit, isSubmittedForCompilation, isTrivial, log, maybeWaitForTask, needsCompile, nodeReplaced, onCompilationFailed, onInvalidate, prepareForAOT, profileArguments, profiledPERoot, resetCompilationProfile, resetNeedsSplit, runtime, shouldCompile, toString, waitForCompilation, wasExecuted

Methods inherited from class java.lang.Object

clone, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.graalvm.compiler.truffle.common.CompilableTruffleAST

serializeException

Constructor Detail

HotSpotOptimizedCallTarget

public HotSpotOptimizedCallTarget(OptimizedCallTarget sourceCallTarget,
                                  com.oracle.truffle.api.nodes.RootNode rootNode)

Method Detail

soleExecutionEntryPoint

public boolean soleExecutionEntryPoint()

Description copied from interface: OptimizedAssumptionDependency

Determines if a reference to this object is the only way the machine code can be executed. If true, it means the assumption will use a weak reference to this object. Once the weak reference is cleared, assumption invalidation can ignore this object without posing the risk of invalid code remaining live.

Specified by:

soleExecutionEntryPoint in interface OptimizedAssumptionDependency

Returns:

true if the referenced machine code is guaranteed never to be executed when this object dies, false the referenced machine code can be still be executed even when this object is dead

setInstalledCode

public void setInstalledCode(InstalledCode code)

This method may only be called during compilation, and only by the compiling thread.

getCompilable

public CompilableTruffleAST getCompilable()

Description copied from interface: OptimizedAssumptionDependency

Gets the Truffle AST whose machine code is represented by this object. May be null.

Specified by:

getCompilable in interface OptimizedAssumptionDependency

isValid

public boolean isValid()

Description copied from class: OptimizedCallTarget

Determines if this call target has valid machine code that can be entered attached to it.

Specified by:

isValid in interface OptimizedAssumptionDependency

Specified by:

isValid in class OptimizedCallTarget

isValidLastTier

public boolean isValidLastTier()

Description copied from class: OptimizedCallTarget

Determines if this call target has valid machine code attached to it, and that this code was compiled in the last tier.

Specified by:

isValidLastTier in class OptimizedCallTarget

getCodeAddress

public long getCodeAddress()

Description copied from class: OptimizedCallTarget

Gets the address of the machine code for this call target. A non-zero return value denotes the contiguous memory block containing the machine code but does not necessarily represent an entry point for the machine code or even the address of executable instructions. This value is only for informational purposes (e.g., use in a log message).

Specified by:

getCodeAddress in class OptimizedCallTarget

onAssumptionInvalidated

public void onAssumptionInvalidated(Object source,
                                    CharSequence reason)

Description copied from interface: OptimizedAssumptionDependency

Called when a depended-on assumption is invalidated, with the intention to invalidate the machine code referenced by this object.

Specified by:

onAssumptionInvalidated in interface OptimizedAssumptionDependency

getCompilationSpeculationLog

public SpeculationLog getCompilationSpeculationLog()

Description copied from interface: CompilableTruffleAST

Gets a speculation log to be used for a single Truffle compilation. The returned speculation log provides access to all relevant failed speculations as well as support for making speculation during a single compilation.

Specified by:

getCompilationSpeculationLog in interface CompilableTruffleAST