com.oracle.graal.hotspot

Class HotSpotForeignCallLinkageImpl

java.lang.Object

jdk.internal.jvmci.hotspot.HotSpotForeignCallTarget

com.oracle.graal.hotspot.HotSpotForeignCallLinkageImpl

All Implemented Interfaces:

ForeignCallLinkage, HotSpotForeignCallLinkage, HotSpotProxified, InvokeTarget

public class HotSpotForeignCallLinkageImpl
extends HotSpotForeignCallTarget
implements HotSpotForeignCallLinkage, HotSpotProxified

The details required to link a HotSpot runtime or stub call.

Nested Class Summary

Nested classes/interfaces inherited from interface com.oracle.graal.hotspot.HotSpotForeignCallLinkage

HotSpotForeignCallLinkage.RegisterEffect, HotSpotForeignCallLinkage.Transition

Field Summary

Fields

Modifier and Type	Field and Description
protected ForeignCallDescriptor	descriptor The descriptor of the call.
private HotSpotForeignCallLinkage.RegisterEffect	effect
private CallingConvention	incomingCallingConvention The calling convention for incoming arguments to the stub, iff this call uses a compiled stub.
private LocationIdentity[]	killedLocations The memory locations killed by the call.
private CallingConvention	outgoingCallingConvention The calling convention for this call.
private boolean	reexecutable
private Stub	stub Non-null (eventually) iff this is a call to a compiled stub.
private Value[]	temporaries The registers and stack slots defined/killed by the call.
private HotSpotForeignCallLinkage.Transition	transition

Fields inherited from class jdk.internal.jvmci.hotspot.HotSpotForeignCallTarget

address

Fields inherited from interface com.oracle.graal.hotspot.HotSpotForeignCallLinkage

JUMP_ADDRESS

Constructor Summary

Constructors

Constructor and Description
HotSpotForeignCallLinkageImpl(ForeignCallDescriptor descriptor, long address, HotSpotForeignCallLinkage.RegisterEffect effect, HotSpotForeignCallLinkage.Transition transition, CallingConvention outgoingCallingConvention, CallingConvention incomingCallingConvention, boolean reexecutable, LocationIdentity... killedLocations)

Method Summary

Modifier and Type	Method and Description
private static JavaType	asJavaType(Class<?> type, MetaAccessProvider metaAccess, CodeCacheProvider codeCache)
static HotSpotForeignCallLinkage	create(MetaAccessProvider metaAccess, CodeCacheProvider codeCache, HotSpotForeignCallsProvider foreignCalls, ForeignCallDescriptor descriptor, long address, HotSpotForeignCallLinkage.RegisterEffect effect, CallingConvention.Type outgoingCcType, CallingConvention.Type incomingCcType, HotSpotForeignCallLinkage.Transition transition, boolean reexecutable, LocationIdentity... killedLocations) Creates a HotSpotForeignCallLinkage.
static CallingConvention	createCallingConvention(MetaAccessProvider metaAccess, CodeCacheProvider codeCache, ForeignCallDescriptor descriptor, CallingConvention.Type ccType) Gets a calling convention for a given descriptor and call type.
boolean	destroysRegisters() Determines if the foreign call target destroys all registers.
void	finalizeAddress(Backend backend)
long	getAddress()
ForeignCallDescriptor	getDescriptor()
CallingConvention	getIncomingCallingConvention() Gets the details of where parameters are passed and value(s) are returned from the callee's perspective.
LocationIdentity[]	getKilledLocations()
long	getMaxCallTargetOffset() Returns the maximum absolute offset of PC relative call to this stub from any position in the code cache or -1 when not applicable.
CallingConvention	getOutgoingCallingConvention() Gets the details of where parameters are passed and value(s) are returned from the caller's perspective.
String	getSymbol() Gets the VM symbol associated with the target address of the call.
Value[]	getTemporaries() Gets the values used/killed by this foreign call.
boolean	isCompiledStub() Determines if this is a call to a compiled stub.
boolean	isReexecutable()
boolean	mayContainFP() Determines if the runtime function or stub might use floating point registers.
boolean	needsDebugInfo() Determines if debug info needs to be associated with this call.
boolean	needsJavaFrameAnchor() Determines if a JavaFrameAnchor needs to be set up and torn down around this call.
void	setCompiledStub(Stub stub)
String	toString()

Methods inherited from class java.lang.Object

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

Field Detail

descriptor

protected final ForeignCallDescriptor descriptor

The descriptor of the call.

stub

private Stub stub

Non-null (eventually) iff this is a call to a compiled stub.

outgoingCallingConvention

private final CallingConvention outgoingCallingConvention

The calling convention for this call.

incomingCallingConvention

private final CallingConvention incomingCallingConvention

The calling convention for incoming arguments to the stub, iff this call uses a compiled stub.

effect

private final HotSpotForeignCallLinkage.RegisterEffect effect

transition

private final HotSpotForeignCallLinkage.Transition transition

temporaries

private Value[] temporaries

The registers and stack slots defined/killed by the call.

killedLocations

private final LocationIdentity[] killedLocations

The memory locations killed by the call.

reexecutable

private final boolean reexecutable

Constructor Detail

HotSpotForeignCallLinkageImpl

public HotSpotForeignCallLinkageImpl(ForeignCallDescriptor descriptor,
                                     long address,
                                     HotSpotForeignCallLinkage.RegisterEffect effect,
                                     HotSpotForeignCallLinkage.Transition transition,
                                     CallingConvention outgoingCallingConvention,
                                     CallingConvention incomingCallingConvention,
                                     boolean reexecutable,
                                     LocationIdentity... killedLocations)

Method Detail

create

public static HotSpotForeignCallLinkage create(MetaAccessProvider metaAccess,
                                               CodeCacheProvider codeCache,
                                               HotSpotForeignCallsProvider foreignCalls,
                                               ForeignCallDescriptor descriptor,
                                               long address,
                                               HotSpotForeignCallLinkage.RegisterEffect effect,
                                               CallingConvention.Type outgoingCcType,
                                               CallingConvention.Type incomingCcType,
                                               HotSpotForeignCallLinkage.Transition transition,
                                               boolean reexecutable,
                                               LocationIdentity... killedLocations)

Creates a HotSpotForeignCallLinkage.

Parameters:

descriptor - the descriptor of the call

address - the address of the code to call

effect - specifies if the call destroys or preserves all registers (apart from temporaries which are always destroyed)

outgoingCcType - outgoing (caller) calling convention type

incomingCcType - incoming (callee) calling convention type (can be null)

transition - specifies if this is a leaf call

reexecutable - specifies if the call can be re-executed without (meaningful) side effects. Deoptimization will not return to a point before a call that cannot be re-executed.

killedLocations - the memory locations killed by the call

createCallingConvention

public static CallingConvention createCallingConvention(MetaAccessProvider metaAccess,
                                                        CodeCacheProvider codeCache,
                                                        ForeignCallDescriptor descriptor,
                                                        CallingConvention.Type ccType)

Gets a calling convention for a given descriptor and call type.

asJavaType

private static JavaType asJavaType(Class<?> type,
                                   MetaAccessProvider metaAccess,
                                   CodeCacheProvider codeCache)

toString

public String toString()

Overrides:

toString in class Object

isReexecutable

public boolean isReexecutable()

Specified by:

isReexecutable in interface HotSpotForeignCallLinkage

getKilledLocations

public LocationIdentity[] getKilledLocations()

Specified by:

getKilledLocations in interface HotSpotForeignCallLinkage

getOutgoingCallingConvention

public CallingConvention getOutgoingCallingConvention()

Description copied from interface: ForeignCallLinkage

Gets the details of where parameters are passed and value(s) are returned from the caller's perspective.

Specified by:

getOutgoingCallingConvention in interface ForeignCallLinkage

getIncomingCallingConvention

public CallingConvention getIncomingCallingConvention()

Description copied from interface: ForeignCallLinkage

Gets the details of where parameters are passed and value(s) are returned from the callee's perspective.

Specified by:

getIncomingCallingConvention in interface ForeignCallLinkage

getTemporaries

public Value[] getTemporaries()

Description copied from interface: ForeignCallLinkage

Gets the values used/killed by this foreign call.

Specified by:

getTemporaries in interface ForeignCallLinkage

getMaxCallTargetOffset

public long getMaxCallTargetOffset()

Description copied from interface: ForeignCallLinkage

Returns the maximum absolute offset of PC relative call to this stub from any position in the code cache or -1 when not applicable. Intended for determining the required size of address/offset fields.

Specified by:

getMaxCallTargetOffset in interface ForeignCallLinkage

getDescriptor

public ForeignCallDescriptor getDescriptor()

Specified by:

getDescriptor in interface ForeignCallLinkage

setCompiledStub

public void setCompiledStub(Stub stub)

Specified by:

setCompiledStub in interface HotSpotForeignCallLinkage

isCompiledStub

public boolean isCompiledStub()

Determines if this is a call to a compiled stub.

Specified by:

isCompiledStub in interface HotSpotForeignCallLinkage

finalizeAddress

public void finalizeAddress(Backend backend)

Specified by:

finalizeAddress in interface HotSpotForeignCallLinkage

getAddress

public long getAddress()

Specified by:

getAddress in interface HotSpotForeignCallLinkage

destroysRegisters

public boolean destroysRegisters()

Description copied from interface: ForeignCallLinkage

Determines if the foreign call target destroys all registers.

Specified by:

destroysRegisters in interface ForeignCallLinkage

Returns:

true if the register allocator must save all live registers around a call to this target

needsDebugInfo

public boolean needsDebugInfo()

Description copied from interface: ForeignCallLinkage

Determines if debug info needs to be associated with this call. Debug info is required if the function can raise an exception, try to lock, trigger GC or do anything else that requires the VM to be able to inspect the thread's execution state.

Specified by:

needsDebugInfo in interface ForeignCallLinkage

mayContainFP

public boolean mayContainFP()

Description copied from interface: HotSpotForeignCallLinkage

Determines if the runtime function or stub might use floating point registers. If the answer is no, then no FPU state management prologue or epilogue needs to be emitted around the call.

Specified by:

mayContainFP in interface HotSpotForeignCallLinkage

needsJavaFrameAnchor

public boolean needsJavaFrameAnchor()

Description copied from interface: HotSpotForeignCallLinkage

Determines if a JavaFrameAnchor needs to be set up and torn down around this call.

Specified by:

needsJavaFrameAnchor in interface HotSpotForeignCallLinkage

getSymbol

public String getSymbol()

Description copied from interface: HotSpotForeignCallLinkage

Gets the VM symbol associated with the target address of the call.

Specified by:

getSymbol in interface HotSpotForeignCallLinkage