org.jikesrvm.compilers.baseline

Class BaselineCompiledMethod

java.lang.Object

org.jikesrvm.compilers.common.CompiledMethod

org.jikesrvm.compilers.baseline.BaselineCompiledMethod

public final class BaselineCompiledMethod
extends CompiledMethod

Compiler-specific information associated with a method's machine instructions.

Field Summary

Fields

Modifier and Type	Field and Description
private byte[]	bytecodeMap Encoded representation of bytecode index to offset in code array map.
private short	emptyStackOffset Offset into stack frame when operand stack is empty
private int[]	eTable Exception table, null if not present.
private static ExceptionDeliverer	exceptionDeliverer Baseline exception deliverer object
private boolean	hasCounters Does the baseline compiled method have a counters array?
private byte	lastFixedStackRegister PPC only: last general purpose register holding part of the operand stack
private byte	lastFloatStackRegister PPC only: last floating point register holding part of the operand stack
private short[]	localFixedLocations PPC only: location of general purpose local variables, positive values are register numbers, negative are stack offsets
private short[]	localFloatLocations PPC only: location of floating point local variables, positive values are register numbers, negative are stack offsets
private char	lockOffset The lock acquisition offset for synchronized methods.
ReferenceMaps	referenceMaps Stack-slot reference maps for the compiled method.

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
BaselineCompiledMethod(int id, RVMMethod m)

Method Summary

Modifier and Type	Method and Description
void	compile() Compile method
void	encodeMappingInfo(ReferenceMaps referenceMaps, int[] bcMap) Encode/compress the bytecode map, reference (GC) map and exception table
int	findBytecodeIndexForInstruction(Offset instructionOffset) Find bytecode index corresponding to one of this method's machine instructions.
int	findCatchBlockForInstruction(Offset instructionOffset, RVMType exceptionType) Find a catch block within the compiled method
int	findLineNumberForInstruction(Offset instructionOffset) Find source line number corresponding to one of this method's machine instructions.
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.
int	getEmptyStackOffset()
ExceptionDeliverer	getExceptionDeliverer()
short	getFloatLocalLocation(int localIndex) Location of local floating point variable.
short	getFloatStackLocation(int stackIndex)
short	getGeneralLocalLocation(int localIndex) Location of local general purpose variable.
short	getGeneralStackLocation(int stackIndex)
int	getLastFixedStackRegister()
int	getLastFloatStackRegister()
Offset	getLockAcquisitionOffset()
boolean	hasCounterArray()
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	printExceptionTable() Print the eTable
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.
(package private) void	setHasCounterArray() Set the method has a counters array
void	setLockAcquisitionOffset(int off) Sets the lock acquisition offset for synchronized methods.
int	size()
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, getCompilationTime, getEntryCodeArray, getId, getInstructionAddress, getInstructionOffset, getInstructionOffset, getMethod, getOsrJTOCoffset, getSamplesReset, hasBridgeFromNativeAnnotation, isActiveOnStack, isCompiled, isInvalid, isObsolete, isOutdated, isSpecialForOSR, numberOfInstructions, setActiveOnStack, setCompilationTime, setInvalid, setObsolete, setOutdated, setSamplesReset, setSpecialForOSR

Methods inherited from class java.lang.Object

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

Field Detail

hasCounters

private boolean hasCounters

Does the baseline compiled method have a counters array?

lockOffset

private char lockOffset

The lock acquisition offset for synchronized methods. For synchronized methods, the offset (in the method prologue) after which the monitor has been obtained. At, or before, this point, the method does not own the lock. Used by deliverException to determine whether the lock needs to be released. Note: for this scheme to work, Lock must not allow a yield after it has been obtained.

exceptionDeliverer

private static final ExceptionDeliverer exceptionDeliverer

Baseline exception deliverer object

referenceMaps

public ReferenceMaps referenceMaps

Stack-slot reference maps for the compiled method.

bytecodeMap

private byte[] bytecodeMap

Encoded representation of bytecode index to offset in code array map. Currently needed to support dynamic bridge magic; Consider integrating with GC maps

eTable

private int[] eTable

Exception table, null if not present.

emptyStackOffset

private final short emptyStackOffset

Offset into stack frame when operand stack is empty

lastFixedStackRegister

private byte lastFixedStackRegister

PPC only: last general purpose register holding part of the operand stack

lastFloatStackRegister

private byte lastFloatStackRegister

PPC only: last floating point register holding part of the operand stack

localFixedLocations

private final short[] localFixedLocations

PPC only: location of general purpose local variables, positive values are register numbers, negative are stack offsets

localFloatLocations

private final short[] localFloatLocations

PPC only: location of floating point local variables, positive values are register numbers, negative are stack offsets

Constructor Detail

BaselineCompiledMethod

public BaselineCompiledMethod(int id,
                              RVMMethod m)

Method Detail

getEmptyStackOffset

public int getEmptyStackOffset()

Returns:

offset into stack frame when operand stack is empty

getGeneralLocalLocation

public short getGeneralLocalLocation(int localIndex)

Location of local general purpose variable. These Locations are positioned at the top of the stackslot that contains the value before accessing, substract size of value you want to access.

e.g. to load int: load at BaselineCompilerImpl.locationToOffset(location) - BYTES_IN_INT
e.g. to load long: load at BaselineCompilerImpl.locationToOffset(location) - BYTES_IN_LONG

Parameters:

localIndex - the index for the local general purpose variable

Returns:

location of the general purpose variable with the given index

getFloatLocalLocation

public short getFloatLocalLocation(int localIndex)

Location of local floating point variable. These Locations are positioned at the top of the stackslot that contains the value before accessing, substract size of value you want to access.

e.g. to load float: load at BaselineCompilerImpl.locationToOffset(location) - BYTES_IN_FLOAT
e.g. to load double: load at BaselineCompilerImpl.locationToOffset(location) - BYTES_IN_DOUBLE

Parameters:

localIndex - the index for the local general purpose variable

Returns:

location of the floating point variable with the given index

getGeneralStackLocation

public short getGeneralStackLocation(int stackIndex)

getFloatStackLocation

public short getFloatStackLocation(int stackIndex)

getLastFixedStackRegister

public int getLastFixedStackRegister()

Returns:

last general purpose register holding part of the operand stack

getLastFloatStackRegister

public int getLastFloatStackRegister()

Returns:

last floating point register holding part of the operand stack

compile

public void compile()

Compile method

getCompilerType

public int getCompilerType()

Description copied from class: CompiledMethod

Identify the compiler that produced this compiled method.

Specified by:

getCompilerType in class CompiledMethod

Returns:

BASELINE

getCompilerName

public String getCompilerName()

Specified by:

getCompilerName in class CompiledMethod

Returns:

"baseline compiler"

getExceptionDeliverer

public ExceptionDeliverer getExceptionDeliverer()

Specified by:

getExceptionDeliverer in class CompiledMethod

Returns:

the exception deliverer for this kind of compiled method

findCatchBlockForInstruction

public int findCatchBlockForInstruction(Offset instructionOffset,
                                        RVMType exceptionType)

Find a catch block within the compiled method

Specified by:

findCatchBlockForInstruction in class CompiledMethod

Parameters:

instructionOffset - offset of faulting instruction in compiled code

exceptionType - the type of the thrown exception

Returns:

the machine code offset of the 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

findLineNumberForInstruction

public int findLineNumberForInstruction(Offset instructionOffset)

Description copied from class: CompiledMethod

Find source line number corresponding to one of this method's machine instructions.

Usage note: "instructionOffset" must point to the instruction following the actual instruction whose line number is sought. This allows us to properly handle the case where the only address we have to work with is a return address (ie. from a stackframe) or an exception address (ie. 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".

Overrides:

findLineNumberForInstruction in class CompiledMethod

Parameters:

instructionOffset - the instruction's offset in the code for the method

Returns:

The line number, a positive integer. Zero means unable to find.

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.

findBytecodeIndexForInstruction

public int findBytecodeIndexForInstruction(Offset instructionOffset)

Find bytecode index corresponding to one of this method's machine instructions.

Parameters:

instructionOffset - instruction offset to map to a bytecode index.
Note: This method expects the offset to refer to the machine instruction immediately FOLLOWING the bytecode in question. just like findLineNumberForInstruction. See CompiledMethod for rationale.
NOTE: instructionIndex is in units of instructions, not bytes (different from all the other methods in this interface!!)

Returns:

the bytecode index for the machine instruction, -1 if not available or not found.

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

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.

printExceptionTable

public void printExceptionTable()

Print the eTable

setLockAcquisitionOffset

public void setLockAcquisitionOffset(int off)

Sets the lock acquisition offset for synchronized methods.

Parameters:

off - new offset

getLockAcquisitionOffset

public Offset getLockAcquisitionOffset()

Returns:

the lock acquisition offset

setHasCounterArray

void setHasCounterArray()

Set the method has a counters array

hasCounterArray

public boolean hasCounterArray()

Returns:

whether the method has a counters array

encodeMappingInfo

public void encodeMappingInfo(ReferenceMaps referenceMaps,
                              int[] bcMap)

Encode/compress the bytecode map, reference (GC) map and exception table

Parameters:

referenceMaps - to encode

bcMap - unencoded bytecode to code array offset map

size

public int size()

Overrides:

size in class CompiledMethod

Returns:

the number of bytes used to encode the compiler-specific mapping information for this compiled method. Used to gather statistics on the space costs of mapping schemes.