org.graalvm.compiler.hotspot.meta

Enum HotSpotForeignCallDescriptor.Transition

java.lang.Object

java.lang.Enum<HotSpotForeignCallDescriptor.Transition>

org.graalvm.compiler.hotspot.meta.HotSpotForeignCallDescriptor.Transition

All Implemented Interfaces:

Serializable, Comparable<HotSpotForeignCallDescriptor.Transition>

Enclosing class:

HotSpotForeignCallDescriptor

public static enum HotSpotForeignCallDescriptor.Transition
extends Enum<HotSpotForeignCallDescriptor.Transition>

Constants for specifying whether a call is a leaf or not and whether a JavaFrameAnchor prologue and epilogue is required around the call. A leaf function does not lock, GC or throw exceptions.

Enum Constant Summary

Enum Constants

Enum Constant and Description
LEAF A call to a leaf function that might use floating point registers but will never have its caller stack inspected.
LEAF_NO_VZERO A call to a leaf function that is guaranteed to not use floating point registers.
SAFEPOINT A function that may lock, GC or raise an exception and thus requires debug info to be associated with a call site to the function.
STACK_INSPECTABLE_LEAF A call to a leaf function that might use floating point registers and may have its caller stack inspected.

Method Summary

Modifier and Type	Method and Description
static HotSpotForeignCallDescriptor.Transition	valueOf(String name) Returns the enum constant of this type with the specified name.
static HotSpotForeignCallDescriptor.Transition[]	values() Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum

clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Detail

LEAF_NO_VZERO

public static final HotSpotForeignCallDescriptor.Transition LEAF_NO_VZERO

A call to a leaf function that is guaranteed to not use floating point registers. Consequently, floating point registers cleanup will be waived. On AMD64, this means the compiler will no longer emit vzeroupper instruction around the foreign call, which it normally does for unknown foreign calls to avoid potential SSE-AVX transition penalty. Besides, this foreign call will never have its caller stack inspected by the VM. That is, JavaFrameAnchor management around the call can be omitted.

LEAF

public static final HotSpotForeignCallDescriptor.Transition LEAF

A call to a leaf function that might use floating point registers but will never have its caller stack inspected. That is, JavaFrameAnchor management around the call can be omitted.

STACK_INSPECTABLE_LEAF

public static final HotSpotForeignCallDescriptor.Transition STACK_INSPECTABLE_LEAF

A call to a leaf function that might use floating point registers and may have its caller stack inspected. That is, JavaFrameAnchor management code around the call is required.

SAFEPOINT

public static final HotSpotForeignCallDescriptor.Transition SAFEPOINT

A function that may lock, GC or raise an exception and thus requires debug info to be associated with a call site to the function. The execution stack may be inspected while in the called function. That is, JavaFrameAnchor management code around the call is required.

Method Detail

values

public static HotSpotForeignCallDescriptor.Transition[] values()

Returns:

an array containing the constants of this enum type, in the order they are declared

valueOf

public static HotSpotForeignCallDescriptor.Transition valueOf(String name)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

IllegalArgumentException - if this enum type has no constant with the specified name

NullPointerException - if the argument is null