jdk.internal.jvmci.code

Class Architecture

java.lang.Object

jdk.internal.jvmci.code.Architecture

Direct Known Subclasses:

AMD64, SPARC

public abstract class Architecture
extends Object

Represents a CPU architecture, including information such as its endianness, CPU registers, word width, etc.

Field Summary

Fields

Modifier and Type	Field and Description
private ByteOrder	byteOrder The byte ordering can be either little or big endian.
private int	implicitMemoryBarriers Mask of the barrier constants denoting the barriers that are not required to be explicitly inserted under this architecture.
private int	machineCodeCallDisplacementOffset Offset in bytes from the beginning of a call instruction to the displacement.
private String	name The name of this architecture (e.g.
private int	registerReferenceMapSize The number of entries required in a ReferenceMap covering all the registers that may store references.
private Register[]	registers Array of all available registers on this architecture.
private int	returnAddressSize The size of the return address pushed to the stack by a call instruction.
private boolean	unalignedMemoryAccess Whether the architecture supports unaligned memory accesses.
private int	wordSize Represents the natural size of words (typically registers and pointers) of this architecture, in bytes.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	Architecture(String name, int wordSize, ByteOrder byteOrder, boolean unalignedMemoryAccess, Register[] registers, int implicitMemoryBarriers, int nativeCallDisplacementOffset, int registerReferenceMapSize, int returnAddressSize)

Method Summary

Modifier and Type	Method and Description
abstract boolean	canStoreValue(Register.RegisterCategory category, PlatformKind kind) Determine whether a kind can be stored in a register of a given category.
boolean	equals(Object obj)
ByteOrder	getByteOrder()
abstract PlatformKind	getLargestStorableKind(Register.RegisterCategory category) Return the largest kind that can be stored in a register of a given category.
int	getMachineCodeCallDisplacementOffset() Gets the offset in bytes from the beginning of a call instruction to the displacement.
String	getName() Gets the name of this architecture.
int	getRegisterReferenceMapSize()
Register[]	getRegisters() Gets an array of all available registers on this architecture.
int	getReturnAddressSize() Gets the size of the return address pushed to the stack by a call instruction.
int	getSizeInBytes(PlatformKind kind) Gets the size in bytes of the specified kind for this target.
int	getWordSize() Gets the natural size of words (typically registers and pointers) of this architecture, in bytes.
int	hashCode()
int	requiredBarriers(int barriers) Determines the barriers in a given barrier mask that are explicitly required on this architecture.
boolean	supportsUnalignedMemoryAccess()
String	toString() Converts this architecture to a string.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

registerReferenceMapSize

private final int registerReferenceMapSize

The number of entries required in a ReferenceMap covering all the registers that may store references. The index of a register in the reference map is given by Register.getReferenceMapIndex().

wordSize

private final int wordSize

Represents the natural size of words (typically registers and pointers) of this architecture, in bytes.

name

private final String name

The name of this architecture (e.g. "AMD64", "SPARCv9").

registers

private final Register[] registers

Array of all available registers on this architecture. The index of each register in this array is equal to its number.

byteOrder

private final ByteOrder byteOrder

The byte ordering can be either little or big endian.

unalignedMemoryAccess

private final boolean unalignedMemoryAccess

Whether the architecture supports unaligned memory accesses.

implicitMemoryBarriers

private final int implicitMemoryBarriers

Mask of the barrier constants denoting the barriers that are not required to be explicitly inserted under this architecture.

machineCodeCallDisplacementOffset

private final int machineCodeCallDisplacementOffset

Offset in bytes from the beginning of a call instruction to the displacement.

returnAddressSize

private final int returnAddressSize

The size of the return address pushed to the stack by a call instruction. A value of 0 denotes that call linkage uses registers instead (e.g. SPARC).

Constructor Detail

Architecture

protected Architecture(String name,
                       int wordSize,
                       ByteOrder byteOrder,
                       boolean unalignedMemoryAccess,
                       Register[] registers,
                       int implicitMemoryBarriers,
                       int nativeCallDisplacementOffset,
                       int registerReferenceMapSize,
                       int returnAddressSize)

Method Detail

toString

public final String toString()

Converts this architecture to a string.

Overrides:

toString in class Object

Returns:

the string representation of this architecture

getRegisterReferenceMapSize

public int getRegisterReferenceMapSize()

getWordSize

public int getWordSize()

Gets the natural size of words (typically registers and pointers) of this architecture, in bytes.

getName

public String getName()

Gets the name of this architecture.

getRegisters

public Register[] getRegisters()

Gets an array of all available registers on this architecture. The index of each register in this array is equal to its number.

getByteOrder

public ByteOrder getByteOrder()

supportsUnalignedMemoryAccess

public boolean supportsUnalignedMemoryAccess()

Returns:

true if the architecture supports unaligned memory accesses.

getReturnAddressSize

public int getReturnAddressSize()

Gets the size of the return address pushed to the stack by a call instruction. A value of 0 denotes that call linkage uses registers instead.

getMachineCodeCallDisplacementOffset

public int getMachineCodeCallDisplacementOffset()

Gets the offset in bytes from the beginning of a call instruction to the displacement.

requiredBarriers

public final int requiredBarriers(int barriers)

Determines the barriers in a given barrier mask that are explicitly required on this architecture.

Parameters:

barriers - a mask of the barrier constants

Returns:

the value of barriers minus the barriers unnecessary on this architecture

getSizeInBytes

public int getSizeInBytes(PlatformKind kind)

Gets the size in bytes of the specified kind for this target.

Parameters:

kind - the kind for which to get the size

Returns:

the size in bytes of kind

canStoreValue

public abstract boolean canStoreValue(Register.RegisterCategory category,
                                      PlatformKind kind)

Determine whether a kind can be stored in a register of a given category.

Parameters:

category - the category of the register

kind - the kind that should be stored in the register

getLargestStorableKind

public abstract PlatformKind getLargestStorableKind(Register.RegisterCategory category)

Return the largest kind that can be stored in a register of a given category.

Parameters:

category - the category of the register

Returns:

the largest kind that can be stored in a register category

equals

public final boolean equals(Object obj)

Overrides:

equals in class Object

hashCode

public final int hashCode()

Overrides:

hashCode in class Object