org.graalvm.compiler.truffle.runtime.hotspot

Class AbstractHotSpotTruffleRuntime

java.lang.Object

org.graalvm.compiler.truffle.runtime.GraalTruffleRuntime

org.graalvm.compiler.truffle.runtime.hotspot.AbstractHotSpotTruffleRuntime

All Implemented Interfaces:

com.oracle.truffle.api.TruffleRuntime, HotSpotTruffleCompilerRuntime, TruffleCompilerRuntime

public abstract class AbstractHotSpotTruffleRuntime
extends GraalTruffleRuntime
implements HotSpotTruffleCompilerRuntime

HotSpot specific implementation of a Graal-enabled Truffle runtime. This class contains functionality for interfacing with a HotSpot-based Truffle compiler, independent of where the compiler resides (i.e., co-located in the HotSpot heap or running in a native-image shared library).

Nested Class Summary

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

GraalTruffleRuntime.KnownMethods, GraalTruffleRuntime.StackTraceHelper

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

TruffleCompilerRuntime.ConstantFieldInfo, TruffleCompilerRuntime.InlineKind, TruffleCompilerRuntime.LoopExplosionKind

Field Summary

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

knownMethods, truffleCompiler

Constructor Summary

Constructors

Constructor and Description
AbstractHotSpotTruffleRuntime()

Method Summary

Modifier and Type	Method and Description
protected <T> T	asObject(Class<T> type, JavaConstant constant)
void	bypassedInstalledCode(OptimizedCallTarget target) Notifies this runtime when a Truffle AST is being executed in the Truffle interpreter even though compiled code is available for the AST.
boolean	bypassedReservedOop(boolean waitForInit)
OptimizedCallTarget	createOptimizedCallTarget(OptimizedCallTarget source, com.oracle.truffle.api.nodes.RootNode rootNode)
SpeculationLog	createSpeculationLog() Creates a log that HotSpotSpeculationLog#managesFailedSpeculations() manages a native failed speculations list.
protected JavaConstant	forObject(Object object)
protected int	getArrayBaseOffset(Class<?> componentType)
protected int	getArrayIndexScale(Class<?> componentType)
protected int	getBaseInstanceSize(Class<?> type)
BackgroundCompileQueue	getCompileQueue()
protected String	getCompilerConfigurationName() This method allows retrieval of the compiler configuration without requiring to initialize the TruffleCompiler with getTruffleCompiler.
protected com.oracle.truffle.api.impl.AbstractFastThreadLocal	getFastThreadLocalImpl()
protected Object	getFieldValue(ResolvedJavaField resolvedJavaField, Object obj)
MethodHandle	getGetThreadLocalObject()
int	getJVMCIReservedLongOffset0()
GraalTruffleRuntime.KnownMethods	getKnownMethods()
protected int	getObjectAlignment()
protected Object[]	getResolvedFields(Class<?> type, boolean includePrimitive, boolean includeSuperclasses)
static AbstractHotSpotTruffleRuntime	getRuntime() Gets the singleton runtime instance.
MethodHandle	getSetThreadLocalObject()
protected StackIntrospection	getStackIntrospection()
long	getStackOverflowLimit()
com.oracle.truffle.api.impl.ThreadLocalHandshake	getThreadLocalHandshake()
HotSpotTruffleCompiler	getTruffleCompiler(CompilableTruffleAST compilable) Gets the primary TruffleCompiler instance associated with this runtime, creating and initializing it in a thread-safe manner first if necessary.
protected abstract String	initLazyCompilerConfigurationName() Gets the compiler configuration name without requiring a compiler to be created.
boolean	isLatestJVMCI()
boolean	isProfilingEnabled()
void	notifyTransferToInterpreter()
void	onCodeInstallation(CompilableTruffleAST compilable, InstalledCode installedCode) Notifies this runtime once installedCode has been installed in the code cache.
void	resetCompiler()
static void	setDontInlineCallBoundaryMethod(List<ResolvedJavaMethod> callBoundaryMethods)

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

addListener, asCompilableTruffleAST, clearState, compilationThresholdScale, createAssumption, createAssumption, createDirectCallNode, createIndirectCallNode, createLoopNode, createMaterializedFrame, createMaterializedFrame, createVirtualFrame, doCompile, doCompile, finishCompilation, getCallTargetForCallNode, getCapability, getCompilationQueueSize, getCompilerIdleDelay, getConstantFieldInfo, getEngineCacheSupport, getEngineData, getFrameMaterializeCalled, getFrameSlotKindTagForJavaKind, getFrameSlotKindTagsCount, getInlineKind, getJavaKindForFrameSlotKind, getListener, getLookupTypes, getLoopExplosionKind, getLoopNodeFactory, getName, getOptionsForCompiler, getTestTvmci, getTvmci, initializeKnownMethods, installDefaultListeners, isBytecodeInterpreterSwitch, isBytecodeInterpreterSwitchBoundary, isInInterpreter, isInlineable, isPrintGraphEnabled, isSpecializationMethod, isSuppressedFailure, isSuppressedTruffleRuntimeException, isTransferToInterpreterMethod, isTruffleBoundary, isValueType, iterateFrames, log, markFrameMaterializeCalled, newTruffleCompiler, openCompilerThreadScope, printStackTraceToString, registerOptimizedAssumptionDependency, removeListener, resolveType, searchMethod, submitForCompilation, waitForCompilation

Methods inherited from class java.lang.Object

clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

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

asCompilableTruffleAST, formatEvent, getCallTargetForCallNode, getConstantFieldInfo, getFrameSlotKindTagForJavaKind, getFrameSlotKindTagsCount, getGraalOptions, getInlineKind, getJavaKindForFrameSlotKind, getLoopExplosionKind, getRuntimeIfAvailable, isBytecodeInterpreterSwitch, isBytecodeInterpreterSwitchBoundary, isInInterpreter, isInlineable, isSpecializationMethod, isSuppressedFailure, isTransferToInterpreterMethod, isTruffleBoundary, isValueType, log, log, logEvent, logEvent, registerOptimizedAssumptionDependency, resolveType, resolveType

Methods inherited from interface com.oracle.truffle.api.TruffleRuntime

iterateFrames

Constructor Detail

AbstractHotSpotTruffleRuntime

public AbstractHotSpotTruffleRuntime()

Method Detail

getJVMCIReservedLongOffset0

public final int getJVMCIReservedLongOffset0()

getThreadLocalHandshake

public final com.oracle.truffle.api.impl.ThreadLocalHandshake getThreadLocalHandshake()

Specified by:

getThreadLocalHandshake in class GraalTruffleRuntime

getStackIntrospection

protected StackIntrospection getStackIntrospection()

Specified by:

getStackIntrospection in class GraalTruffleRuntime

getTruffleCompiler

public HotSpotTruffleCompiler getTruffleCompiler(CompilableTruffleAST compilable)

Description copied from interface: TruffleCompilerRuntime

Gets the primary TruffleCompiler instance associated with this runtime, creating and initializing it in a thread-safe manner first if necessary.

Specified by:

getTruffleCompiler in interface TruffleCompilerRuntime

isLatestJVMCI

public boolean isLatestJVMCI()

Overrides:

isLatestJVMCI in class GraalTruffleRuntime

resetCompiler

public final void resetCompiler()

createOptimizedCallTarget

public final OptimizedCallTarget createOptimizedCallTarget(OptimizedCallTarget source,
                                                           com.oracle.truffle.api.nodes.RootNode rootNode)

Specified by:

createOptimizedCallTarget in class GraalTruffleRuntime

onCodeInstallation

public void onCodeInstallation(CompilableTruffleAST compilable,
                               InstalledCode installedCode)

Description copied from interface: HotSpotTruffleCompilerRuntime

Notifies this runtime once installedCode has been installed in the code cache.

Specified by:

onCodeInstallation in interface HotSpotTruffleCompilerRuntime

Parameters:

compilable - the compilable to install code into

installedCode - code that has just been installed in the code cache

createSpeculationLog

public SpeculationLog createSpeculationLog()

Creates a log that HotSpotSpeculationLog#managesFailedSpeculations() manages a native failed speculations list. An important invariant is that an nmethod compiled with this log can never be executing once the log object dies. When the log object dies, it frees the failed speculations list thus invalidating the HotSpotSpeculationLog#getFailedSpeculationsAddress() failed speculations address embedded in the nmethod. If the nmethod were to execute after this point and fail a speculation, it would append the failed speculation to the already freed list.

Truffle ensures this cannot happen as it only attaches managed speculation logs to OptimizedCallTargets and OptimizedOSRLoopNodes. Executions of nmethods compiled for an OptimizedCallTarget or OptimizedOSRLoopNode object will have a strong reference to the object (i.e., as the receiver). This guarantees that such an nmethod cannot be executing after the object has died.

Specified by:

createSpeculationLog in class GraalTruffleRuntime

setDontInlineCallBoundaryMethod

public static void setDontInlineCallBoundaryMethod(List<ResolvedJavaMethod> callBoundaryMethods)

getCompileQueue

public BackgroundCompileQueue getCompileQueue()

Specified by:

getCompileQueue in class GraalTruffleRuntime

getCompilerConfigurationName

protected String getCompilerConfigurationName()

Description copied from class: GraalTruffleRuntime

This method allows retrieval of the compiler configuration without requiring to initialize the TruffleCompiler with getTruffleCompiler. The result of this method should always match TruffleCompiler.getCompilerConfigurationName().

Specified by:

getCompilerConfigurationName in class GraalTruffleRuntime

initLazyCompilerConfigurationName

protected abstract String initLazyCompilerConfigurationName()

Gets the compiler configuration name without requiring a compiler to be created.

bypassedInstalledCode

public void bypassedInstalledCode(OptimizedCallTarget target)

Description copied from class: GraalTruffleRuntime

Notifies this runtime when a Truffle AST is being executed in the Truffle interpreter even though compiled code is available for the AST. If this runtime uses a special entry point to switch to compiled Truffle code, then this means the code with the special entry point was deoptimized or otherwise removed from the code cache and needs to be re-installed.

Overrides:

bypassedInstalledCode in class GraalTruffleRuntime

getSetThreadLocalObject

public MethodHandle getSetThreadLocalObject()

getGetThreadLocalObject

public MethodHandle getGetThreadLocalObject()

bypassedReservedOop

public boolean bypassedReservedOop(boolean waitForInit)

getKnownMethods

public GraalTruffleRuntime.KnownMethods getKnownMethods()

Overrides:

getKnownMethods in class GraalTruffleRuntime

notifyTransferToInterpreter

public final void notifyTransferToInterpreter()

Specified by:

notifyTransferToInterpreter in interface com.oracle.truffle.api.TruffleRuntime

isProfilingEnabled

public final boolean isProfilingEnabled()

Specified by:

isProfilingEnabled in interface com.oracle.truffle.api.TruffleRuntime

forObject

protected JavaConstant forObject(Object object)

Specified by:

forObject in class GraalTruffleRuntime

getBaseInstanceSize

protected int getBaseInstanceSize(Class<?> type)

Overrides:

getBaseInstanceSize in class GraalTruffleRuntime

getResolvedFields

protected Object[] getResolvedFields(Class<?> type,
                                     boolean includePrimitive,
                                     boolean includeSuperclasses)

Overrides:

getResolvedFields in class GraalTruffleRuntime

getFieldValue

protected Object getFieldValue(ResolvedJavaField resolvedJavaField,
                               Object obj)

Overrides:

getFieldValue in class GraalTruffleRuntime

getObjectAlignment

protected int getObjectAlignment()

Overrides:

getObjectAlignment in class GraalTruffleRuntime

getArrayIndexScale

protected int getArrayIndexScale(Class<?> componentType)

Overrides:

getArrayIndexScale in class GraalTruffleRuntime

getArrayBaseOffset

protected int getArrayBaseOffset(Class<?> componentType)

Overrides:

getArrayBaseOffset in class GraalTruffleRuntime

getStackOverflowLimit

public long getStackOverflowLimit()

Overrides:

getStackOverflowLimit in class GraalTruffleRuntime

asObject

protected <T> T asObject(Class<T> type,
                         JavaConstant constant)

Specified by:

asObject in class GraalTruffleRuntime

getFastThreadLocalImpl

protected com.oracle.truffle.api.impl.AbstractFastThreadLocal getFastThreadLocalImpl()

Specified by:

getFastThreadLocalImpl in class GraalTruffleRuntime

getRuntime

public static AbstractHotSpotTruffleRuntime getRuntime()

Description copied from interface: TruffleCompilerRuntime

Gets the singleton runtime instance.

Specified by:

getRuntime in interface TruffleCompilerRuntime