Magic (Jikes RVM API)

java.lang.Object
- org.jikesrvm.runtime.Magic

```
public final class Magic
extends Object
```
Magic methods for accessing raw machine memory, registers, and operating system calls.
These are "inline assembler functions" that cannot be implemented in Java code. Their names are recognized by RVM's compilers and cause inline machine code to be generated instead of actual method calls.

Field Summary

Fields
Modifier and Type Field and Description

private static ObjectAddressRemapper objectAddressRemapper

Fields
Modifier and Type	Field and Description
`private static ObjectAddressRemapper`	`objectAddressRemapper`

Constructor Summary

Constructors
Constructor and Description

Magic()

Constructors
Constructor and Description
`Magic()`

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static byte[]`	`addressAsByteArray(Address byte_array)` Recast.
`static Object`	`addressAsObject(Address address)` Cast bits.
`static TIB`	`addressAsTIB(Address address)` Cast bits.
`static boolean`	`attemptAddress(Object object, Offset offset, Address oldValue, Address newValue)` Sets the memory at (object + offset) to newValue if its contents are oldValue.
`static boolean`	`attemptInt(Object object, Offset offset, int oldValue, int newValue)` Sets the memory at (object + offset) to newValue if its contents are oldValue.
`static boolean`	`attemptLong(Object object, Offset offset, long oldValue, long newValue)` Sets the memory at (object + offset) to newValue if its contents are oldValue.
`static boolean`	`attemptObject(Object object, Offset offset, Object oldValue, Object newValue)` Sets the memory at (object + offset) to newValue if its contents are oldValue.
`static boolean`	`attemptWord(Object object, Offset offset, Word oldValue, Word newValue)` Sets the memory at (object + offset) to newValue if its contents are oldValue.
`static int`	`bootImageIdentityHashCode(Object object)` Certain objects aren't replicated in the boot image to save space.
`static <T> T`	`bootImageIntern(T object)` Certain objects aren't replicated in the boot image to save space.
`static Object`	`codeArrayAsObject(CodeArray code)` Cast bits of code array into an object Note: for use by Statics when assigning slots to static method pointers
`static void`	`combinedLoadBarrier()` Emits an instruction that provides both a LoadLoad and a LoadStore barrier.
`static long`	`doubleAsLongBits(double number)` Cast bits.
`static void`	`dynamicBridgeTo(CodeArray instructions)` Transfer execution to target of a dynamic bridge method.
`static void`	`fence()` Emits a strong memory fence, used to enforce StoreLoad in the JMM.
`static int`	`floatAsIntBits(float number)` Cast bits.
`static Address`	`getAddressAtOffset(Object object, Offset offset)` Get Address at arbitrary (byte) offset from object.
`static Address`	`getAddressAtOffset(Object object, Offset offset, int locationMetadata)` Get Address at arbitrary (byte) offset from object.
`static int`	`getArrayLength(Object object)` Get an array's length.
`static byte`	`getByteAtOffset(Object object, Offset offset)` Get byte at arbitrary (byte) offset from object.
`static Address`	`getCallerFramePointer(Address fp)` Get fp for parent frame
`static char`	`getCharAtOffset(Object object, Offset offset)` Get char at arbitrary (byte) offset from object.
`static int`	`getCompiledMethodID(Address fp)`
`static double`	`getDoubleAtOffset(Object object, Offset offset)` Get double at arbitrary (byte) offset from object.
`static RVMThread`	`getESIAsThread()`
`static Extent`	`getExtentAtOffset(Object object, Offset offset)` Get Extent at arbitrary (byte) offset from object.
`static Extent`	`getExtentAtOffset(Object object, Offset offset, int locationMetadata)` Get Extent at arbitrary (byte) offset from object.
`static float`	`getFloatAtOffset(Object object, Offset offset)` Get float at arbitrary (byte) offset from object.
`static Address`	`getFramePointer()`
`static int`	`getInlineDepth()` How deeply inlined is this method (0 means no inlining).
`static int`	`getIntAtOffset(Object object, Offset offset)` Get int at arbitrary (byte) offset from object.
`static Address`	`getJTOC()`
`static long`	`getLongAtOffset(Object object, Offset offset)` Get long at arbitrary (byte) offset from object.
`static Address`	`getNextInstructionAddress(Address fp)`
`static Object`	`getObjectAtOffset(Object object, Offset offset)` Get Object at arbitrary (byte) offset from object.
`static Object`	`getObjectAtOffset(Object object, Offset offset, int locationMetadata)` Get Object at arbitrary (byte) offset from object.
`static RVMType`	`getObjectType(Object object)` Get an object's type.
`static Offset`	`getOffsetAtOffset(Object object, Offset offset)` Get Offset at arbitrary (byte) offset from object.
`static Offset`	`getOffsetAtOffset(Object object, Offset offset, int locationMetadata)` Get Offset at arbitrary (byte) offset from object.
`static Address`	`getReturnAddress(Address fp)` Get return address for a frame in the current thread
`static Address`	`getReturnAddress(Address fp, RVMThread thread)` Get return address for a frame in a specific thread
`static Address`	`getReturnAddressLocation(Address fp)`
`static Address`	`getReturnAddressUnchecked(Address fp)` Get return address for a frame in a case where the frame is known not to be a trampoline frame.
`static short`	`getShortAtOffset(Object object, Offset offset)` Get short at arbitrary (byte) offset from object.
`static RVMThread`	`getThreadRegister()`
`static TIB`	`getTIBAtOffset(Object object, Offset offset)` Get TIB at arbitrary (byte) offset from object.
`static long`	`getTimeBase()` Reads contents of hardware time base registers.
`static Address`	`getTocPointer()`
`static byte`	`getUnsignedByteAtOffset(Object object, Offset offset)` Get unsigned byte at arbitrary (byte) offset from object.
`static Word`	`getWordAtOffset(Object object, Offset offset)` Get Word at arbitrary (byte) offset from object.
`static Word`	`getWordAtOffset(Object object, Offset offset, int locationMetadata)` Get Word at arbitrary (byte) offset from object.
`static float`	`intBitsAsFloat(int number)` Cast bits.
`static void`	`invokeClassInitializer(CodeArray clinit)` Call <clinit> method with no argument list
`static double`	`invokeMethodReturningDouble(CodeArray code, WordArray gprs, double[] fprs, byte[] fprmeta, WordArray spills)`
`static float`	`invokeMethodReturningFloat(CodeArray code, WordArray gprs, double[] fprs, byte[] fprmeta, WordArray spills)`
`static int`	`invokeMethodReturningInt(CodeArray code, WordArray gprs, double[] fprs, byte[] fprmeta, WordArray spills)`
`static long`	`invokeMethodReturningLong(CodeArray code, WordArray gprs, double[] fprs, byte[] fprmeta, WordArray spills)`
`static Object`	`invokeMethodReturningObject(CodeArray code, WordArray gprs, double[] fprs, byte[] fprmeta, WordArray spills)`
`static void`	`invokeMethodReturningVoid(CodeArray code, WordArray gprs, double[] fprs, byte[] fprmeta, WordArray spills)`
`static boolean`	`isConstantParameter(int index)` Is the specified parameter constant (due to either inlining or specialization).
`static void`	`isync()` Wait for all preceeding instructions to complete and discard any prefetched instructions on this processor.
`static double`	`longBitsAsDouble(long number)` Cast bits.
`static <T> Address`	`objectAsAddress(T object)` Cast bits.
`static int[]`	`objectAsIntArray(Object object)` Cast object.
`static short[]`	`objectAsShortArray(Object object)` Cast object.
`static RVMThread`	`objectAsThread(Object object)` Cast object.
`static RVMType`	`objectAsType(Object object)` Cast object.
`static void`	`pause()` On IA32, emit a PAUSE instruction, to optimize spin-wait loops.
`static Address`	`prepareAddress(Object object, Offset offset)` Get contents of (object + offset) and begin conditional critical section.
`static int`	`prepareInt(Object object, Offset offset)` Gets contents of (object + offset) and begin conditional critical section.
`static long`	`prepareLong(Object object, Offset offset)` Get contents of (object + offset) and begin conditional critical section.
`static Object`	`prepareObject(Object object, Offset offset)` Get contents of (object + offset) and begin conditional critical section.
`static Word`	`prepareWord(Object object, Offset offset)` Get contents of (object + offset) and begin conditional critical section.
`static void`	`restoreHardwareExceptionState(AbstractRegisters registers)` Resume execution with specified thread exception state.
`static void`	`returnToNewStack(Address fp)` Return to caller of current method, resuming execution on a new stack that's a copy of the original.
`static void`	`saveThreadState(AbstractRegisters registers)` Saves current thread state.
`static void`	`setAddressAtOffset(Object object, Offset offset, Address newvalue)` Set Address at arbitrary (byte) offset from object.
`static void`	`setAddressAtOffset(Object object, Offset offset, Address newvalue, int locationMetadata)` Set Address at arbitrary (byte) offset from object.
`static void`	`setBooleanAtOffset(Object object, Offset offset, boolean newvalue)` Set boolean at arbitrary (byte) offset from object.
`static void`	`setBooleanAtOffset(Object object, Offset offset, boolean newvalue, int locationMetadata)` Set boolean at arbitrary (byte) offset from object.
`static void`	`setByteAtOffset(Object object, Offset offset, byte newvalue)` Set byte at arbitrary (byte) offset from object.
`static void`	`setByteAtOffset(Object object, Offset offset, byte newvalue, int locationMetadata)` Set byte at arbitrary (byte) offset from object.
`static void`	`setCallerFramePointer(Address fp, Address newCallerFP)` Set fp for parent frame
`static void`	`setCharAtOffset(Object object, Offset offset, char newvalue)` Set char at arbitrary (byte) offset from object.
`static void`	`setCharAtOffset(Object object, Offset offset, char newvalue, int locationMetadata)` Set char at arbitrary (byte) offset from object.
`static void`	`setCompiledMethodID(Address fp, int newCMID)` Sets the Compiled Method ID for a frame.
`static void`	`setDoubleAtOffset(Object object, Offset offset, double newvalue)` Set double at arbitrary (byte) offset from object.
`static void`	`setDoubleAtOffset(Object object, Offset offset, double newvalue, int locationMetadata)` Set double at arbitrary (byte) offset from object.
`static void`	`setESIAsThread(RVMThread p)` Sets contents of ESI to hold a reference to a thread object.
`static void`	`setExtentAtOffset(Object object, Offset offset, Extent newvalue)` Set Extent at arbitrary (byte) offset from object.
`static void`	`setExtentAtOffset(Object object, Offset offset, Extent newvalue, int locationMetadata)` Set Extent at arbitrary (byte) offset from object.
`static void`	`setFloatAtOffset(Object object, Offset offset, float newvalue)` Set float at arbitrary (byte) offset from object.
`static void`	`setFloatAtOffset(Object object, Offset offset, float newvalue, int locationMetadata)` Set float at arbitrary (byte) offset from object.
`static void`	`setIntAtOffset(Object object, Offset offset, int newvalue)` Set int at arbitrary (byte) offset from object.
`static void`	`setIntAtOffset(Object object, Offset offset, int newvalue, int locationMetadata)` Set int at arbitrary (byte) offset from object.
`static void`	`setLongAtOffset(Object object, Offset offset, long newvalue)` Set long at arbitrary (byte) offset from object.
`static void`	`setLongAtOffset(Object object, Offset offset, long newvalue, int locationMetadata)` Set long at arbitrary (byte) offset from object.
`static void`	`setObjectAddressRemapper(ObjectAddressRemapper x)` Specify how to handle "objectAsAddress" and "addressAsObject" casts.
`static void`	`setObjectAtOffset(Object object, Offset offset, Object newvalue)` Set Object at arbitrary (byte) offset from object.
`static void`	`setObjectAtOffset(Object object, Offset offset, Object newvalue, int locationMetadata)` Set Object at arbitrary (byte) offset from object
`static void`	`setOffsetAtOffset(Object object, Offset offset, Offset newvalue)` Set Offset at arbitrary (byte) offset from object.
`static void`	`setOffsetAtOffset(Object object, Offset offset, Offset newvalue, int locationMetadata)` Set Offset at arbitrary (byte) offset from object.
`static void`	`setReturnAddress(Address fp, Address v)` Sets return address for a frame.
`static void`	`setShortAtOffset(Object object, Offset offset, short newvalue)` Set short at arbitrary (byte) offset from object.
`static void`	`setShortAtOffset(Object object, Offset offset, short newvalue, int locationMetadata)` Set short at arbitrary (byte) offset from object.
`static void`	`setThreadRegister(RVMThread p)` Sets contents of "thread" register.
`static void`	`setWordAtOffset(Object object, Offset offset, Word newvalue)` Set Word at arbitrary (byte) offset from object.
`static void`	`setWordAtOffset(Object object, Offset offset, Word newvalue, int locationMetadata)` Set Word at arbitrary (byte) offset from object.
`static double`	`sqrt(double value)` A hardware SQRT instruction.
`static float`	`sqrt(float value)` A hardware SQRT instruction.
`static void`	`storeStoreBarrier()` Emits a StoreStore barrier.
`static void`	`sync()` Wait for preceeding cache flush/invalidate instructions to complete on all processors.
`static void`	`threadSwitch(RVMThread currentThread, AbstractRegisters restoreRegs)` Switch threads.
`static Object`	`tibAsObject(TIB tib)` Cast bits of tib into an object Note: for use by Statics when assigning slots

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - objectAddressRemapper
```
private static ObjectAddressRemapper objectAddressRemapper
```
- Constructor Detail
  - Magic
```
public Magic()
```
- Method Detail
  - getFramePointer
```
public static Address getFramePointer()
```
    Returns:
    
    contents of "stack frame pointer" register.
  - getTocPointer
```
public static Address getTocPointer()
```
    Returns:
    
    contents of "JTOC" register.
  - getJTOC
```
public static Address getJTOC()
```
    Returns:
    
    contents of "JTOC" register
  - getThreadRegister
```
public static RVMThread getThreadRegister()
```
    Returns:
    
    contents of "thread" register.
  - setThreadRegister
```
public static void setThreadRegister(RVMThread p)
```
    Sets contents of "thread" register.
    
    Parameters:
    
    p - new contents of the thread register
  - getESIAsThread
```
public static RVMThread getESIAsThread()
```
    Returns:
    
    contents of ESI, as a RVMThread. NOTE: IA-specific
  - setESIAsThread
```
public static void setESIAsThread(RVMThread p)
```
    Sets contents of ESI to hold a reference to a thread object. NOTE: IA-specific.
    
    Parameters:
    
    p - the thread
  - getTimeBase
```
public static long getTimeBase()
```
    Reads contents of hardware time base registers.
    Note: we think that 1 "tick" == 4 "machine cycles", but this seems to be undocumented and may vary across processor implementations.
    
    Returns:
    
    number of ticks (epoch undefined)
  - getCallerFramePointer
```
public static Address getCallerFramePointer(Address fp)
```
    Get fp for parent frame
    
    Parameters:
    
    fp - frame pointer for child frame
    
    Returns:
    
    the frame pointer of the parent frame
  - setCallerFramePointer
```
public static void setCallerFramePointer(Address fp,
                                         Address newCallerFP)
```
    Set fp for parent frame
    
    Parameters:
    
    fp - frame pointer for child frame
    
    newCallerFP - new value for caller frame pointer
  - getCompiledMethodID
```
public static int getCompiledMethodID(Address fp)
```
    Parameters:
    
    fp - its frame pointer
    
    Returns:
    
    the compiled Method ID for the frame
  - setCompiledMethodID
```
public static void setCompiledMethodID(Address fp,
                                       int newCMID)
```
    Sets the Compiled Method ID for a frame.
    
    Parameters:
    
    fp - its frame pointer
    
    newCMID - a new cmid for the frame
  - getNextInstructionAddress
```
public static Address getNextInstructionAddress(Address fp)
```
    Parameters:
    
    fp - its frame pointer.
    
    Returns:
    
    next instruction address for a frame
  - getReturnAddressLocation
```
public static Address getReturnAddressLocation(Address fp)
```
    Parameters:
    
    fp - its frame pointer
    
    Returns:
    
    location containing return address for a frame
  - getReturnAddressUnchecked
```
public static Address getReturnAddressUnchecked(Address fp)
```
    Get return address for a frame in a case where the frame is known not to be a trampoline frame.
    
    Parameters:
    
    fp - its frame pointer
    
    Returns:
    
    the return address
  - getReturnAddress
```
public static Address getReturnAddress(Address fp)
```
    Get return address for a frame in the current thread
    
    Parameters:
    
    fp - its frame pointer
    
    Returns:
    
    the return address
  - getReturnAddress
```
public static Address getReturnAddress(Address fp,
                                       RVMThread thread)
```
    Get return address for a frame in a specific thread
    
    Parameters:
    
    fp - its frame pointer
    
    thread - the thread whose stack is being examined
    
    Returns:
    
    the return address
  - setReturnAddress
```
public static void setReturnAddress(Address fp,
                                    Address v)
```
    Sets return address for a frame.
    
    Parameters:
    
    fp - its frame pointer
    
    v - the new return address
  - getUnsignedByteAtOffset
```
public static byte getUnsignedByteAtOffset(Object object,
                                           Offset offset)
```
    Get unsigned byte at arbitrary (byte) offset from object. The most significant 24bits of the result will be 0.
    
    Parameters:
    
    object - the object serving as start address
    
    offset - the offset from the object
    
    Returns:
    
    the byte at the location
  - getByteAtOffset
```
public static byte getByteAtOffset(Object object,
                                   Offset offset)
```
    Get byte at arbitrary (byte) offset from object. The most significant 24bits of the result will be the same as the most significant bit in the byte.
    
    Parameters:
    
    object - the object serving as start address
    
    offset - the offset from the object
    
    Returns:
    
    the byte at the location
  - getCharAtOffset
```
public static char getCharAtOffset(Object object,
                                   Offset offset)
```
    Get char at arbitrary (byte) offset from object. The most significant 16bits will be 0.
    
    Parameters:
    
    object - the object serving as start address
    
    offset - the offset from the object
    
    Returns:
    
    the char at the location
  - getShortAtOffset
```
public static short getShortAtOffset(Object object,
                                     Offset offset)
```
    Get short at arbitrary (byte) offset from object. The most significant 16bits will be the same as the most significant bit in the short.
    
    Parameters:
    
    object - the object serving as start address
    
    offset - the offset from the object
    
    Returns:
    
    the short at the location
  - getIntAtOffset
```
public static int getIntAtOffset(Object object,
                                 Offset offset)
```
    Get int at arbitrary (byte) offset from object. Use getIntAtOffset(obj, ofs) instead of getMemoryInt(objectAsAddress(obj)+ofs)
    
    Parameters:
    
    object - the object serving as start address
    
    offset - the offset from the object
    
    Returns:
    
    the int at the location
  - getLongAtOffset
```
public static long getLongAtOffset(Object object,
                                   Offset offset)
```
    Get long at arbitrary (byte) offset from object. Use getlongAtOffset(obj, ofs) instead of two getIntAtOffset
    
    Parameters:
    
    object - the object serving as start address
    
    offset - the offset from the object
    
    Returns:
    
    the long at the location
  - getFloatAtOffset
```
public static float getFloatAtOffset(Object object,
                                     Offset offset)
```
    Get float at arbitrary (byte) offset from object.
    
    Parameters:
    
    object - the object serving as start address
    
    offset - the offset from the object
    
    Returns:
    
    the float at the location
  - getDoubleAtOffset
```
public static double getDoubleAtOffset(Object object,
                                       Offset offset)
```
    Get double at arbitrary (byte) offset from object. Use getDoubleAtOffset(obj, ofs) instead of two getIntAtOffset
    
    Parameters:
    
    object - the object serving as start address
    
    offset - the offset from the object
    
    Returns:
    
    the double at the location
  - getObjectAtOffset
```
public static Object getObjectAtOffset(Object object,
                                       Offset offset)
```
    Get Object at arbitrary (byte) offset from object. Use getObjectAtOffset(obj, ofs) instead of addressAsObject(getMemoryAddress(objectAsAddress(obj)+ofs))
    
    Parameters:
    
    object - the object serving as start address
    
    offset - the offset from the object
    
    Returns:
    
    the object at the location
  - getObjectAtOffset
```
public static Object getObjectAtOffset(Object object,
                                       Offset offset,
                                       int locationMetadata)
```
    Get Object at arbitrary (byte) offset from object. Use getObjectAtOffset(obj, ofs) instead of addressAsObject(getMemoryAddress(objectAsAddress(obj)+ofs))
    
    Parameters:
    
    object - the object serving as start address
    
    offset - the offset from the object
    
    locationMetadata - metadata about the location for the compilers
    
    Returns:
    
    the object at the computed address
  - getWordAtOffset
```
public static Word getWordAtOffset(Object object,
                                   Offset offset)
```
    Get Word at arbitrary (byte) offset from object. Use getWordAtOffset(obj, ofs) instead of getMemoryWord(objectAsAddress(obj)+ofs)
    
    Parameters:
    
    object - the object serving as start address
    
    offset - the offset from the object
    
    Returns:
    
    the word at the computed address
  - getWordAtOffset
```
public static Word getWordAtOffset(Object object,
                                   Offset offset,
                                   int locationMetadata)
```
    Get Word at arbitrary (byte) offset from object.
    
    Parameters:
    
    object - the object serving as start address
    
    offset - the offset from the object
    
    locationMetadata - metadata about the location for the compilers
    
    Returns:
    
    the Word at the computed address
  - getAddressAtOffset
```
public static Address getAddressAtOffset(Object object,
                                         Offset offset)
```
    Get Address at arbitrary (byte) offset from object. Use getAddressAtOffset(obj, ofs) instead of getMemoryWord(objectAsAddress(obj)+ofs)
    
    Parameters:
    
    object - the object serving as start address
    
    offset - the offset from the object
    
    Returns:
    
    the Address at the computed address
  - getAddressAtOffset
```
public static Address getAddressAtOffset(Object object,
                                         Offset offset,
                                         int locationMetadata)
```
    Get Address at arbitrary (byte) offset from object.
    
    Parameters:
    
    object - the object serving as start address
    
    offset - the offset from the object
    
    locationMetadata - metadata about the location for the compilers
    
    Returns:
    
    the Address at the computed address
  - getExtentAtOffset
```
public static Extent getExtentAtOffset(Object object,
                                       Offset offset)
```
    Get Extent at arbitrary (byte) offset from object. Use getExtentAtOffset(obj, ofs) instead of getMemoryWord(objectAsAddress(obj)+ofs)
    
    Parameters:
    
    object - the object serving as start address
    
    offset - the offset from the object
    
    Returns:
    
    the Extent at the computed address
  - getExtentAtOffset
```
public static Extent getExtentAtOffset(Object object,
                                       Offset offset,
                                       int locationMetadata)
```
    Get Extent at arbitrary (byte) offset from object.
    
    Parameters:
    
    object - the object serving as start address
    
    offset - the offset from the object
    
    locationMetadata - metadata about the location for the compilers
    
    Returns:
    
    the Extent at the computed address
  - getOffsetAtOffset
```
public static Offset getOffsetAtOffset(Object object,
                                       Offset offset)
```
    Get Offset at arbitrary (byte) offset from object. Use getOffsetAtOffset(obj, ofs) instead of getMemoryWord(objectAsAddress(obj)+ofs)
    
    Parameters:
    
    object - the object serving as start address
    
    offset - the offset from the object
    
    Returns:
    
    the Offset at the computed address
  - getOffsetAtOffset
```
public static Offset getOffsetAtOffset(Object object,
                                       Offset offset,
                                       int locationMetadata)
```
    Get Offset at arbitrary (byte) offset from object.
    
    Parameters:
    
    object - the object serving as start address
    
    offset - the offset from the object
    
    locationMetadata - metadata about the location for the compilers
    
    Returns:
    
    the Offset at the computed address
  - getTIBAtOffset
```
public static TIB getTIBAtOffset(Object object,
                                 Offset offset)
```
    Get TIB at arbitrary (byte) offset from object. Use getTIBAtOffset(obj, ofs) instead of (TIB])addressAsObject(getMemoryAddr(objectAsAddress(obj)+ofs))
    
    Parameters:
    
    object - the object serving as start address
    
    offset - the offset from the object
    
    Returns:
    
    the TIB at the computed address
  - setBooleanAtOffset
```
public static void setBooleanAtOffset(Object object,
                                      Offset offset,
                                      boolean newvalue)
```
    Set boolean at arbitrary (byte) offset from object.
    
    Parameters:
    
    object - the object serving as start address
    
    offset - the offset from the object
    
    newvalue - the value to write to the computed address
  - setBooleanAtOffset
```
public static void setBooleanAtOffset(Object object,
                                      Offset offset,
                                      boolean newvalue,
                                      int locationMetadata)
```
    Set boolean at arbitrary (byte) offset from object.
    
    Parameters:
    
    object - the object serving as start address
    
    offset - the offset from the object
    
    newvalue - the value to write to the computed address
    
    locationMetadata - metadata about the location for the compilers
  - setByteAtOffset
```
public static void setByteAtOffset(Object object,
                                   Offset offset,
                                   byte newvalue)
```
    Set byte at arbitrary (byte) offset from object.
    
    Parameters:
    
    object - the object serving as start address
    
    offset - the offset from the object
    
    newvalue - the value to write to the computed address
  - setByteAtOffset
```
public static void setByteAtOffset(Object object,
                                   Offset offset,
                                   byte newvalue,
                                   int locationMetadata)
```
    Set byte at arbitrary (byte) offset from object.
    
    Parameters:
    
    object - the object serving as start address
    
    offset - the offset from the object
    
    newvalue - the value to write to the computed address
    
    locationMetadata - metadata about the location for the compilers
  - setCharAtOffset
```
public static void setCharAtOffset(Object object,
                                   Offset offset,
                                   char newvalue)
```
    Set char at arbitrary (byte) offset from object.
    
    Parameters:
    
    object - the object serving as start address
    
    offset - the offset from the object
    
    newvalue - the value to write to the computed address
  - setCharAtOffset
```
public static void setCharAtOffset(Object object,
                                   Offset offset,
                                   char newvalue,
                                   int locationMetadata)
```
    Set char at arbitrary (byte) offset from object.
    
    Parameters:
    
    object - the object serving as start address
    
    offset - the offset from the object
    
    newvalue - the value to write to the computed address
    
    locationMetadata - metadata about the location for the compilers
  - setShortAtOffset
```
public static void setShortAtOffset(Object object,
                                    Offset offset,
                                    short newvalue)
```
    Set short at arbitrary (byte) offset from object.
    
    Parameters:
    
    object - the object serving as start address
    
    offset - the offset from the object
    
    newvalue - the value to write to the computed address
  - setShortAtOffset
```
public static void setShortAtOffset(Object object,
                                    Offset offset,
                                    short newvalue,
                                    int locationMetadata)
```
    Set short at arbitrary (byte) offset from object.
    
    Parameters:
    
    object - the object serving as start address
    
    offset - the offset from the object
    
    newvalue - the value to write to the computed address
    
    locationMetadata - metadata about the location for the compilers
  - setIntAtOffset
```
public static void setIntAtOffset(Object object,
                                  Offset offset,
                                  int newvalue)
```
    Set int at arbitrary (byte) offset from object. Use setIntAtOffset(obj, ofs, new) instead of setMemoryWord(objectAsAddress(obj)+ofs, new)
    
    Parameters:
    
    object - the object serving as start address
    
    offset - the offset from the object
    
    newvalue - the value to write to the computed address
  - setIntAtOffset
```
public static void setIntAtOffset(Object object,
                                  Offset offset,
                                  int newvalue,
                                  int locationMetadata)
```
    Set int at arbitrary (byte) offset from object.
    
    Parameters:
    
    object - the object serving as start address
    
    offset - the offset from the object
    
    newvalue - the value to write to the computed address
    
    locationMetadata - metadata about the location for the compilers
  - setLongAtOffset
```
public static void setLongAtOffset(Object object,
                                   Offset offset,
                                   long newvalue)
```
    Set long at arbitrary (byte) offset from object. Use setlongAtOffset(obj, ofs) instead of two setIntAtOffset
    
    Parameters:
    
    object - the object serving as start address
    
    offset - the offset from the object
    
    newvalue - the value to write to the computed address
  - setLongAtOffset
```
public static void setLongAtOffset(Object object,
                                   Offset offset,
                                   long newvalue,
                                   int locationMetadata)
```
    Set long at arbitrary (byte) offset from object. Use setlongAtOffset(obj, ofs) instead of two setIntAtOffset
    
    Parameters:
    
    object - the object serving as start address
    
    offset - the offset from the object
    
    newvalue - the value to write to the computed address
    
    locationMetadata - metadata about the location for the compilers
  - setFloatAtOffset
```
public static void setFloatAtOffset(Object object,
                                    Offset offset,
                                    float newvalue)
```
    Set float at arbitrary (byte) offset from object.
    
    Parameters:
    
    object - the object serving as start address
    
    offset - the offset from the object
    
    newvalue - the value to write to the computed address
  - setFloatAtOffset
```
public static void setFloatAtOffset(Object object,
                                    Offset offset,
                                    float newvalue,
                                    int locationMetadata)
```
    Set float at arbitrary (byte) offset from object.
    
    Parameters:
    
    object - the object serving as start address
    
    offset - the offset from the object
    
    newvalue - the value to write to the computed address
    
    locationMetadata - metadata about the location for the compilers
  - setDoubleAtOffset
```
public static void setDoubleAtOffset(Object object,
                                     Offset offset,
                                     double newvalue)
```
    Set double at arbitrary (byte) offset from object. Use setDoubleAtOffset(obj, ofs) instead of two setIntAtOffset
    
    Parameters:
    
    object - the object serving as start address
    
    offset - the offset from the object
    
    newvalue - the value to write to the computed address
  - setDoubleAtOffset
```
public static void setDoubleAtOffset(Object object,
                                     Offset offset,
                                     double newvalue,
                                     int locationMetadata)
```
    Set double at arbitrary (byte) offset from object. Use setDoubleAtOffset(obj, ofs) instead of two setIntAtOffset
    
    Parameters:
    
    object - the object serving as start address
    
    offset - the offset from the object
    
    newvalue - the value to write to the computed address
    
    locationMetadata - metadata about the location for the compilers
  - setWordAtOffset
```
public static void setWordAtOffset(Object object,
                                   Offset offset,
                                   Word newvalue)
```
    Set Word at arbitrary (byte) offset from object. Use setWordAtOffset(obj, ofs, new) instead of setMemoryWord(objectAsAddress(obj)+ofs, new)
    
    Parameters:
    
    object - the object serving as start address
    
    offset - the offset from the object
    
    newvalue - the value to write to the computed address
  - setWordAtOffset
```
public static void setWordAtOffset(Object object,
                                   Offset offset,
                                   Word newvalue,
                                   int locationMetadata)
```
    Set Word at arbitrary (byte) offset from object. Use setWordAtOffset(obj, ofs, new) instead of setMemoryWord(objectAsAddress(obj)+ofs, new)
    
    Parameters:
    
    object - the object serving as start address
    
    offset - the offset from the object
    
    newvalue - the value to write to the computed address
    
    locationMetadata - metadata about the location for the compilers
  - setAddressAtOffset
```
public static void setAddressAtOffset(Object object,
                                      Offset offset,
                                      Address newvalue)
```
    Set Address at arbitrary (byte) offset from object. Use setAddressAtOffset(obj, ofs, new) instead of setMemoryWord(objectAsAddress(obj)+ofs, new)
    
    Parameters:
    
    object - the object serving as start address
    
    offset - the offset from the object
    
    newvalue - the value to write to the computed address
  - setAddressAtOffset
```
public static void setAddressAtOffset(Object object,
                                      Offset offset,
                                      Address newvalue,
                                      int locationMetadata)
```
    Set Address at arbitrary (byte) offset from object. Use setAddressAtOffset(obj, ofs, new) instead of setMemoryWord(objectAsAddress(obj)+ofs, new)
    
    Parameters:
    
    object - the object serving as start address
    
    offset - the offset from the object
    
    newvalue - the value to write to the computed address
    
    locationMetadata - metadata about the location for the compilers
  - setExtentAtOffset
```
public static void setExtentAtOffset(Object object,
                                     Offset offset,
                                     Extent newvalue)
```
    Set Extent at arbitrary (byte) offset from object. Use setExtentAtOffset(obj, ofs, new) instead of setMemoryWord(objectAsAddress(obj)+ofs, new)
    
    Parameters:
    
    object - the object serving as start address
    
    offset - the offset from the object
    
    newvalue - the value to write to the computed address
  - setExtentAtOffset
```
public static void setExtentAtOffset(Object object,
                                     Offset offset,
                                     Extent newvalue,
                                     int locationMetadata)
```
    Set Extent at arbitrary (byte) offset from object. Use setExtenttOffset(obj, ofs, new) instead of setMemoryWord(objectAsAddress(obj)+ofs, new)
    
    Parameters:
    
    object - the object serving as start address
    
    offset - the offset from the object
    
    newvalue - the value to write to the computed address
    
    locationMetadata - metadata about the location for the compilers
  - setOffsetAtOffset
```
public static void setOffsetAtOffset(Object object,
                                     Offset offset,
                                     Offset newvalue)
```
    Set Offset at arbitrary (byte) offset from object. Use setOffsetAtOffset(obj, ofs, new) instead of setMemoryWord(objectAsAddress(obj)+ofs, new)
    
    Parameters:
    
    object - the object serving as start address
    
    offset - the offset from the object
    
    newvalue - the value to write to the computed address
  - setOffsetAtOffset
```
public static void setOffsetAtOffset(Object object,
                                     Offset offset,
                                     Offset newvalue,
                                     int locationMetadata)
```
    Set Offset at arbitrary (byte) offset from object. Use setOffsetAtOffset(obj, ofs, new) instead of setMemoryWord(objectAsAddress(obj)+ofs, new)
    
    Parameters:
    
    object - the object serving as start address
    
    offset - the offset from the object
    
    newvalue - the value to write to the computed address
    
    locationMetadata - metadata about the location for the compilers
  - setObjectAtOffset
```
public static void setObjectAtOffset(Object object,
                                     Offset offset,
                                     Object newvalue)
```
    Set Object at arbitrary (byte) offset from object. Use setObjectAtOffset(obj, ofs, new) instead of setMemoryWord(objectAsAddress(obj)+ofs, objectAsAddress(new))
    
    Parameters:
    
    object - the object serving as start address
    
    offset - the offset from the object
    
    newvalue - the value to write to the computed address
  - setObjectAtOffset
```
public static void setObjectAtOffset(Object object,
                                     Offset offset,
                                     Object newvalue,
                                     int locationMetadata)
```
    Set Object at arbitrary (byte) offset from object
    
    Parameters:
    
    object - the object serving as start address
    
    offset - the offset from the object
    
    newvalue - the value to write to the computed address
    
    locationMetadata - metadata about the location for the compilers
  - prepareInt
```
public static int prepareInt(Object object,
                             Offset offset)
```
    Gets contents of (object + offset) and begin conditional critical section.
    
    Parameters:
    
    object - the object serving as start address
    
    offset - the offset from the object
    
    Returns:
    
    the int that was read out from the computed address
  - prepareObject
```
public static Object prepareObject(Object object,
                                   Offset offset)
```
    Get contents of (object + offset) and begin conditional critical section.
    
    Parameters:
    
    object - the object serving as start address
    
    offset - the offset from the object
    
    Returns:
    
    the object that was read out from the computed address
  - prepareAddress
```
public static Address prepareAddress(Object object,
                                     Offset offset)
```
    Get contents of (object + offset) and begin conditional critical section.
    
    Parameters:
    
    object - the object serving as start address
    
    offset - the offset from the object
    
    Returns:
    
    the Address that was read out from the computed address
  - prepareWord
```
public static Word prepareWord(Object object,
                               Offset offset)
```
    Get contents of (object + offset) and begin conditional critical section.
    
    Parameters:
    
    object - the object serving as start address
    
    offset - the offset from the object
    
    Returns:
    
    the Word that was read out from the computed address
  - prepareLong
```
public static long prepareLong(Object object,
                               Offset offset)
```
    Get contents of (object + offset) and begin conditional critical section.
    
    Parameters:
    
    object - the object serving as start address
    
    offset - the offset from the object
    
    Returns:
    
    the long that was read out from the computed address
  - attemptInt
```
public static boolean attemptInt(Object object,
                                 Offset offset,
                                 int oldValue,
                                 int newValue)
```
    Sets the memory at (object + offset) to newValue if its contents are oldValue. Must be paired with a preceding prepare (which returned the oldValue). Ends conditional critical section.
    
    Parameters:
    
    object - the object serving as start address
    
    offset - the offset from the object
    
    oldValue - the value that is expected to be at the computed address
    
    newValue - the value that is supposed to be written to the computed address
    
    Returns:
    
    true if successful, false if not
  - attemptObject
```
public static boolean attemptObject(Object object,
                                    Offset offset,
                                    Object oldValue,
                                    Object newValue)
```
    Sets the memory at (object + offset) to newValue if its contents are oldValue. Must be paired with a preceding prepare (which returned the oldValue) Ends conditional critical section.
    
    Parameters:
    
    object - the object serving as start address
    
    offset - the offset from the object
    
    oldValue - the value that is expected to be at the computed address
    
    newValue - the value that is supposed to be written to the computed address
    
    Returns:
    
    true if successful, false if not
  - attemptAddress
```
public static boolean attemptAddress(Object object,
                                     Offset offset,
                                     Address oldValue,
                                     Address newValue)
```
    Sets the memory at (object + offset) to newValue if its contents are oldValue. Must be paired with a preceding prepare (which returned the oldValue) Ends conditional critical section.
    
    Parameters:
    
    object - the object serving as start address
    
    offset - the offset from the object
    
    oldValue - the value that is expected to be at the computed address
    
    newValue - the value that is supposed to be written to the computed address
    
    Returns:
    
    true if successful, false if not
  - attemptWord
```
public static boolean attemptWord(Object object,
                                  Offset offset,
                                  Word oldValue,
                                  Word newValue)
```
    Sets the memory at (object + offset) to newValue if its contents are oldValue. Must be paired with a preceding prepare (which returned the oldValue) Ends conditional critical section.
    
    Parameters:
    
    object - the object serving as start address
    
    offset - the offset from the object
    
    oldValue - the value that is expected to be at the computed address
    
    newValue - the value that is supposed to be written to the computed address
    
    Returns:
    
    true if successful, false if not
  - attemptLong
```
public static boolean attemptLong(Object object,
                                  Offset offset,
                                  long oldValue,
                                  long newValue)
```
    Sets the memory at (object + offset) to newValue if its contents are oldValue. Must be paired with a preceding prepare (which returned the oldValue) Ends conditional critical section.
    
    Parameters:
    
    object - the object serving as start address
    
    offset - the offset from the object
    
    oldValue - the value that is expected to be at the computed address
    
    newValue - the value that is supposed to be written to the computed address
    
    Returns:
    
    true if successful, false if not
  - setObjectAddressRemapper
```
public static void setObjectAddressRemapper(ObjectAddressRemapper x)
```
    Specify how to handle "objectAsAddress" and "addressAsObject" casts. Used by debugger and boot image writer.
    
    Parameters:
    
    x - the remapper ot use
  - objectAsAddress
```
public static <T> Address objectAsAddress(T object)
```
    Cast bits. Note: the returned integer is only valid until next garbage collection cycle (thereafter the referenced object might have moved and its address changed)
    
    Type Parameters:
    
    T - the object's type
    
    Parameters:
    
    object - object reference
    
    Returns:
    
    object reference as bits
  - bootImageIntern
```
public static <T> T bootImageIntern(T object)
```
    Certain objects aren't replicated in the boot image to save space.
    
    Type Parameters:
    
    T - the object's type
    
    Parameters:
    
    object - to intern
    
    Returns:
    
    interned object
  - bootImageIdentityHashCode
```
public static int bootImageIdentityHashCode(Object object)
```
    Certain objects aren't replicated in the boot image to save space.
    
    Parameters:
    
    object - to intern
    
    Returns:
    
    interned object
  - addressAsObject
```
public static Object addressAsObject(Address address)
```
    Cast bits.
    
    Parameters:
    
    address - object reference as bits
    
    Returns:
    
    object reference
  - codeArrayAsObject
```
public static Object codeArrayAsObject(CodeArray code)
```
    Cast bits of code array into an object Note: for use by Statics when assigning slots to static method pointers
    
    Parameters:
    
    code - the code array to convert
    
    Returns:
    
    object reference
  - tibAsObject
```
public static Object tibAsObject(TIB tib)
```
    Cast bits of tib into an object Note: for use by Statics when assigning slots
    
    Parameters:
    
    tib - the tib to convert
    
    Returns:
    
    object reference
  - addressAsTIB
```
public static TIB addressAsTIB(Address address)
```
    Cast bits.
    
    Parameters:
    
    address - object array reference as bits
    
    Returns:
    
    object array reference
  - objectAsType
```
public static RVMType objectAsType(Object object)
```
    Cast object.
    
    Parameters:
    
    object - object reference
    
    Returns:
    
    object reference as type (no checking on cast)
  - objectAsThread
```
public static RVMThread objectAsThread(Object object)
```
    Cast object. Note: for use by GC to avoid checkcast during GC
    
    Parameters:
    
    object - object reference
    
    Returns:
    
    object reference as thread (no checking on cast)
  - floatAsIntBits
```
public static int floatAsIntBits(float number)
```
    Cast bits.
    
    Parameters:
    
    number - A floating point number
    
    Returns:
    
    number as bits
  - intBitsAsFloat
```
public static float intBitsAsFloat(int number)
```
    Cast bits.
    
    Parameters:
    
    number - as bits
    
    Returns:
    
    number as a float
  - doubleAsLongBits
```
public static long doubleAsLongBits(double number)
```
    Cast bits.
    
    Parameters:
    
    number - as double
    
    Returns:
    
    number as bits
  - longBitsAsDouble
```
public static double longBitsAsDouble(long number)
```
    Cast bits.
    
    Parameters:
    
    number - as bits
    
    Returns:
    
    number as double
  - addressAsByteArray
```
public static byte[] addressAsByteArray(Address byte_array)
```
    Recast. Note: for use by GC to avoid checkcast during GC
    
    Parameters:
    
    byte_array - an address
    
    Returns:
    
    byte array (byte[]) object reference
  - objectAsShortArray
```
public static short[] objectAsShortArray(Object object)
```
    Cast object. Note: for use in dynamic type checking (avoid dynamic type checking in impl. of dynamic type checking)
    
    Parameters:
    
    object - an object that must be a short array
    
    Returns:
    
    short array (short[]) object reference
  - objectAsIntArray
```
public static int[] objectAsIntArray(Object object)
```
    Cast object. Note: for use in dynamic type checking (avoid dynamic type checking in impl. of dynamic type checking)
    
    Parameters:
    
    object - an object that must be an int array
    
    Returns:
    
    int array (int[]) object reference
  - getObjectType
```
public static RVMType getObjectType(Object object)
```
    Get an object's type.
    
    Parameters:
    
    object - object reference
    
    Returns:
    
    object type
  - getArrayLength
```
public static int getArrayLength(Object object)
```
    Get an array's length.
    
    Parameters:
    
    object - object reference
    
    Returns:
    
    array length (number of elements)
  - saveThreadState
```
public static void saveThreadState(AbstractRegisters registers)
```
    Saves current thread state. Stores the values in the hardware registers into a Registers object.
    We used to use this to implement thread switching, but we have a threadSwitch magic now that does both of these in a single step as that is less error-prone. saveThreadState is now only used in the implementation of athrow (RuntimeEntrypoints.athrow).
    The following registers are saved:
    - nonvolatile fpr registers
    - nonvolatile gpr registers
    - FRAME_POINTER register
    - THREAD_ID "register"
    Parameters:
    
    registers - place to save register values
  - threadSwitch
```
public static void threadSwitch(RVMThread currentThread,
                                AbstractRegisters restoreRegs)
```
    Switch threads. The following registers are saved/restored
    - nonvolatile fpr registers
    - nonvolatile gpr registers
    - FRAME_POINTER register
    - THREAD_ID "register"
    *
    Parameters:
    
    currentThread - thread that is currently running
    
    restoreRegs - registers from which we should restore the saved hardware state of another thread.
  - restoreHardwareExceptionState
```
public static void restoreHardwareExceptionState(AbstractRegisters registers)
```
    Resume execution with specified thread exception state.
    Restores virtually all registers (details vary by architecture). But, the following are _NOT_ restored
    - JTOC_POINTER
    - THREAD_REGISTER
    does not return (execution resumes at new IP)
    Parameters:
    
    registers - register values to be used
  - returnToNewStack
```
public static void returnToNewStack(Address fp)
```
    Return to caller of current method, resuming execution on a new stack that's a copy of the original.
    
    Parameters:
    
    fp - value to place into FRAME_POINTER register
  - dynamicBridgeTo
```
public static void dynamicBridgeTo(CodeArray instructions)
```
    Transfer execution to target of a dynamic bridge method.
    The following registers are restored: non-volatiles, volatiles
    Note: this method must only be called from a DynamicBridge method because it never returns (target method returns to caller of dynamic bridge method)
    
    Parameters:
    
    instructions - target method
  - invokeClassInitializer
```
public static void invokeClassInitializer(CodeArray clinit)
                                   throws Exception
```
    Call <clinit> method with no argument list
    
    Parameters:
    
    clinit - the code of the class initializer
    
    Throws:
    
    Exception - all expections from invocation of the class initializer are passed along
  - invokeMethodReturningVoid
```
public static void invokeMethodReturningVoid(CodeArray code,
                                             WordArray gprs,
                                             double[] fprs,
                                             byte[] fprmeta,
                                             WordArray spills)
```
    Parameters:
    
    code - the method's code
    
    gprs - parameters passed in the general purpose registers
    
    fprs - parameters passed in the floating point registers
    
    fprmeta - meta-data (e.g. flags) about the floating point registers
    
    spills - parameters passed on the stack
  - invokeMethodReturningInt
```
public static int invokeMethodReturningInt(CodeArray code,
                                           WordArray gprs,
                                           double[] fprs,
                                           byte[] fprmeta,
                                           WordArray spills)
```
    Parameters:
    
    code - the method's code
    
    gprs - parameters passed in the general purpose registers
    
    fprs - parameters passed in the floating point registers
    
    fprmeta - meta-data (e.g. flags) about the floating point registers
    
    spills - parameters passed on the stack
    
    Returns:
    
    the return value of the called method
  - invokeMethodReturningLong
```
public static long invokeMethodReturningLong(CodeArray code,
                                             WordArray gprs,
                                             double[] fprs,
                                             byte[] fprmeta,
                                             WordArray spills)
```
    Parameters:
    
    code - the method's code
    
    gprs - parameters passed in the general purpose registers
    
    fprs - parameters passed in the floating point registers
    
    fprmeta - meta-data (e.g. flags) about the floating point registers
    
    spills - parameters passed on the stack
    
    Returns:
    
    the return value of the called method
  - invokeMethodReturningFloat
```
public static float invokeMethodReturningFloat(CodeArray code,
                                               WordArray gprs,
                                               double[] fprs,
                                               byte[] fprmeta,
                                               WordArray spills)
```
    Parameters:
    
    code - the method's code
    
    gprs - parameters passed in the general purpose registers
    
    fprs - parameters passed in the floating point registers
    
    fprmeta - meta-data (e.g. flags) about the floating point registers
    
    spills - parameters passed on the stack
    
    Returns:
    
    the return value of the called method
  - invokeMethodReturningDouble
```
public static double invokeMethodReturningDouble(CodeArray code,
                                                 WordArray gprs,
                                                 double[] fprs,
                                                 byte[] fprmeta,
                                                 WordArray spills)
```
    Parameters:
    
    code - the method's code
    
    gprs - parameters passed in the general purpose registers
    
    fprs - parameters passed in the floating point registers
    
    fprmeta - meta-data (e.g. flags) about the floating point registers
    
    spills - parameters passed on the stack
    
    Returns:
    
    the return value of the called method
  - invokeMethodReturningObject
```
public static Object invokeMethodReturningObject(CodeArray code,
                                                 WordArray gprs,
                                                 double[] fprs,
                                                 byte[] fprmeta,
                                                 WordArray spills)
```
    Parameters:
    
    code - the method's code
    
    gprs - parameters passed in the general purpose registers
    
    fprs - parameters passed in the floating point registers
    
    fprmeta - meta-data (e.g. flags) about the floating point registers
    
    spills - parameters passed on the stack
    
    Returns:
    
    the return value of the called method
  - fence
```
public static void fence()
```
    Emits a strong memory fence, used to enforce StoreLoad in the JMM. A StoreLoad barrier ensures that the data that was stored by the instruction before the barrier is visible to all load instructions after the barrier.
    Note: A StoreLoad barrier includes all other barriers on all platforms that we currently support (IA32 and PPC).
  - combinedLoadBarrier
```
public static void combinedLoadBarrier()
```
    Emits an instruction that provides both a LoadLoad and a LoadStore barrier. A LoadLoad barrier ensures that the data accessed by all load instructions before the barrier is loaded before any data from load instructions after the barrier. A LoadStore barrier ensures that the data accessed by all load instructions before the barrier is loaded before any data store instructions after the barrier are completed.
    We don't provide separate methods for LoadStore and LoadLoad barriers because the appropriate instructions for IA32 and PPC provide both barriers.
  - storeStoreBarrier
```
public static void storeStoreBarrier()
```
    Emits a StoreStore barrier. A StoreStore barrier ensures that the data that was stored by the instruction before the barrier is visible to all subsequent store instructions.
  - sync
```
public static void sync()
```
    Wait for preceeding cache flush/invalidate instructions to complete on all processors.
  - isync
```
public static void isync()
```
    Wait for all preceeding instructions to complete and discard any prefetched instructions on this processor.
  - pause
```
public static void pause()
```
    On IA32, emit a PAUSE instruction, to optimize spin-wait loops.
  - sqrt
```
public static float sqrt(float value)
```
    A hardware SQRT instruction.
    Note: this method may only be if the current configuration supports hardware floating point, i.e. if Configuration.BuildForHwFsqrt is true.
    
    Parameters:
    
    value - the value whose square root will be computed
    
    Returns:
    
    the SQRT of the given value
  - sqrt
```
public static double sqrt(double value)
```
    A hardware SQRT instruction.
    Note: this method may only be if the current configuration supports hardware floating point, i.e. if Configuration.BuildForHwFsqrt is true.
    
    Parameters:
    
    value - the value whose square root will be computed
    
    Returns:
    
    the SQRT of the given value
  - getInlineDepth
```
public static int getInlineDepth()
```
    How deeply inlined is this method (0 means no inlining).
    
    Returns:
    
    depth of inlining
  - isConstantParameter
```
public static boolean isConstantParameter(int index)
```
    Is the specified parameter constant (due to either inlining or specialization). Count starts at zero and includes the 'this' parameter for instance methods.
    
    Parameters:
    
    index - the index for the parameter as described above
    
    Returns:
    
    whether the specified parameter is constant

Class Magic

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

objectAddressRemapper

Constructor Detail

Magic

Method Detail

getFramePointer

getTocPointer

getJTOC

getThreadRegister

setThreadRegister

getESIAsThread

setESIAsThread

getTimeBase

getCallerFramePointer

setCallerFramePointer

getCompiledMethodID

setCompiledMethodID

getNextInstructionAddress

getReturnAddressLocation

getReturnAddressUnchecked

getReturnAddress

getReturnAddress

setReturnAddress

getUnsignedByteAtOffset

getByteAtOffset

getCharAtOffset

getShortAtOffset

getIntAtOffset

getLongAtOffset

getFloatAtOffset

getDoubleAtOffset

getObjectAtOffset

getObjectAtOffset

getWordAtOffset

getWordAtOffset

getAddressAtOffset

getAddressAtOffset

getExtentAtOffset

getExtentAtOffset

getOffsetAtOffset

getOffsetAtOffset

getTIBAtOffset

setBooleanAtOffset

setBooleanAtOffset

setByteAtOffset

setByteAtOffset

setCharAtOffset

setCharAtOffset

setShortAtOffset

setShortAtOffset

setIntAtOffset

setIntAtOffset

setLongAtOffset

setLongAtOffset

setFloatAtOffset

setFloatAtOffset

setDoubleAtOffset

setDoubleAtOffset

setWordAtOffset

setWordAtOffset

setAddressAtOffset

setAddressAtOffset

setExtentAtOffset

setExtentAtOffset

setOffsetAtOffset

setOffsetAtOffset

setObjectAtOffset

setObjectAtOffset

prepareInt

prepareObject

prepareAddress

prepareWord

prepareLong

attemptInt

attemptObject