Module openj9.dtfj

Package com.ibm.dtfj.phd

Class PHDCorruptImageStackFrame

java.lang.Object

com.ibm.dtfj.phd.PHDCorruptData

com.ibm.dtfj.phd.PHDCorruptImageStackFrame

All Implemented Interfaces:

CorruptData, ImageStackFrame

public class PHDCorruptImageStackFrame
extends PHDCorruptData
implements ImageStackFrame

Method Summary

Modifier and Type	Method	Description
ImagePointer	getBasePointer()	Get the base pointer of the stack frame.
ImagePointer	getProcedureAddress()	Get the address of the current instruction within the procedure being executed.
String	getProcedureName()	Returns a string describing the procedure at this stack frame.

Methods declared in class com.ibm.dtfj.phd.PHDCorruptData

getAddress, toString

Methods declared in class java.lang.Object

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

Method Details

getBasePointer

public ImagePointer getBasePointer()
                            throws CorruptDataException

Description copied from interface: ImageStackFrame

Get the base pointer of the stack frame.

Specified by:

getBasePointer in interface ImageStackFrame

Returns:

the base pointer of the stack frame

Throws:

CorruptDataException

getProcedureAddress

public ImagePointer getProcedureAddress()
                                 throws CorruptDataException

Description copied from interface: ImageStackFrame

Get the address of the current instruction within the procedure being executed.

Specified by:

getProcedureAddress in interface ImageStackFrame

Returns:

the address of the current instruction within the procedure being executed, or null if not available.

Use this address with caution, as it is provided only as a best guess. It may not be correct, or even within readable memory

Throws:

CorruptDataException

getProcedureName

public String getProcedureName()
                        throws CorruptDataException

Description copied from interface: ImageStackFrame

Returns a string describing the procedure at this stack frame. Implementations should use the following template so that procedure names are reported consistently:

public *

libname(sourcefile)::entrypoint±offset

Any portion of the template may be omitted if it is not available

e.g.

system32(source.c)::WaitForSingleObject+14

system32::WaitForSingleObject-4

(source.c)::WaitForSingleObject

::WaitForSingleObject+14

system32+1404

system32::TWindow::open(int,void*)+14

Specified by:

getProcedureName in interface ImageStackFrame

Returns:

a string naming the function executing in this stack frame. If the name is not known for legitimate reasons, DTFJ will return a synthetic name.

Throws:

CorruptDataException