com.oracle.svm.core.deopt

Class DeoptimizedFrame

java.lang.Object

com.oracle.svm.core.deopt.DeoptimizedFrame

public final class DeoptimizedFrame
extends Object

The handle to a deoptimized frame. It contains all stack entries which are written to the frame of the deopt target method(s). For details see Deoptimizer.

In addition to the instance fields, the DeoptimizedFrame also has same reserved space for the return value registers. This is used by Deoptimizer.deoptStub(com.oracle.svm.core.deopt.DeoptimizedFrame) for restoring the original return values.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	DeoptimizedFrame.ReserveDeoptScratchSpace Used to let the universe builder reserve some space in the instance layout for storing return value registers.
static class	DeoptimizedFrame.VirtualFrame Heap-based representation of a future baseline-compiled stack frame, i.e., the intermediate representation between deoptimization of an optimized frame and the stack-frame rewriting.

Method Summary

Modifier and Type	Method and Description
protected void	buildContent(org.graalvm.word.Pointer newSp) Fills the target content from the virtual frame information.
protected static DeoptimizedFrame	factory(int targetContentSize, long sourceEncodedFrameSize, SubstrateInstalledCode sourceInstalledCode, DeoptimizedFrame.VirtualFrame topFrame, com.oracle.svm.core.deopt.DeoptimizedFrame.RelockObjectData[] relockedObjects, org.graalvm.nativeimage.c.function.CodePointer sourcePC)
org.graalvm.nativeimage.PinnedObject	getPin() Returns the PinnedObject that ensures that this DeoptimizedFrame is not moved by the GC.
static int	getScratchSpaceOffset() Returns the offset of the scratch space in the object.
long	getSourceEncodedFrameSize() The frame size of the deoptimized method.
SubstrateInstalledCode	getSourceInstalledCode() Returns the InstalledCode of the deoptimized method, or null.
org.graalvm.nativeimage.c.function.CodePointer	getSourcePC() The code address inside the source method (= the method to deoptimize).
long	getSourceTotalFrameSize()
protected com.oracle.svm.core.deopt.Deoptimizer.TargetContent	getTargetContent() The new stack content for the target methods.
DeoptimizedFrame.VirtualFrame	getTopFrame() The top frame, i.e., the innermost callee of the inlining hierarchy.
void	takeException() Rewrites the first return address entry to the exception handler.

Methods inherited from class java.lang.Object

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

Method Detail

getScratchSpaceOffset

public static int getScratchSpaceOffset()

Returns the offset of the scratch space in the object.

factory

protected static DeoptimizedFrame factory(int targetContentSize,
                                          long sourceEncodedFrameSize,
                                          SubstrateInstalledCode sourceInstalledCode,
                                          DeoptimizedFrame.VirtualFrame topFrame,
                                          com.oracle.svm.core.deopt.DeoptimizedFrame.RelockObjectData[] relockedObjects,
                                          org.graalvm.nativeimage.c.function.CodePointer sourcePC)

getSourceEncodedFrameSize

public long getSourceEncodedFrameSize()

The frame size of the deoptimized method. This is the size of the physical stack frame that is still present on the stack until the actual stack frame rewriting happens.

getSourceTotalFrameSize

public long getSourceTotalFrameSize()

getSourceInstalledCode

public SubstrateInstalledCode getSourceInstalledCode()

Returns the InstalledCode of the deoptimized method, or null. If a runtime compiled method has been invalidated, the InstalledCode is no longer available. No InstalledCode is available for native image methods (which are only deoptimized during deoptimization testing).

getTopFrame

public DeoptimizedFrame.VirtualFrame getTopFrame()

The top frame, i.e., the innermost callee of the inlining hierarchy.

getTargetContent

protected com.oracle.svm.core.deopt.Deoptimizer.TargetContent getTargetContent()

The new stack content for the target methods. In the second step of deoptimization this content is built from the entries of DeoptimizedFrame.VirtualFrames.

getPin

public org.graalvm.nativeimage.PinnedObject getPin()

Returns the PinnedObject that ensures that this DeoptimizedFrame is not moved by the GC. The DeoptimizedFrame is accessed during GC when walking the stack.

getSourcePC

public org.graalvm.nativeimage.c.function.CodePointer getSourcePC()

The code address inside the source method (= the method to deoptimize).

buildContent

protected void buildContent(org.graalvm.word.Pointer newSp)

Fills the target content from the virtual frame information. This method must be uninterruptible.

Parameters:

newSp - the new stack pointer where execution will eventually continue

takeException

public void takeException()

Rewrites the first return address entry to the exception handler. This lets the deoptimization stub return to the exception handler instead of the regular return address of the deoptimization target.