org.graalvm.compiler.core.target

Class Backend

java.lang.Object

org.graalvm.compiler.core.target.Backend

All Implemented Interfaces:

TargetProvider

Direct Known Subclasses:

HotSpotBackend

public abstract class Backend
extends Object
implements TargetProvider

Represents a compiler backend for Graal.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Backend.CodeInstallationTask Encapsulates custom tasks done before and after code installation.
static class	Backend.CodeInstallationTaskFactory Creates code installation tasks.

Field Summary

Fields

Modifier and Type	Field and Description
static ForeignCallSignature	ARITHMETIC_DREM
static ForeignCallSignature	ARITHMETIC_FREM

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	Backend(Providers providers)

Method Summary

Modifier and Type	Method and Description
void	addCodeInstallationTask(Backend.CodeInstallationTaskFactory factory)
InstalledCode	addInstalledCode(DebugContext debug, ResolvedJavaMethod method, CompilationRequest compilationRequest, CompilationResult compilationResult) Installs code based on a given compilation result.
protected abstract CompiledCode	createCompiledCode(ResolvedJavaMethod method, CompilationRequest compilationRequest, CompilationResult compilationResult, boolean isDefault, OptionValues options) Turns a Graal CompilationResult into a CompiledCode object that can be passed to the VM for code installation.
InstalledCode	createDefaultInstalledCode(DebugContext debug, ResolvedJavaMethod method, CompilationResult compilationResult) Installs code based on a given compilation result and sets it as the default code to be used when method is invoked.
InstalledCode	createInstalledCode(DebugContext debug, ResolvedJavaMethod method, CompilationRequest compilationRequest, CompilationResult compilationResult, InstalledCode predefinedInstalledCode, boolean isDefault)
InstalledCode	createInstalledCode(DebugContext debug, ResolvedJavaMethod method, CompilationRequest compilationRequest, CompilationResult compilationResult, InstalledCode predefinedInstalledCode, boolean isDefault, Object[] context) Installs code based on a given compilation result.
InstalledCode	createInstalledCode(DebugContext debug, ResolvedJavaMethod method, CompilationResult compilationResult, InstalledCode predefinedInstalledCode, boolean isDefault)
void	emitBackEnd(StructuredGraph graph, Object stub, ResolvedJavaMethod installedCodeOwner, CompilationResult compilationResult, CompilationResultBuilderFactory factory, RegisterConfig config, LIRSuites lirSuites)
CodeCacheProvider	getCodeCache()
CompilationIdentifier	getCompilationIdentifier(ResolvedJavaMethod resolvedJavaMethod) Gets the compilation id for a given ResolvedJavaMethod.
ConstantReflectionProvider	getConstantReflection()
ForeignCallsProvider	getForeignCalls()
MetaAccessProvider	getMetaAccess()
Providers	getProviders()
abstract SuitesProvider	getSuites()
TargetDescription	getTarget()
LIRKind	getValueKind(JavaKind javaKind)
<T extends AbstractBlockBase<T>> CodeEmissionOrder<T>	newBlockOrder(int originalBlockCount, T startBlock) Creates a new instance of a code emission ordering computation.
abstract RegisterAllocationConfig	newRegisterAllocationConfig(RegisterConfig registerConfig, String[] allocationRestrictedTo) Creates a new configuration for register allocation.

Methods inherited from class java.lang.Object

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

Field Detail

ARITHMETIC_FREM

public static final ForeignCallSignature ARITHMETIC_FREM

ARITHMETIC_DREM

public static final ForeignCallSignature ARITHMETIC_DREM

Constructor Detail

Backend

protected Backend(Providers providers)

Method Detail

addCodeInstallationTask

public void addCodeInstallationTask(Backend.CodeInstallationTaskFactory factory)

getProviders

public Providers getProviders()

getCodeCache

public CodeCacheProvider getCodeCache()

getMetaAccess

public MetaAccessProvider getMetaAccess()

getConstantReflection

public ConstantReflectionProvider getConstantReflection()

getForeignCalls

public ForeignCallsProvider getForeignCalls()

getSuites

public abstract SuitesProvider getSuites()

getTarget

public TargetDescription getTarget()

Specified by:

getTarget in interface TargetProvider

getValueKind

public LIRKind getValueKind(JavaKind javaKind)

newRegisterAllocationConfig

public abstract RegisterAllocationConfig newRegisterAllocationConfig(RegisterConfig registerConfig,
                                                                     String[] allocationRestrictedTo)

Creates a new configuration for register allocation.

Parameters:

allocationRestrictedTo - if not null, register allocation will be restricted to registers whose names appear in this array

newBlockOrder

public <T extends AbstractBlockBase<T>> CodeEmissionOrder<T> newBlockOrder(int originalBlockCount,
                                                                           T startBlock)

Creates a new instance of a code emission ordering computation.

createCompiledCode

protected abstract CompiledCode createCompiledCode(ResolvedJavaMethod method,
                                                   CompilationRequest compilationRequest,
                                                   CompilationResult compilationResult,
                                                   boolean isDefault,
                                                   OptionValues options)

Turns a Graal CompilationResult into a CompiledCode object that can be passed to the VM for code installation.

createInstalledCode

public InstalledCode createInstalledCode(DebugContext debug,
                                         ResolvedJavaMethod method,
                                         CompilationResult compilationResult,
                                         InstalledCode predefinedInstalledCode,
                                         boolean isDefault)

See Also:

Backend.createInstalledCode(DebugContext, ResolvedJavaMethod, CompilationRequest, CompilationResult, InstalledCode, boolean, Object[])

createInstalledCode

public InstalledCode createInstalledCode(DebugContext debug,
                                         ResolvedJavaMethod method,
                                         CompilationRequest compilationRequest,
                                         CompilationResult compilationResult,
                                         InstalledCode predefinedInstalledCode,
                                         boolean isDefault)

See Also:

Backend.createInstalledCode(DebugContext, ResolvedJavaMethod, CompilationRequest, CompilationResult, InstalledCode, boolean, Object[])

createInstalledCode

public InstalledCode createInstalledCode(DebugContext debug,
                                         ResolvedJavaMethod method,
                                         CompilationRequest compilationRequest,
                                         CompilationResult compilationResult,
                                         InstalledCode predefinedInstalledCode,
                                         boolean isDefault,
                                         Object[] context)

Installs code based on a given compilation result.

Parameters:

method - the method compiled to produce compiledCode or null if the input to compResult was not a ResolvedJavaMethod

compilationRequest - the compilation request or null

compilationResult - the code to be installed

predefinedInstalledCode - a pre-allocated InstalledCode object to use as a reference to the installed code. If null, a new InstalledCode object will be created.

isDefault - specifies if the installed code should be made the default implementation of compRequest.getMethod(). The default implementation for a method is the code executed for standard calls to the method. This argument is ignored if compRequest == null.

context - a custom debug context to use for the code installation

Returns:

a reference to the compiled and ready-to-run installed code

Throws:

jdk.vm.ci.code.BailoutException - if the code installation failed

IllegalArgumentException - if installedCode != null and this platform does not support a predefined InstalledCode object

addInstalledCode

public InstalledCode addInstalledCode(DebugContext debug,
                                      ResolvedJavaMethod method,
                                      CompilationRequest compilationRequest,
                                      CompilationResult compilationResult)

Installs code based on a given compilation result.

Parameters:

method - the method compiled to produce compiledCode or null if the input to compResult was not a ResolvedJavaMethod

compilationRequest - the request or null

compilationResult - the compiled code

Returns:

a reference to the compiled and ready-to-run installed code

Throws:

jdk.vm.ci.code.BailoutException - if the code installation failed

createDefaultInstalledCode

public InstalledCode createDefaultInstalledCode(DebugContext debug,
                                                ResolvedJavaMethod method,
                                                CompilationResult compilationResult)

Installs code based on a given compilation result and sets it as the default code to be used when method is invoked.

Parameters:

method - the method compiled to produce compiledCode or null if the input to compResult was not a ResolvedJavaMethod

compilationResult - the compiled code

Returns:

a reference to the compiled and ready-to-run installed code

Throws:

jdk.vm.ci.code.BailoutException - if the code installation failed

getCompilationIdentifier

public CompilationIdentifier getCompilationIdentifier(ResolvedJavaMethod resolvedJavaMethod)

Gets the compilation id for a given ResolvedJavaMethod. Returns CompilationIdentifier#INVALID_COMPILATION_ID in case there is no such id.

Parameters:

resolvedJavaMethod -

emitBackEnd

public void emitBackEnd(StructuredGraph graph,
                        Object stub,
                        ResolvedJavaMethod installedCodeOwner,
                        CompilationResult compilationResult,
                        CompilationResultBuilderFactory factory,
                        RegisterConfig config,
                        LIRSuites lirSuites)