org.mmtk.plan.immix
Class ImmixMutator

java.lang.Object
  extended by org.mmtk.plan.MutatorContext
      extended by org.mmtk.plan.SimpleMutator
          extended by org.mmtk.plan.StopTheWorldMutator
              extended by org.mmtk.plan.immix.ImmixMutator
All Implemented Interfaces:
Constants
Direct Known Subclasses:
StickyImmixMutator

public class ImmixMutator
extends StopTheWorldMutator

This class implements per-mutator thread behavior and state for the Immix plan, which implements a full-heap immix collector.

Specifically, this class defines Immix mutator-time allocation and per-mutator thread collection semantics (flushing and restoring per-mutator allocator state).

See Also:
Immix, CollectorLocal, StopTheWorldMutator, MutatorContext

Field Summary
protected  MutatorLocal immix
          Instance fields
 
Fields inherited from class org.mmtk.plan.MutatorContext
id, immortal, log, los
 
Fields inherited from interface org.mmtk.utility.Constants
AALOAD_READ_BARRIER, AASTORE_WRITE_BARRIER, ALIGNMENT_VALUE, BITS_IN_ADDRESS, BITS_IN_BYTE, BITS_IN_INT, BITS_IN_PAGE, BITS_IN_SHORT, BITS_IN_WORD, BYTES_IN_ADDRESS, BYTES_IN_BYTE, BYTES_IN_INT, BYTES_IN_KBYTE, BYTES_IN_MBYTE, BYTES_IN_PAGE, BYTES_IN_SHORT, BYTES_IN_WORD, CARD_MASK, CARD_META_PAGES_PER_REGION, GETFIELD_READ_BARRIER, GETSTATIC_READ_BARRIER, LOG_BITS_IN_ADDRESS, LOG_BITS_IN_BYTE, LOG_BITS_IN_INT, LOG_BITS_IN_PAGE, LOG_BITS_IN_SHORT, LOG_BITS_IN_WORD, LOG_BYTES_IN_ADDRESS, LOG_BYTES_IN_ADDRESS_SPACE, LOG_BYTES_IN_BYTE, LOG_BYTES_IN_INT, LOG_BYTES_IN_KBYTE, LOG_BYTES_IN_MBYTE, LOG_BYTES_IN_PAGE, LOG_BYTES_IN_SHORT, LOG_BYTES_IN_WORD, LOG_CARD_BYTES, LOG_CARD_GRAIN, LOG_CARD_META_BYTES, LOG_CARD_META_PAGES, LOG_CARD_META_SIZE, LOG_CARD_UNITS, LOG_MIN_ALIGNMENT, MAX_ALIGNMENT, MAX_BYTES_PADDING, MAX_INT, MIN_ALIGNMENT, MIN_INT, PUTFIELD_WRITE_BARRIER, PUTSTATIC_WRITE_BARRIER, SUPPORT_CARD_SCANNING
 
Constructor Summary
ImmixMutator()
          Constructor
 
Method Summary
 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.
 Space getSpaceFromAllocator(Allocator a)
          Return the space into which an allocator is allocating.
 void postAlloc(ObjectReference ref, ObjectReference typeRef, int bytes, int allocator)
          Perform post-allocation actions.
 
Methods inherited from class org.mmtk.plan.MutatorContext
assertRemsetsFlushed, checkAllocator, flush, flushRememberedSets, getId, getOwnAllocator, initMutator, readBarrier, referenceTypeReadBarrier, tryCompareAndSwapWriteBarrier, writeBarrier, writeBarrier
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

immix

protected final MutatorLocal immix
Instance fields

Constructor Detail

ImmixMutator

public ImmixMutator()
Constructor

Method Detail

alloc

public Address alloc(int bytes,
                     int align,
                     int offset,
                     int allocator,
                     int site)
Allocate memory for an object. This class handles the default allocator from the mark sweep space, and delegates everything else to the superclass.

Overrides:
alloc in class MutatorContext
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 memory.

postAlloc

public void postAlloc(ObjectReference ref,
                      ObjectReference typeRef,
                      int bytes,
                      int allocator)
Perform post-allocation actions. Initialize the object header for objects in the mark-sweep space, and delegate to the superclass for other objects.

Overrides:
postAlloc in class MutatorContext
Parameters:
ref - 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

getSpaceFromAllocator

public Space getSpaceFromAllocator(Allocator a)
Return the space into which an allocator is allocating. This particular method will match against those spaces defined at this level of the class hierarchy. Subclasses must deal with spaces they define and refer to superclasses appropriately.

Overrides:
getSpaceFromAllocator in class MutatorContext
Parameters:
a - An allocator
Returns:
The space into which a is allocating, or null if there is no space associated with a.

getAllocatorFromSpace

public Allocator getAllocatorFromSpace(Space space)
Return the allocator instance associated with a space space, for this plan instance.

Overrides:
getAllocatorFromSpace in class MutatorContext
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.

Overrides:
collectionPhase in class SimpleMutator
Parameters:
phaseId - The collection phase to perform
primary - Perform any single-threaded activities using this thread.