org.mmtk.plan

Class Simple

java.lang.Object

org.mmtk.plan.Plan

org.mmtk.plan.Simple

Direct Known Subclasses:

Concurrent, StopTheWorld

public abstract class Simple
extends Plan

This abstract class implements the core functionality for simple collectors.

This class defines the collection phases, and provides base level implementations of them. Subclasses should provide implementations for the spaces that they introduce, and delegate up the class hierarchy.

For details of the split between global and thread-local operations

See Also:

Plan

Field Summary

Fields

Modifier and Type	Field and Description
static short	CLOSURE
short	collection This is the phase that is executed to perform a collection.
protected int	collectionAttempt The current collection attempt.
static short	COMPLETE
protected static short	completeClosurePhase Complete closure including reference types and finalizable objects.
static short	FINALIZABLE
private static Timer	finalizeTime
protected static short	finishPhase The collection scheme - this is a small tree of complex phases.
static short	FORWARD
static short	FORWARD_FINALIZABLE
static short	FORWARD_REFS
protected static short	forwardPhase Ensure that all references in the system are correct.
static short	INITIATE
protected static short	initPhase Start the collection, including preparation for any collected spaces.
static short	PHANTOM_REFS
static short	POST_SANITY_PLACEHOLDER
static short	PRE_SANITY_PLACEHOLDER
static short	PREPARE
static short	PREPARE_STACKS
protected static short	prepareStacks Ensure stacks are ready to be scanned
protected static short	refTypeClosurePhase Complete closure including reference types and finalizable objects.
private static Timer	refTypeTime Constants
static short	RELEASE
protected static short	rootClosurePhase Perform the initial determination of liveness from the roots.
static short	ROOTS
static short	SANITY_BUILD_TABLE
static short	SANITY_CHECK_TABLE
static short	SANITY_COPY_ROOTS
static short	SANITY_PREPARE
static short	SANITY_RELEASE
static short	SANITY_ROOTS
static short	SANITY_SET_POSTGC
static short	SANITY_SET_PREGC
protected static short	sanityBuildPhase Trace and set up a sanity table
protected static short	sanityCheckPhase Validate a sanity table
private static Timer	scanTime
static short	SET_COLLECTION_KIND
static short	SOFT_REFS
static short	STACK_ROOTS
static short	WEAK_REFS
static short	WEAK_TRACK_REFS

Fields inherited from class org.mmtk.plan.Plan

ALLOC_CODE, ALLOC_COLD_CODE, ALLOC_DEFAULT, ALLOC_GCSPY, ALLOC_HOT_CODE, ALLOC_IMMORTAL, ALLOC_LARGE_CODE, ALLOC_LOS, ALLOC_NON_MOVING, ALLOC_NON_REFERENCE, ALLOC_PRIMITIVE_LOS, ALLOC_STACK, allocationSiteCount, ALLOCATORS, concurrentWorkers, controlCollectorContext, DEFAULT_MAX_NURSERY, DEFAULT_MIN_NURSERY, DEFAULT_SITE, defaultCollectorContext, emergencyCollection, GATHER_WRITE_BARRIER_STATS, GC_PREPARE, GC_PROPER, IMMORTAL, immortalSpace, insideHarness, internalTriggeredCollection, LARGE_CODE, largeCodeSpace, lastInternalTriggeredCollection, LOS, loSpace, MAX_NON_LOS_COPY_BYTES, MAX_NON_LOS_DEFAULT_ALLOC_BYTES, MAX_NON_LOS_NONMOVING_ALLOC_BYTES, META, metaDataSpace, NEEDS_LOG_BIT_IN_HEADER, NON_MOVING, NON_PARTICIPANT, nonMovingSpace, NOT_IN_GC, parallelWorkers, pretenureThreshold, SANITY, sanityChecker, sanitySpace, SCAN_BOOT_IMAGE, SMALL_CODE, smallCodeSpace, stacksPrepared, totalTime, USE_CODE_SPACE, userTriggeredCollection, VM_SPACE, vmSpace

Constructor Summary

Constructors

Constructor and Description
Simple()

Method Summary

Modifier and Type	Method and Description
void	collectionPhase(short phaseId) Perform a (global) collection phase.
void	replacePhase(int oldScheduledPhase, int newScheduledPhase) Replace a phase.
void	replacePlaceholderPhase(short placeHolderPhase, int newScheduledPhase) Replace a placeholder phase.
protected void	switchNurseryZeroingApproach(Space nurserySpace) Update the nursery zeroing approach based on option settings.

Methods inherited from class org.mmtk.plan.Plan

availableMemory, bootTimeWriteBarrier, collectionRequired, concurrentCollectionRequired, determineThreadCount, enableAllocation, enableCollection, forceFullHeapCollection, freeMemory, fullyBooted, gcInProgress, gcInProgressProper, getAllocationSite, getCollectionReserve, getPagesAvail, getPagesReserved, getPagesUsed, getSpecializedScanClass, getTotalPages, handleUserCollectionRequest, harnessBegin, harnessEnd, insertPhaseAfter, isCurrentGCNursery, isEmergencyCollection, isInitialized, isInternalTriggeredCollection, isUserTriggeredCollection, lastCollectionFullHeap, lastCollectionWasExhaustive, loadObjectReference, logPoll, notifyExit, poll, preCollectorSpawn, printDetailedTiming, printPostStats, printPreStats, printUsedPages, processOptions, registerSpecializedMethods, reservedMemory, resetCollectionTrigger, sanityExpectedRC, sanityLinearScan, setBuildTimeGCByte, setGCStatus, spawnCollectorThreads, stacksPrepared, startGCspyServer, storeObjectReference, stressTestGCRequired, totalMemory, triggerInternalCollectionRequest, usedMemory, willNeverMove

Methods inherited from class java.lang.Object

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

Field Detail

refTypeTime

private static final Timer refTypeTime

Constants

scanTime

private static final Timer scanTime

finalizeTime

private static final Timer finalizeTime

SET_COLLECTION_KIND

public static final short SET_COLLECTION_KIND

INITIATE

public static final short INITIATE

PREPARE

public static final short PREPARE

PREPARE_STACKS

public static final short PREPARE_STACKS

STACK_ROOTS

public static final short STACK_ROOTS

ROOTS

public static final short ROOTS

CLOSURE

public static final short CLOSURE

SOFT_REFS

public static final short SOFT_REFS

WEAK_REFS

public static final short WEAK_REFS

FINALIZABLE

public static final short FINALIZABLE

WEAK_TRACK_REFS

public static final short WEAK_TRACK_REFS

PHANTOM_REFS

public static final short PHANTOM_REFS

FORWARD

public static final short FORWARD

FORWARD_REFS

public static final short FORWARD_REFS

FORWARD_FINALIZABLE

public static final short FORWARD_FINALIZABLE

RELEASE

public static final short RELEASE

COMPLETE

public static final short COMPLETE

PRE_SANITY_PLACEHOLDER

public static final short PRE_SANITY_PLACEHOLDER

POST_SANITY_PLACEHOLDER

public static final short POST_SANITY_PLACEHOLDER

SANITY_SET_PREGC

public static final short SANITY_SET_PREGC

SANITY_SET_POSTGC

public static final short SANITY_SET_POSTGC

SANITY_PREPARE

public static final short SANITY_PREPARE

SANITY_ROOTS

public static final short SANITY_ROOTS

SANITY_COPY_ROOTS

public static final short SANITY_COPY_ROOTS

SANITY_BUILD_TABLE

public static final short SANITY_BUILD_TABLE

SANITY_CHECK_TABLE

public static final short SANITY_CHECK_TABLE

SANITY_RELEASE

public static final short SANITY_RELEASE

prepareStacks

protected static final short prepareStacks

Ensure stacks are ready to be scanned

sanityBuildPhase

protected static final short sanityBuildPhase

Trace and set up a sanity table

sanityCheckPhase

protected static final short sanityCheckPhase

Validate a sanity table

initPhase

protected static final short initPhase

Start the collection, including preparation for any collected spaces.

rootClosurePhase

protected static final short rootClosurePhase

Perform the initial determination of liveness from the roots.

refTypeClosurePhase

protected static final short refTypeClosurePhase

Complete closure including reference types and finalizable objects.

forwardPhase

protected static final short forwardPhase

Ensure that all references in the system are correct.

completeClosurePhase

protected static final short completeClosurePhase

Complete closure including reference types and finalizable objects.

finishPhase

protected static final short finishPhase

The collection scheme - this is a small tree of complex phases.

collection

public short collection

This is the phase that is executed to perform a collection.

collectionAttempt

protected int collectionAttempt

The current collection attempt.

Constructor Detail

Simple

public Simple()

Method Detail

collectionPhase

public void collectionPhase(short phaseId)

Perform a (global) collection phase.

Specified by:

collectionPhase in class Plan

Parameters:

phaseId - The unique id of the phase to perform.

switchNurseryZeroingApproach

protected void switchNurseryZeroingApproach(Space nurserySpace)

Update the nursery zeroing approach based on option settings.

Parameters:

nurserySpace - The space to apply the changes to.

replacePhase

public void replacePhase(int oldScheduledPhase,
                         int newScheduledPhase)

Replace a phase. Used for example to replace a placeholder.

Overrides:

replacePhase in class Plan

Parameters:

oldScheduledPhase - The scheduled phase to insert after

newScheduledPhase - The scheduled phase to insert

replacePlaceholderPhase

public void replacePlaceholderPhase(short placeHolderPhase,
                                    int newScheduledPhase)

Replace a placeholder phase.

Parameters:

placeHolderPhase - The placeholder phase

newScheduledPhase - The new scheduled phase.