org.jikesrvm.compilers.common

Class HardwareTrapGCMapIterator

java.lang.Object

org.jikesrvm.mm.mminterface.GCMapIterator

org.jikesrvm.compilers.common.HardwareTrapGCMapIterator

public final class HardwareTrapGCMapIterator
extends GCMapIterator

Iterator for stack frames inserted by hardware trap handler. Such frames are purely used as markers. They contain no object references or JSR return addresses.

Field Summary

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

framePtr, registerLocations, thread

Constructor Summary

Constructors

Constructor and Description
HardwareTrapGCMapIterator(AddressArray registerLocations)

Method Summary

Modifier and Type	Method and Description
void	cleanupPointers() Iteration is complete, release any internal data structures including locks acquired during setupIterator for jsr maps.
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	getType() Get the type of this iterator (BASELINE, OPT, etc.).
void	reset() Prepare to re-iterate on same stackframe, and to switch between "reference" iteration and "JSR return address" iteration.
void	setupIterator(CompiledMethod compiledMethod, Offset instructionOffset, Address framePtr) Prepare to iterate over object references and JSR return addresses held by a stackframe.

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

Constructor Detail

HardwareTrapGCMapIterator

public HardwareTrapGCMapIterator(AddressArray registerLocations)

Method Detail

setupIterator

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

Description copied from class: GCMapIterator

Prepare to iterate over object references and JSR return addresses held by a stackframe.

Specified by:

setupIterator in class GCMapIterator

Parameters:

compiledMethod - method running in the stackframe

instructionOffset - offset of current instruction within that method's code

framePtr - address of stackframe to be visited

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

reset

public void reset()

Description copied from class: GCMapIterator

Prepare to re-iterate on same stackframe, and to switch between "reference" iteration and "JSR return address" iteration.

Specified by:

reset in class GCMapIterator

cleanupPointers

public void cleanupPointers()

Description copied from class: GCMapIterator

Iteration is complete, release any internal data structures including locks acquired during setupIterator for jsr maps.

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