com.oracle.graal.compiler.common.spi

Interface ForeignCallLinkage

All Superinterfaces:

InvokeTarget

All Known Subinterfaces:

HotSpotForeignCallLinkage

All Known Implementing Classes:

HotSpotForeignCallLinkageImpl

public interface ForeignCallLinkage
extends InvokeTarget

The runtime specific details of a foreign call.

Method Summary

Modifier and Type	Method and Description
boolean	destroysRegisters() Determines if the foreign call target destroys all registers.
ForeignCallDescriptor	getDescriptor()
CallingConvention	getIncomingCallingConvention() Gets the details of where parameters are passed and value(s) are returned from the callee's perspective.
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.
Value[]	getTemporaries() Gets the values used/killed by this foreign call.
boolean	needsDebugInfo() Determines if debug info needs to be associated with this call.

Method Detail

getOutgoingCallingConvention

CallingConvention getOutgoingCallingConvention()

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

getIncomingCallingConvention

CallingConvention getIncomingCallingConvention()

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

getMaxCallTargetOffset

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. Intended for determining the required size of address/offset fields.

getDescriptor

ForeignCallDescriptor getDescriptor()

getTemporaries

Value[] getTemporaries()

Gets the values used/killed by this foreign call.

destroysRegisters

boolean destroysRegisters()

Determines if the foreign call target destroys all registers.

Returns:

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

needsDebugInfo

boolean needsDebugInfo()

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.