org.mmtk.plan.generational.copying

Class GenCopyMutator

java.lang.Object

org.mmtk.plan.MutatorContext

org.mmtk.plan.SimpleMutator

org.mmtk.plan.StopTheWorldMutator

org.mmtk.plan.generational.GenMutator

org.mmtk.plan.generational.copying.GenCopyMutator

public class GenCopyMutator
extends GenMutator

This class implements per-mutator thread behavior and state for the GenCopy two-generational copying collector.

Specifically, this class defines mutator-time semantics specific to the mature generation (GenMutator defines nursery semantics). In particular the mature space allocator is defined (for mutator-time allocation into the mature space via pre-tenuring), and the mature space per-mutator thread collection time semantics are defined (rebinding the mature space allocator).

See Also:

for a description of the GenCopy algorithm., GenCopy, GenCopyCollector, GenMutator, StopTheWorldMutator, MutatorContext

Field Summary

Fields

Modifier and Type	Field and Description
private CopyLocal	mature The allocator for the copying mature space (the mutator may "pretenure" objects into this space otherwise used only by the collector)

Fields inherited from class org.mmtk.plan.generational.GenMutator

arrayRemset, nursery, remset

Fields inherited from class org.mmtk.plan.MutatorContext

immortal, lgcode, log, los, nonmove, smcode

Constructor Summary

Constructors

Constructor and Description
GenCopyMutator() Constructor

Method Summary

Modifier and Type	Method and Description
Address	alloc(int bytes, int align, int offset, int allocator, int site) Allocate memory for an object.
void	collectionPhase(short phaseId, boolean primary) Perform a per-mutator collection phase.
Allocator	getAllocatorFromSpace(Space space) Return the allocator instance associated with a space space, for this plan instance.
private static GenCopy	global()
void	initMutator(int id) Called before the MutatorContext is used, but after the context has been fully registered and is visible to collection.
void	postAlloc(ObjectReference object, ObjectReference typeRef, int bytes, int allocator) Perform post-allocation actions.

Methods inherited from class org.mmtk.plan.generational.GenMutator

assertRemsetsFlushed, flushRememberedSets, objectReferenceBulkCopy, objectReferenceNonHeapWrite, objectReferenceTryCompareAndSwap, objectReferenceWrite

Methods inherited from class org.mmtk.plan.MutatorContext

addressBulkCopy, addressRead, addressTryCompareAndSwap, addressWrite, booleanBulkCopy, booleanRead, booleanWrite, byteBulkCopy, byteRead, byteWrite, charBulkCopy, charRead, charWrite, checkAllocator, deinitMutator, doubleBulkCopy, doubleRead, doubleWrite, extentBulkCopy, extentRead, extentWrite, floatBulkCopy, floatRead, floatWrite, flush, getId, getLog, intBulkCopy, intRead, intTryCompareAndSwap, intWrite, javaLangReferenceReadBarrier, longBulkCopy, longRead, longTryCompareAndSwap, longWrite, objectReferenceNonHeapRead, objectReferenceRead, offsetBulkCopy, offsetRead, offsetWrite, shortBulkCopy, shortRead, shortWrite, wordBulkCopy, wordRead, wordTryCompareAndSwap, wordWrite

Methods inherited from class java.lang.Object

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

Field Detail

mature

private final CopyLocal mature

The allocator for the copying mature space (the mutator may "pretenure" objects into this space otherwise used only by the collector)

Constructor Detail

GenCopyMutator

public GenCopyMutator()

Constructor

Method Detail

initMutator

public void initMutator(int id)

Called before the MutatorContext is used, but after the context has been fully registered and is visible to collection.

Overrides:

initMutator in class MutatorContext

Parameters:

id - The id of this mutator context.

alloc

public final Address alloc(int bytes,
                           int align,
                           int offset,
                           int allocator,
                           int site)

Allocate memory for an object.

Overrides:

alloc in class GenMutator

Parameters:

bytes - The number of bytes required for the object.

align - Required alignment for the object.

offset - Offset associated with the alignment.

allocator - The allocator associated with this request.

site - Allocation site

Returns:

The low address of the allocated chunk.

postAlloc

public final void postAlloc(ObjectReference object,
                            ObjectReference typeRef,
                            int bytes,
                            int allocator)

Description copied from class: MutatorContext

Perform post-allocation actions. For many allocators none are required.

Overrides:

postAlloc in class GenMutator

Parameters:

object - The newly allocated object

typeRef - the type reference for the instance being created

bytes - The size of the space to be allocated (in bytes)

allocator - The allocator number to be used for this allocation

getAllocatorFromSpace

public final Allocator getAllocatorFromSpace(Space space)

Description copied from class: MutatorContext

Return the allocator instance associated with a space space, for this plan instance.

Overrides:

getAllocatorFromSpace in class GenMutator

Parameters:

space - The space for which the allocator instance is desired.

Returns:

The allocator instance associated with this plan instance which is allocating into space, or null if no appropriate allocator can be established.

collectionPhase

public void collectionPhase(short phaseId,
                            boolean primary)

Perform a per-mutator collection phase. This is executed by one collector thread on behalf of a mutator thread.

Overrides:

collectionPhase in class GenMutator

Parameters:

phaseId - The unique phase identifier

primary - Should this thread be used to execute any single-threaded local operations?

global

private static GenCopy global()

Returns:

The active global plan as a GenCopy instance.