ForeignCallLinkage

All Known Subinterfaces:

HotSpotForeignCallLinkage

All Known Implementing Classes:

HotSpotForeignCallLinkageImpl
```
public interface ForeignCallLinkage
```
The runtime specific details of a foreign call.

Method Summary

All Methods Instance Methods Abstract Methods Default Methods
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 a 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.
`default boolean`	`needsClearUpperVectorRegisters()` Returns true if further cleanup on the float registers is needed after performing the 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 a 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.
  - needsClearUpperVectorRegisters
```
default boolean needsClearUpperVectorRegisters()
```
    Returns true if further cleanup on the float registers is needed after performing the foreign call. This is critical on AMD64 as there is a performance penalty switching between legacy SSE and AVX instruction while the upper halves of the xmm registers are not zero.

Interface ForeignCallLinkage

Method Summary

Method Detail

getOutgoingCallingConvention

getIncomingCallingConvention

getMaxCallTargetOffset

getDescriptor

getTemporaries

destroysRegisters

needsDebugInfo

needsClearUpperVectorRegisters