org.graalvm.compiler.asm

Class Assembler

java.lang.Object

org.graalvm.compiler.asm.Assembler

Direct Known Subclasses:

AArch64Assembler, AMD64BaseAssembler, SPARCAssembler

public abstract class Assembler
extends Object

The platform-independent base class for the assembler.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Assembler.CodeAnnotation
static interface	Assembler.InstructionCounter Instruction counter class which gives the user of the assembler to count different kinds of instructions in the generated assembler code.
static class	Assembler.LabelHint

Field Summary

Fields

Modifier and Type	Field and Description
protected Consumer<Assembler.CodeAnnotation>	codePatchingAnnotationConsumer
jdk.vm.ci.code.TargetDescription	target

Constructor Summary

Constructors

Constructor and Description
Assembler(jdk.vm.ci.code.TargetDescription target)

Method Summary

Modifier and Type	Method and Description
abstract void	align(int modulus)
void	bind(Label l)
byte[]	close(boolean trimmedCopy) Closes this assembler.
byte[]	copy(int start, int end)
protected String	createLabelName(Label l, int id) Creates a name for a label.
void	emitByte(int x)
void	emitByte(int b, int pos)
void	emitInt(int x)
void	emitInt(int b, int pos)
void	emitLong(long x)
void	emitLong(long b, int pos)
void	emitShort(int x)
void	emitShort(int b, int pos)
void	emitString(String x) Some GPU architectures have a text based encoding.
void	emitString(String s, int pos)
void	emitString0(String x)
abstract void	ensureUniquePC() Emits a NOP instruction to advance the current PC.
int	getByte(int pos)
Assembler.InstructionCounter	getInstructionCounter()
int	getInt(int pos)
abstract AbstractAddress	getPlaceholder(int instructionStartPosition) Returns a target specific placeholder address that can be used for code patching.
int	getShort(int pos)
abstract void	jmp(Label l)
abstract AbstractAddress	makeAddress(jdk.vm.ci.code.Register base, int displacement) This is used by the CompilationResultBuilder to convert a StackSlot to an AbstractAddress.
String	nameOf(Label l) Gets a name for a label, creating it if it does not yet exist.
protected abstract void	patchJumpTarget(int branch, int jumpTarget)
int	position() Returns the current position of the underlying code buffer.
Assembler.LabelHint	requestLabelHint(Label label)
void	reset()
void	setCodePatchingAnnotationConsumer(Consumer<Assembler.CodeAnnotation> codeAnnotationConsumer)

Methods inherited from class java.lang.Object

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

Field Detail

target

public final jdk.vm.ci.code.TargetDescription target

codePatchingAnnotationConsumer

protected Consumer<Assembler.CodeAnnotation> codePatchingAnnotationConsumer

Constructor Detail

Assembler

public Assembler(jdk.vm.ci.code.TargetDescription target)

Method Detail

setCodePatchingAnnotationConsumer

public void setCodePatchingAnnotationConsumer(Consumer<Assembler.CodeAnnotation> codeAnnotationConsumer)

position

public int position()

Returns the current position of the underlying code buffer.

Returns:

current position in code buffer

emitByte

public final void emitByte(int x)

emitShort

public final void emitShort(int x)

emitInt

public final void emitInt(int x)

emitLong

public final void emitLong(long x)

emitByte

public final void emitByte(int b,
                           int pos)

emitShort

public final void emitShort(int b,
                            int pos)

emitInt

public final void emitInt(int b,
                          int pos)

emitLong

public final void emitLong(long b,
                           int pos)

getByte

public final int getByte(int pos)

getShort

public final int getShort(int pos)

getInt

public final int getInt(int pos)

emitString

public final void emitString(String x)

Some GPU architectures have a text based encoding.

emitString0

public final void emitString0(String x)

emitString

public void emitString(String s,
                       int pos)

close

public byte[] close(boolean trimmedCopy)

Closes this assembler. No extra data can be written to this assembler after this call.

Parameters:

trimmedCopy - if true, then a copy of the underlying byte array up to (but not including) position() is returned

Returns:

the data in this buffer or a trimmed copy if trimmedCopy is true

copy

public byte[] copy(int start,
                   int end)

bind

public void bind(Label l)

align

public abstract void align(int modulus)

jmp

public abstract void jmp(Label l)

patchJumpTarget

protected abstract void patchJumpTarget(int branch,
                                        int jumpTarget)

createLabelName

protected String createLabelName(Label l,
                                 int id)

Creates a name for a label.

Parameters:

l - the label for which a name is being created

id - a label identifier that is unique with the scope of this assembler

Returns:

a label name in the form of "L123"

nameOf

public String nameOf(Label l)

Gets a name for a label, creating it if it does not yet exist. By default, the returned name is only unique with the scope of this assembler.

makeAddress

public abstract AbstractAddress makeAddress(jdk.vm.ci.code.Register base,
                                            int displacement)

This is used by the CompilationResultBuilder to convert a StackSlot to an AbstractAddress.

getPlaceholder

public abstract AbstractAddress getPlaceholder(int instructionStartPosition)

Returns a target specific placeholder address that can be used for code patching.

Parameters:

instructionStartPosition - The start of the instruction, i.e., the value that is used as the key for looking up placeholder patching information.

ensureUniquePC

public abstract void ensureUniquePC()

Emits a NOP instruction to advance the current PC.

reset

public void reset()

requestLabelHint

public Assembler.LabelHint requestLabelHint(Label label)

getInstructionCounter

public Assembler.InstructionCounter getInstructionCounter()