org.graalvm.compiler.hotspot.stubs

Class ForeignCallStub

java.lang.Object

org.graalvm.compiler.hotspot.stubs.Stub

org.graalvm.compiler.hotspot.stubs.AbstractForeignCallStub

org.graalvm.compiler.hotspot.stubs.ForeignCallStub

public class ForeignCallStub
extends AbstractForeignCallStub

A generated stub for a non-leaf foreign call from compiled code. A stub is required for such calls as the caller may be scheduled for deoptimization while the call is in progress. And since these are foreign/runtime calls on slow paths, we don't want to force the register allocator to spill around the call. As such, this stub saves and restores all allocatable registers. It also handles any exceptions raised during the foreign call.

Field Summary

Fields inherited from class org.graalvm.compiler.hotspot.stubs.AbstractForeignCallStub

jvmciRuntime, prependThread, target

Fields inherited from class org.graalvm.compiler.hotspot.stubs.Stub

code, linkage, options, providers

Constructor Summary

Constructors

Constructor and Description
ForeignCallStub(OptionValues options, HotSpotJVMCIRuntime runtime, HotSpotProviders providers, long address, HotSpotForeignCallDescriptor descriptor, boolean prependThread) Creates a stub for a call to code at a given address.

Method Summary

Modifier and Type	Method and Description
protected ValueNode	createTargetCall(GraphKit kit, ReadRegisterNode thread)
protected HotSpotForeignCallDescriptor	getTargetSignature(HotSpotForeignCallDescriptor descriptor)
protected boolean	returnsObject()
protected boolean	shouldClearException()

Methods inherited from class org.graalvm.compiler.hotspot.stubs.AbstractForeignCallStub

createParameters, debugScopeContext, getGraph, getInstalledCodeOwner, getTargetLinkage

Methods inherited from class org.graalvm.compiler.hotspot.stubs.Stub

checkSafeDataReference, createLIRSuites, createSuites, getCode, getCompilationResult, getDestroyedCallerRegisters, getLinkage, getRegisterConfig, getStubCompilationId, initDestroyedCallerRegisters, shouldSaveRegistersAroundCalls, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

ForeignCallStub

public ForeignCallStub(OptionValues options,
                       HotSpotJVMCIRuntime runtime,
                       HotSpotProviders providers,
                       long address,
                       HotSpotForeignCallDescriptor descriptor,
                       boolean prependThread)

Creates a stub for a call to code at a given address.

Parameters:

address - the address of the code to call

descriptor - the signature of the call to this stub

prependThread - true if the JavaThread value for the current thread is to be prepended to the arguments for the call to address

Method Detail

getTargetSignature

protected HotSpotForeignCallDescriptor getTargetSignature(HotSpotForeignCallDescriptor descriptor)

Specified by:

getTargetSignature in class AbstractForeignCallStub

returnsObject

protected boolean returnsObject()

Specified by:

returnsObject in class AbstractForeignCallStub

shouldClearException

protected boolean shouldClearException()

Specified by:

shouldClearException in class AbstractForeignCallStub

createTargetCall

protected ValueNode createTargetCall(GraphKit kit,
                                     ReadRegisterNode thread)

Specified by:

createTargetCall in class AbstractForeignCallStub