com.oracle.svm.core.graal.stackvalue

Class StackValueNode

java.lang.Object

org.graalvm.compiler.graph.Node

org.graalvm.compiler.nodes.ValueNode

org.graalvm.compiler.nodes.FixedNode

org.graalvm.compiler.nodes.FixedWithNextNode

org.graalvm.compiler.nodes.AbstractStateSplit

com.oracle.svm.core.graal.stackvalue.StackValueNode

All Implemented Interfaces:

Cloneable, Formattable, org.graalvm.compiler.graph.IterableNodeType, org.graalvm.compiler.nodes.FixedNodeInterface, org.graalvm.compiler.nodes.FixedWithNextNodeInterface, org.graalvm.compiler.nodes.spi.LIRLowerable, org.graalvm.compiler.nodes.spi.NodeWithState, org.graalvm.compiler.nodes.StateSplit, org.graalvm.compiler.nodes.ValueNodeInterface

public final class StackValueNode
extends org.graalvm.compiler.nodes.AbstractStateSplit
implements org.graalvm.compiler.nodes.spi.LIRLowerable, org.graalvm.compiler.graph.IterableNodeType

This node is used to reserve memory on the stack. We need to make sure that the stack block is reserved only once, even when compiler optimizations such as loop unrolling duplicate the actual StackValueNode. While the node itself is cloned, the StackValueNode.slotIdentity is not cloned (it is a shallow object copy).

We don't track the lifetime of StackValueNodes. So, stack slots are not reused very efficiently at the moment. However, we at least ensure that stack slots are reused if a method is inlined multiple times into the same compilation unit. In this context, we must be careful though as recursively inlined methods must not share their stack slots. So, we compute the inlined recursion depth in the StackValueRecursionDepthPhase.

The actual assignment of the StackValueNode.stackSlotHolder is done by the StackValueSlotAssignmentPhase in a way that all nodes with the same identity and recursion depth share a stack slot.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static class	StackValueNode.StackSlotHolder
static class	StackValueNode.StackSlotIdentity

Nested classes/interfaces inherited from class org.graalvm.compiler.graph.Node

org.graalvm.compiler.graph.Node.ConstantNodeParameter, org.graalvm.compiler.graph.Node.EdgeVisitor, org.graalvm.compiler.graph.Node.IndirectCanonicalization, org.graalvm.compiler.graph.Node.InjectedNodeParameter, org.graalvm.compiler.graph.Node.Input, org.graalvm.compiler.graph.Node.NodeInsertionStackTrace, org.graalvm.compiler.graph.Node.NodeIntrinsic, org.graalvm.compiler.graph.Node.NodeIntrinsicFactory, org.graalvm.compiler.graph.Node.OptionalInput, org.graalvm.compiler.graph.Node.Successor, org.graalvm.compiler.graph.Node.ValueNumberable

Field Summary

Fields

Modifier and Type	Field and Description
protected int	alignmentInBytes
protected int	sizeInBytes
protected StackValueNode.StackSlotIdentity	slotIdentity
protected StackValueNode.StackSlotHolder	stackSlotHolder
static org.graalvm.compiler.graph.NodeClass<StackValueNode>	TYPE

Fields inherited from class org.graalvm.compiler.nodes.AbstractStateSplit

stateAfter

Fields inherited from class org.graalvm.compiler.nodes.FixedWithNextNode

next

Fields inherited from class org.graalvm.compiler.nodes.ValueNode

stamp

Fields inherited from class org.graalvm.compiler.graph.Node

NODE_LIST, NOT_ITERABLE, TRACK_CREATION_POSITION, WithAllEdges, WithNoEdges, WithOnlyInputEdges, WithOnlySucessorEdges

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	StackValueNode(int sizeInBytes, int alignmentInBytes, StackValueNode.StackSlotIdentity slotIdentity)

Method Summary

Modifier and Type	Method and Description
static org.graalvm.compiler.nodes.ValueNode	create(long numElements, long elementSize, org.graalvm.compiler.nodes.graphbuilderconf.GraphBuilderContext b) Factory method used for intrinsifying StackValue API methods.
void	generate(org.graalvm.compiler.nodes.spi.NodeLIRBuilderTool gen)
static org.graalvm.word.WordBase	stackValue(int sizeInBytes, int alignmentInBytes, StackValueNode.StackSlotIdentity slotIdentifier)

Methods inherited from class org.graalvm.compiler.nodes.AbstractStateSplit

hasSideEffect, setStateAfter, stateAfter, verify

Methods inherited from class org.graalvm.compiler.nodes.FixedWithNextNode

asFixedWithNextNode, next, setNext

Methods inherited from class org.graalvm.compiler.nodes.FixedNode

asFixedNode

Methods inherited from class org.graalvm.compiler.nodes.ValueNode

asConstant, asJavaConstant, asNode, asSerializableConstant, checkReplaceAtUsagesInvariants, getStackKind, graph, hasUsagesOtherThan, inferStamp, isAllowedUsageType, isConstant, isConstantPredicate, isDefaultConstant, isIllegalConstant, isJavaConstant, isNullConstant, isSerializableConstant, recursivelyDataFlowEqualsUpTo, setStamp, stamp, updateStamp, updateUsagesInterface

Methods inherited from class org.graalvm.compiler.graph.Node

afterClone, applyInputs, applySuccessors, assertFalse, assertTrue, cfgPredecessors, cfgSuccessors, clearInputs, clearNodeSourcePosition, clearSuccessors, copyWithInputs, copyWithInputs, dataFlowEquals, estimatedNodeCycles, estimatedNodeSize, fail, formatTo, getCreationPosition, getDebug, getDebugProperties, getDebugProperties, getInsertionPosition, getNodeClass, getNodeSourcePosition, getOptions, getUsageCount, hasExactlyOneUsage, hashCode, hasMoreThanOneUsage, hasNoUsages, hasOnlyUsagesOfType, hasUsages, hasUsagesOfType, inputPositions, inputs, isAlive, isDeleted, isUnregistered, markDeleted, maybeNotifyZeroUsages, modCount, predecessor, pushInputs, removeUsage, replaceAllInputs, replaceAndDelete, replaceAtAllUsages, replaceAtMatchingUsages, replaceAtPredecessor, replaceAtUsages, replaceAtUsages, replaceAtUsages, replaceAtUsages, replaceAtUsagesAndDelete, replaceAtUsagesAndDelete, replaceFirstInput, replaceFirstSuccessor, safeDelete, setCreationPosition, setInsertionPosition, setNodeSourcePosition, singleUsage, successorPositions, successors, toString, toString, updateNodeSourcePosition, updatePredecessor, updateUsages, usages, valueEquals, verifyEdges, verifyInputs, verifySourcePosition, withNodeSourcePosition

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.graalvm.compiler.nodes.spi.NodeWithState

states

Methods inherited from interface org.graalvm.compiler.nodes.FixedNodeInterface

asFixedNode

Methods inherited from interface org.graalvm.compiler.nodes.ValueNodeInterface

asNode

Field Detail

TYPE

public static final org.graalvm.compiler.graph.NodeClass<StackValueNode> TYPE

sizeInBytes

protected final int sizeInBytes

alignmentInBytes

protected final int alignmentInBytes

slotIdentity

protected final StackValueNode.StackSlotIdentity slotIdentity

stackSlotHolder

protected StackValueNode.StackSlotHolder stackSlotHolder

Constructor Detail

StackValueNode

protected StackValueNode(int sizeInBytes,
                         int alignmentInBytes,
                         StackValueNode.StackSlotIdentity slotIdentity)

Method Detail

create

public static org.graalvm.compiler.nodes.ValueNode create(long numElements,
                                                          long elementSize,
                                                          org.graalvm.compiler.nodes.graphbuilderconf.GraphBuilderContext b)

Factory method used for intrinsifying StackValue API methods. This method therefore must follow the API specification.

generate

public void generate(org.graalvm.compiler.nodes.spi.NodeLIRBuilderTool gen)

Specified by:

generate in interface org.graalvm.compiler.nodes.spi.LIRLowerable

stackValue

public static org.graalvm.word.WordBase stackValue(int sizeInBytes,
                                                   int alignmentInBytes,
                                                   StackValueNode.StackSlotIdentity slotIdentifier)