com.oracle.graal.hotspot.stubs

Class Stub

java.lang.Object

com.oracle.graal.hotspot.stubs.Stub

Direct Known Subclasses:

ForeignCallStub, SnippetStub

public abstract class Stub
extends Object

Base class for implementing some low level code providing the out-of-line slow path for a snippet and/or a callee saved call to a HotSpot C/C++ runtime function or even a another compiled Java method.

Field Summary

Fields

Modifier and Type	Field and Description
protected InstalledCode	code The code installed for the stub.
protected CompilationResult	compResult Compilation result from which code was created.
private Set<Register>	destroyedRegisters The registers destroyed by this stub.
protected HotSpotForeignCallLinkage	linkage The linkage information for a call to this stub from compiled code.
protected HotSpotProviders	providers
private static List<Stub>	stubs

Constructor Summary

Constructors

Constructor and Description
Stub(HotSpotProviders providers, HotSpotForeignCallLinkage linkage) Creates a new stub.

Method Summary

Modifier and Type	Method and Description
private LIRSuites	createLIRSuites()
protected abstract Object	debugScopeContext() Gets a context object for the debug scope created when producing the code for this stub.
InstalledCode	getCode(Backend backend) Gets the code for this stub, compiling it first if necessary.
CompilationResult	getCompilationResult(Backend backend) Gets the compilation result for this stub, compiling it first if necessary, and installing it in code.
Set<Register>	getDestroyedRegisters() Gets the registers defined by this stub.
protected abstract StructuredGraph	getGraph() Gets the graph that from which the code for this stub will be compiled.
protected abstract ResolvedJavaMethod	getInstalledCodeOwner() Gets the method the stub's code will be associated with once installed.
HotSpotForeignCallLinkage	getLinkage() Gets the linkage for a call to this stub from compiled code.
RegisterConfig	getRegisterConfig()
static Collection<Stub>	getStubs() Gets an immutable view of all stubs that have been created.
void	initDestroyedRegisters(Set<Register> registers)
boolean	preservesRegisters() Determines if this stub preserves all registers apart from those it destroys.
String	toString()

Methods inherited from class java.lang.Object

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

Field Detail

stubs

private static final List<Stub> stubs

linkage

protected final HotSpotForeignCallLinkage linkage

The linkage information for a call to this stub from compiled code.

code

protected InstalledCode code

The code installed for the stub.

compResult

protected CompilationResult compResult

Compilation result from which code was created.

destroyedRegisters

private Set<Register> destroyedRegisters

The registers destroyed by this stub.

providers

protected final HotSpotProviders providers

Constructor Detail

Stub

public Stub(HotSpotProviders providers,
            HotSpotForeignCallLinkage linkage)

Creates a new stub.

Parameters:

linkage - linkage details for a call to the stub

Method Detail

initDestroyedRegisters

public void initDestroyedRegisters(Set<Register> registers)

getDestroyedRegisters

public Set<Register> getDestroyedRegisters()

Gets the registers defined by this stub. These are the temporaries of this stub and must thus be caller saved by a callers of this stub.

preservesRegisters

public boolean preservesRegisters()

Determines if this stub preserves all registers apart from those it destroys.

getStubs

public static Collection<Stub> getStubs()

Gets an immutable view of all stubs that have been created.

getLinkage

public HotSpotForeignCallLinkage getLinkage()

Gets the linkage for a call to this stub from compiled code.

getRegisterConfig

public RegisterConfig getRegisterConfig()

getGraph

protected abstract StructuredGraph getGraph()

Gets the graph that from which the code for this stub will be compiled.

toString

public String toString()

Overrides:

toString in class Object

getInstalledCodeOwner

protected abstract ResolvedJavaMethod getInstalledCodeOwner()

Gets the method the stub's code will be associated with once installed. This may be null.

debugScopeContext

protected abstract Object debugScopeContext()

Gets a context object for the debug scope created when producing the code for this stub.

getCode

public InstalledCode getCode(Backend backend)

Gets the code for this stub, compiling it first if necessary.

createLIRSuites

private LIRSuites createLIRSuites()

getCompilationResult

public CompilationResult getCompilationResult(Backend backend)

Gets the compilation result for this stub, compiling it first if necessary, and installing it in code.