com.oracle.svm.core.stack

Class ParameterizedStackFrameVisitor<T>

java.lang.Object

com.oracle.svm.core.stack.ParameterizedStackFrameVisitor<T>

Direct Known Subclasses:

StackFrameVisitor, ThreadStackPrinter.Stage0StackFramePrintVisitor

public abstract class ParameterizedStackFrameVisitor<T>
extends Object

Given access to a thread stack frame, perform some computation on it. This is a more generic version of StackFrameVisitor that allows an arbitrary object to be passed through.

Constructor Summary

Constructors

Constructor and Description
ParameterizedStackFrameVisitor()

Method Summary

Modifier and Type	Method and Description
protected abstract boolean	unknownFrame(org.graalvm.word.Pointer sp, org.graalvm.nativeimage.c.function.CodePointer ip, DeoptimizedFrame deoptimizedFrame, T data) Called when no frame metadata can be found for a frame.
protected abstract boolean	visitFrame(org.graalvm.word.Pointer sp, org.graalvm.nativeimage.c.function.CodePointer ip, CodeInfo codeInfo, DeoptimizedFrame deoptimizedFrame, T data) Called for each frame that is visited.

Methods inherited from class java.lang.Object

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

Constructor Detail

ParameterizedStackFrameVisitor

public ParameterizedStackFrameVisitor()

Method Detail

visitFrame

protected abstract boolean visitFrame(org.graalvm.word.Pointer sp,
                                      org.graalvm.nativeimage.c.function.CodePointer ip,
                                      CodeInfo codeInfo,
                                      DeoptimizedFrame deoptimizedFrame,
                                      T data)

Called for each frame that is visited. Note that unless this method is annotated with Uninterruptible or executing within a safepoint, the frame on the stack could be deoptimized at any safepoint check. Nevertheless, the passed codeInfo remains valid for accessing information about the code at the (possibly outdated) instruction pointer (this is ensured by the caller).

Parameters:

sp - The stack pointer of the frame being visited.

ip - The instruction pointer of the frame being visited.

codeInfo - Information on the code at the IP, for use with CodeInfoAccess.

deoptimizedFrame - The information about a deoptimized frame, or null if the frame is not deoptimized.

data - An arbitrary data value passed through the stack walker.

Returns:

true if visiting should continue, false otherwise.

unknownFrame

protected abstract boolean unknownFrame(org.graalvm.word.Pointer sp,
                                        org.graalvm.nativeimage.c.function.CodePointer ip,
                                        DeoptimizedFrame deoptimizedFrame,
                                        T data)

Called when no frame metadata can be found for a frame. That usually means that the VM is in an inconsistent state. The default implementation therefore aborts VM execution with a fatal error. Stack walking for diagnostic purposes can override this method to just report a message.

Parameters:

sp - The stack pointer of the frame being visited.

ip - The instruction pointer of the frame being visited.

deoptimizedFrame - The information about a deoptimized frame, or null if the frame is not deoptimized.

data - An arbitrary data value passed through the stack walker.

Returns:

The value returned to the caller of stack walking. Note that walking of the thread is always aborted, regardless of the return value.