org.jikesrvm.compilers.baseline.ia32

Class BaselineGCMapIterator

java.lang.Object

org.jikesrvm.mm.mminterface.GCMapIterator

org.jikesrvm.compilers.baseline.ia32.BaselineGCMapIterator

public final class BaselineGCMapIterator
extends GCMapIterator

Iterator for stack frame built by the Baseline compiler.

An Instance of this class will iterate through a particular reference map of a method returning the offsets of any references that are part of the input parameters, local variables, and java stack for the stack frame.

Field Summary

Fields

Modifier and Type	Field and Description
private int	bridgeParameterIndex current parameter being mapped (-1 == "this")
private int	bridgeParameterInitialIndex first parameter to be mapped (-1 == "this")
private boolean	bridgeParameterMappingRequired have all bridge parameters been mapped yet?
private TypeReference[]	bridgeParameterTypes parameter types passed by that method
private int	bridgeRegisterIndex gpr register it lives in
private Address	bridgeRegisterLocation memory address at which that register was saved
private boolean	bridgeRegistersLocationUpdated have the register location been updated
private boolean	bridgeSpilledParameterMappingRequired do we need to map spilled params (baseline compiler = no, opt = yes)
private int	bridgeSpilledParamInitialOffset starting offset to stack location for param0
private Address	bridgeSpilledParamLocation current spilled param location
private MethodReference	bridgeTarget method to be invoked via dynamic bridge (null: current frame is not a dynamic bridge)
private boolean	counterArrayBase have we reported the base ptr of the edge counter array?
private BaselineCompiledMethod	currentCompiledMethod Compiled method for the frame
private NormalMethod	currentMethod Compiled method for the frame
private int	currentNumLocals
private DynamicLink	dynamicLink place to keep info returned by CompiledMethod.getDynamicLink
private boolean	finishedWithRegularMap have we processed all the values in the regular map yet?
private int	mapId id of current map out of all maps
private int	mapIndex Current index in current map
private ReferenceMaps	maps set of maps for this method
private static boolean	TRACE_ALL
private static boolean	TRACE_DL

Fields inherited from class org.jikesrvm.mm.mminterface.GCMapIterator

framePtr, registerLocations, thread

Constructor Summary

Constructors

Constructor and Description
BaselineGCMapIterator(AddressArray registerLocations) Constructs a BaselineGCMapIterator for IA32.

Method Summary

Modifier and Type	Method and Description
void	cleanupPointers() Cleanup pointers - used with method maps to release data structures early ... they may be in temporary storage i.e. storage only used during garbage collection
short	convertIndexToLocation(int index) Converts a biased index from a local area into an offset in the stack.
private int	convertIndexToOffset(int index)
Address	getNextReferenceAddress() Get address of next object reference held by current stackframe.
Address	getNextReturnAddressAddress() Get address of next JSR return address held by current stackframe.
int	getStackDepth()
int	getType() Get the type of this iterator (BASELINE, OPT, etc.).
void	reset() Reset iteration to initial state.
void	setupIterator(CompiledMethod compiledMethod, Offset instructionOffset, Address fp) Set the iterator to scan the map at the machine instruction offset provided.

Methods inherited from class org.jikesrvm.mm.mminterface.GCMapIterator

newStackWalk

Methods inherited from class java.lang.Object

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

Field Detail

TRACE_ALL

private static final boolean TRACE_ALL

See Also:

Constant Field Values

TRACE_DL

private static final boolean TRACE_DL

See Also:

Constant Field Values

currentMethod

private NormalMethod currentMethod

Compiled method for the frame

currentCompiledMethod

private BaselineCompiledMethod currentCompiledMethod

Compiled method for the frame

currentNumLocals

private int currentNumLocals

mapIndex

private int mapIndex

Current index in current map

mapId

private int mapId

id of current map out of all maps

maps

private ReferenceMaps maps

set of maps for this method

counterArrayBase

private boolean counterArrayBase

have we reported the base ptr of the edge counter array?

dynamicLink

private final DynamicLink dynamicLink

place to keep info returned by CompiledMethod.getDynamicLink

bridgeTarget

private MethodReference bridgeTarget

method to be invoked via dynamic bridge (null: current frame is not a dynamic bridge)

bridgeParameterTypes

private TypeReference[] bridgeParameterTypes

parameter types passed by that method

bridgeParameterMappingRequired

private boolean bridgeParameterMappingRequired

have all bridge parameters been mapped yet?

bridgeSpilledParameterMappingRequired

private boolean bridgeSpilledParameterMappingRequired

do we need to map spilled params (baseline compiler = no, opt = yes)

bridgeRegistersLocationUpdated

private boolean bridgeRegistersLocationUpdated

have the register location been updated

finishedWithRegularMap

private boolean finishedWithRegularMap

have we processed all the values in the regular map yet?

bridgeParameterInitialIndex

private int bridgeParameterInitialIndex

first parameter to be mapped (-1 == "this")

bridgeParameterIndex

private int bridgeParameterIndex

current parameter being mapped (-1 == "this")

bridgeRegisterIndex

private int bridgeRegisterIndex

gpr register it lives in

bridgeRegisterLocation

private Address bridgeRegisterLocation

memory address at which that register was saved

bridgeSpilledParamLocation

private Address bridgeSpilledParamLocation

current spilled param location

bridgeSpilledParamInitialOffset

private int bridgeSpilledParamInitialOffset

starting offset to stack location for param0

Constructor Detail

BaselineGCMapIterator

public BaselineGCMapIterator(AddressArray registerLocations)

Constructs a BaselineGCMapIterator for IA32.

Note: the location array for registers needs to be remembered. It also needs to be updated with the location of any saved registers. The locations are kept as addresses within the stack. This information is not used by this iterator but must be updated for the other types of iterators (e.g. iterators for the opt compiler built frames).

Parameters:

registerLocations - locations of saved registers

Method Detail

setupIterator

public void setupIterator(CompiledMethod compiledMethod,
                          Offset instructionOffset,
                          Address fp)

Set the iterator to scan the map at the machine instruction offset provided. The iterator is positioned to the beginning of the map. NOTE: An iterator may be reused to scan a different method and map.

Specified by:

setupIterator in class GCMapIterator

Parameters:

compiledMethod - identifies the method and class

instructionOffset - identifies the map to be scanned.

fp - identifies a specific occurrence of this method and allows for processing instance specific information i.e JSR return address values

reset

public void reset()

Reset iteration to initial state. This allows a map to be scanned multiple times.

Specified by:

reset in class GCMapIterator

convertIndexToLocation

public short convertIndexToLocation(int index)

Converts a biased index from a local area into an offset in the stack.

Parameters:

index - index in the local area (biased : local0 has index 1)

Returns:

corresponding offset in the stack

convertIndexToOffset

private int convertIndexToOffset(int index)

getNextReferenceAddress

public Address getNextReferenceAddress()

Description copied from class: GCMapIterator

Get address of next object reference held by current stackframe. Returns zero when there are no more references to report.

Side effect: registerLocations[] updated at end of iteration. TODO: registerLocations[] update should be done via separately called method instead of as side effect.

Specified by:

getNextReferenceAddress in class GCMapIterator

Returns:

address of word containing an object reference zero if no more references to report

getNextReturnAddressAddress

public Address getNextReturnAddressAddress()

Description copied from class: GCMapIterator

Get address of next JSR return address held by current stackframe.

Specified by:

getNextReturnAddressAddress in class GCMapIterator

Returns:

address of word containing a JSR return address zero if no more return addresses to report

cleanupPointers

public void cleanupPointers()

Cleanup pointers - used with method maps to release data structures early ... they may be in temporary storage i.e. storage only used during garbage collection

Specified by:

cleanupPointers in class GCMapIterator

getType

public int getType()

Description copied from class: GCMapIterator

Get the type of this iterator (BASELINE, OPT, etc.). Called from GCMapIteratorGroup to select which iterator to use for a stackframe. The possible types are specified in CompiledMethod.

Specified by:

getType in class GCMapIterator

Returns:

type code for this iterator

getStackDepth

public int getStackDepth()