org.jikesrvm.compilers.common

Class HardwareTrapCompiledMethod

java.lang.Object

org.jikesrvm.compilers.common.CompiledMethod

org.jikesrvm.compilers.common.HardwareTrapCompiledMethod

final class HardwareTrapCompiledMethod
extends CompiledMethod

Information associated with artificial stackframe inserted by hardware trap handler.

Field Summary

Fields inherited from class org.jikesrvm.compilers.common.CompiledMethod

BASELINE, cmid, compilationTime, instructions, JNI, method, NATIVE_METHOD_LINE_NUMBER, NUM_COMPILER_TYPES, OPT, osrJTOCoffset, TRAP

Constructor Summary

Constructors

Constructor and Description
HardwareTrapCompiledMethod(int id, RVMMethod m)

Method Summary

Modifier and Type	Method and Description
int	findCatchBlockForInstruction(Offset instructionOffset, RVMType exceptionType) Find "catch" block for a machine instruction of this method that might be guarded against specified class of exceptions by a "try" block.
String	getCompilerName()
int	getCompilerType() Identify the compiler that produced this compiled method.
void	getDynamicLink(DynamicLink dynamicLink, Offset instructionOffset) Fetch symbolic reference to a method that's called by one of this method's instructions.
ExceptionDeliverer	getExceptionDeliverer()
boolean	isWithinUninterruptibleCode(Offset instructionOffset) Return whether or not the given address (which is purported to be inside of the compiled method's code array) corresponds to an uninterruptible context.
void	printStackTrace(Offset instructionOffset, PrintLN out) Print this compiled method's portion of a stack trace
void	set(StackBrowser browser, Offset instr) Set the stack browser to the innermost logical stack frame of this method.
boolean	up(StackBrowser browser) Advance the StackBrowser up one internal stack frame, if possible

Methods inherited from class org.jikesrvm.compilers.common.CompiledMethod

clearActiveOnStack, codeArrayForOffset, compileComplete, compilerTypeToString, containsReturnAddress, findLineNumberForInstruction, getCompilationTime, getEntryCodeArray, getId, getInstructionAddress, getInstructionOffset, getInstructionOffset, getMethod, getOsrJTOCoffset, getSamplesReset, hasBridgeFromNativeAnnotation, isActiveOnStack, isCompiled, isInvalid, isObsolete, isOutdated, isSpecialForOSR, numberOfInstructions, setActiveOnStack, setCompilationTime, setInvalid, setObsolete, setOutdated, setSamplesReset, setSpecialForOSR, size

Methods inherited from class java.lang.Object

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

Constructor Detail

HardwareTrapCompiledMethod

HardwareTrapCompiledMethod(int id,
                           RVMMethod m)

Method Detail

getCompilerType

public int getCompilerType()

Description copied from class: CompiledMethod

Identify the compiler that produced this compiled method.

Specified by:

getCompilerType in class CompiledMethod

Returns:

one of TRAP, BASELINE, OPT, or JNI. Note: use this instead of "instanceof" when GC is disabled (i.e. during GC)

getCompilerName

public String getCompilerName()

Specified by:

getCompilerName in class CompiledMethod

Returns:

Name of the compiler that produced this compiled method.

getExceptionDeliverer

public ExceptionDeliverer getExceptionDeliverer()

Specified by:

getExceptionDeliverer in class CompiledMethod

Returns:

a handler to deal with stack unwinding and exception delivery for this compiled method's stackframes.

findCatchBlockForInstruction

public int findCatchBlockForInstruction(Offset instructionOffset,
                                        RVMType exceptionType)

Description copied from class: CompiledMethod

Find "catch" block for a machine instruction of this method that might be guarded against specified class of exceptions by a "try" block.

Notes:

• The "instructionOffset" must point to the instruction following the actual instruction whose catch block is sought. This allows us to properly handle the case where the only address we have to work with is a return address (i.e. from a stackframe) or an exception address (i.e. from a null pointer dereference, array bounds check, or divide by zero) on a machine architecture with variable length instructions. In such situations we'd have no idea how far to back up the instruction pointer to point to the "call site" or "exception site".
• This method must not cause any allocations, because it executes with GC disabled when called by RuntimeEntrypoints.deliverException().

Specified by:

findCatchBlockForInstruction in class CompiledMethod

Parameters:

instructionOffset - offset of machine instruction from start of this method, in bytes

exceptionType - type of exception being thrown - something like "NullPointerException"

Returns:

offset of machine instruction for catch block (-1 --> no catch block)

getDynamicLink

public void getDynamicLink(DynamicLink dynamicLink,
                           Offset instructionOffset)

Description copied from class: CompiledMethod

Fetch symbolic reference to a method that's called by one of this method's instructions.

Notes:

• The "instructionOffset" must point to the instruction i following the call instruction whose target method is sought. This allows us to properly handle the case where the only address we have to work with is a return address (i.e. from a stackframe) on a machine architecture with variable length instructions. In such situations we'd have no idea how far to back up the instruction pointer to point to the "call site".
• The implementation must not cause any allocations, because it executes with GC disabled when called by GCMapIterator.

Specified by:

getDynamicLink in class CompiledMethod

Parameters:

dynamicLink - place to put return information

instructionOffset - offset of machine instruction from start of this method, in bytes

isWithinUninterruptibleCode

public boolean isWithinUninterruptibleCode(Offset instructionOffset)

Description copied from class: CompiledMethod

Return whether or not the given address (which is purported to be inside of the compiled method's code array) corresponds to an uninterruptible context.

Specified by:

isWithinUninterruptibleCode in class CompiledMethod

Parameters:

instructionOffset - of addr from start of instructions in bytes

Returns:

true if the IP is within an Uninterruptible method, false otherwise.

printStackTrace

public void printStackTrace(Offset instructionOffset,
                            PrintLN out)

Description copied from class: CompiledMethod

Print this compiled method's portion of a stack trace

Specified by:

printStackTrace in class CompiledMethod

Parameters:

instructionOffset - offset of machine instruction from start of method

out - the PrintLN to print the stack trace to.

set

public void set(StackBrowser browser,
                Offset instr)

Description copied from class: CompiledMethod

Set the stack browser to the innermost logical stack frame of this method.

Specified by:

set in class CompiledMethod

Parameters:

browser - the browser

instr - the offset of the instruction

up

public boolean up(StackBrowser browser)

Description copied from class: CompiledMethod

Advance the StackBrowser up one internal stack frame, if possible

Overrides:

up in class CompiledMethod

Parameters:

browser - the browser to advance

Returns:

whether the browser advanced a frame