jdk.internal.jvmci.code

Interface RegisterConfig

All Known Implementing Classes:

AMD64HotSpotRegisterConfig, SPARCHotSpotRegisterConfig

public interface RegisterConfig

A register configuration binds roles and attributes to physical registers.

Method Summary

Modifier and Type	Method and Description
boolean	areAllAllocatableRegistersCallerSaved() Determines if all allocatable registers are caller saved.
Register[]	filterAllocatableRegisters(PlatformKind kind, Register[] registers) Filters a set of registers and returns only those that can be used by the register allocator for a value of a particular kind.
Register[]	getAllocatableRegisters() Gets the set of all registers that might be used by the register allocator.
RegisterAttributes[]	getAttributesMap() Gets a map from register numbers to register attributes for this register configuration.
CalleeSaveLayout	getCalleeSaveLayout() Gets the layout of the callee save area of this register configuration.
Register[]	getCallerSaveRegisters() Gets the registers whose values must be preserved by a method across any call it makes.
CallingConvention	getCallingConvention(CallingConvention.Type type, JavaType returnType, JavaType[] parameterTypes, TargetDescription target, boolean stackOnly) Gets the calling convention describing how arguments are passed.
Register[]	getCallingConventionRegisters(CallingConvention.Type type, Kind kind) Gets the ordered set of registers that are can be used to pass parameters according to a given calling convention.
Register	getFrameRegister() Gets the register to which Register.Frame and Register.CallerFrame are bound.
default int	getMaximumFrameSize() Gets the maximum allowed size of the frame.
Register	getRegisterForRole(int id) Gets the register corresponding to a runtime-defined role.
Register	getReturnRegister(Kind kind) Gets the register to be used for returning a value of a given kind.

Method Detail

getReturnRegister

Register getReturnRegister(Kind kind)

Gets the register to be used for returning a value of a given kind.

getMaximumFrameSize

default int getMaximumFrameSize()

Gets the maximum allowed size of the frame.

getFrameRegister

Register getFrameRegister()

Gets the register to which Register.Frame and Register.CallerFrame are bound.

getCallingConvention

CallingConvention getCallingConvention(CallingConvention.Type type,
                                       JavaType returnType,
                                       JavaType[] parameterTypes,
                                       TargetDescription target,
                                       boolean stackOnly)

Gets the calling convention describing how arguments are passed.

Parameters:

type - the type of calling convention being requested

returnType - the return type (can be null for methods returning void)

parameterTypes - the types of the arguments of the call

target - the target platform

stackOnly - ignore registers

getCallingConventionRegisters

Register[] getCallingConventionRegisters(CallingConvention.Type type,
                                         Kind kind)

Gets the ordered set of registers that are can be used to pass parameters according to a given calling convention.

Parameters:

type - the type of calling convention

kind - specifies what kind of registers is being requested

Returns:

the ordered set of registers that may be used to pass parameters in a call conforming to type

getAllocatableRegisters

Register[] getAllocatableRegisters()

Gets the set of all registers that might be used by the register allocator. To get the set of registers the register allocator is allowed to use see RegisterAllocationConfig#getAllocatableRegisters()

filterAllocatableRegisters

Register[] filterAllocatableRegisters(PlatformKind kind,
                                      Register[] registers)

Filters a set of registers and returns only those that can be used by the register allocator for a value of a particular kind.

getCallerSaveRegisters

Register[] getCallerSaveRegisters()

Gets the registers whose values must be preserved by a method across any call it makes.

getCalleeSaveLayout

CalleeSaveLayout getCalleeSaveLayout()

Gets the layout of the callee save area of this register configuration.

Returns:

null if there is no callee save area

getAttributesMap

RegisterAttributes[] getAttributesMap()

Gets a map from register numbers to register attributes for this register configuration.

Returns:

an array where an element at index i holds the attributes of the register whose number is i

getRegisterForRole

Register getRegisterForRole(int id)

Gets the register corresponding to a runtime-defined role.

Parameters:

id - the identifier of a runtime-defined register role

Returns:

the register playing the role specified by id

areAllAllocatableRegistersCallerSaved

boolean areAllAllocatableRegistersCallerSaved()

Determines if all allocatable registers are caller saved.