scale.backend.trips2
Class ImmediateInstruction

java.lang.Object
  scale.backend.Instruction
      scale.backend.trips2.TripsInstruction
          scale.backend.trips2.ImmediateInstruction

All Implemented Interfaces:

java.lang.Cloneable

public class ImmediateInstruction
extends TripsInstruction

This class represents Trips non-branch instructions with an immediate operand.

$Id: ImmediateInstruction.java,v 1.38 2007-10-04 19:57:59 burrill Exp $

Copyright 2007 by the Scale Compiler Group,
Department of Computer Science
University of Massachusetts,
Amherst MA. 01003, USA
All Rights Reserved.

Field Summary

protected Displacement	disp used for stack displacements.
protected long	imm the immediate value.
protected int	ra the ra register.
protected int	rb the rb register.

Fields inherited from class scale.backend.trips2.TripsInstruction

definesPredicate, numPredicates, predicatedOnTrue, predicates

Constructor Summary

ImmediateInstruction(int opcode, int ra, int rb, Displacement disp)
Create a new Immediate Trips instruction in the I:1 format.

ImmediateInstruction(int opcode, int ra, int rb, long imm)
Create a new non-predicated Immediate Trips instruction in the I:1 format.

ImmediateInstruction(int opcode, int ra, int rb, long imm, int rp, boolean predicatedOnTrue)
Create a new Immediate Trips instruction in the I:1 format.

ImmediateInstruction(int opcode, int ra, long imm)
Create a new non-predicated Immediate Trips instruction in the I:1 format.

ImmediateInstruction(int opcode, int ra, long imm, int rp, boolean predicatedOnTrue)
Create a new Immediate Trips instruction in the I:0 format.

Method Summary

void	assembler(Assembler asm, Emit emit) Insert the assembler representation of the instruction into the output stream.
boolean	canBeDeleted(RegisterSet registers) Return true if the instruction can be deleted without changing program semantics.
static int	created() Return the number of instances of this class created.
boolean	defs(int register, RegisterSet registers) Return true if the instruction sets the register
int	ehash() Return a hash code that can be used to determine equivalence.
int	getCopyDest() Return the source register of a copy instruction.
int	getCopySrc() Return the source register of a copy instruction.
int	getDestRegister() Return the destination register.
Displacement	getDisp() Return the displacement field.
byte	getFormat() Return the instruction format.
long	getImm() Return the immediate field.
int	getOpcode() Return the instruction opcode.
int	getRa() Return the ra field.
int	getRb() Return the rb field.
int[]	getSrcRegisters() This routine returns the source registers for an instruction.
boolean	independent(Instruction inst, RegisterSet registers) Return true if this instruction is independent of the specified instruction.
int	instructionSize() Return the number of bytes required for the Trips instruction.
boolean	isCopy() Return true if the instruction copies a value from one register to another without modification.
void	nullify(RegisterSet rs) Mark the instruction so that it is not used.
void	remapDestRegister(int oldReg, int newReg) Map the registers defined in the instruction as destinations to the specified register.
void	remapRegisters(int[] map) Map the registers used in the instruction to the specified registers.
void	remapSrcRegister(int oldReg, int newReg) Map the registers used in the instruction as sources to the specified register.
protected void	setImm(long imm) Set the immediate field.
void	specifyRegisterUsage(RegisterAllocator rs, int index, int strength) Specify the registers used by this instruction.
java.lang.String	toString() Return a string representation of the instruction.
boolean	uses(int register, RegisterSet registers) Return true if the instruction uses the register.

Methods inherited from class scale.backend.trips2.TripsInstruction

definesPredicate, formatOpcode, formatOpcode, formatOpcode, formatRa, getBBID, getLoopNumber, getPredicate, getPredicates, isPredicated, isPredicatedOnTrue, numPredicates, removePredicates, setBBID, setDefinesPredicate, setLoopNumber, setPredicate, setPredicate, setPredicatedOnTrue, setPredicates, setPredicates

Methods inherited from class scale.backend.Instruction

clone, copy, getExecutionCycles, getFunctionalUnit, getNext, getTag, isBranch, isLabel, isLoad, isMandatory, isMarker, isPhi, isPrefetch, isSpillInstruction, isSpillLoadPoint, isSpillStorePoint, isStore, markSpillInstruction, mods, nullified, setMandatory, setNext, setsSpecialReg, setTag, specifyNotSpillLoadPoint, specifySpillStorePoint

Methods inherited from class java.lang.Object

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

Field Detail

ra

protected int ra

the ra register.

rb

protected int rb

the rb register.

imm

protected long imm

the immediate value.

disp

protected Displacement disp

used for stack displacements.

Constructor Detail

ImmediateInstruction

public ImmediateInstruction(int opcode,
                            int ra,
                            int rb,
                            long imm,
                            int rp,
                            boolean predicatedOnTrue)

Create a new Immediate Trips instruction in the I:1 format.

Parameters:

opcode - specifies the pseudo-operation

ra - specifies the destination register

rb - specifies the left argument register

imm - specifies the right immediate argument

rp - specifies the register to predicate on (-1 if unused)

predicatedOnTrue - speficies the condition to predicate on (ignored if rp is -1)

See Also:

Trips2Machine.minImmediate, Trips2Machine.maxImmediate

ImmediateInstruction

public ImmediateInstruction(int opcode,
                            int ra,
                            int rb,
                            Displacement disp)

Create a new Immediate Trips instruction in the I:1 format.

Parameters:

opcode - specifies the pseudo-operation

ra - specifies the destination register

rb - specifies the left argument register

disp - specifies the right immediate argument

See Also:

Trips2Machine.minImmediate, Trips2Machine.maxImmediate

ImmediateInstruction

public ImmediateInstruction(int opcode,
                            int ra,
                            int rb,
                            long imm)

Create a new non-predicated Immediate Trips instruction in the I:1 format.

Parameters:

opcode - specifies the pseudo-operation

ra - specifies the destination register

rb - specifies the left argument register

imm - specifies the right immediate argument

See Also:

Trips2Machine.minImmediate, Trips2Machine.maxImmediate

ImmediateInstruction

public ImmediateInstruction(int opcode,
                            int ra,
                            long imm,
                            int rp,
                            boolean predicatedOnTrue)

Create a new Immediate Trips instruction in the I:0 format.

Parameters:

opcode - specifies the pseudo-operation

ra - specifies the destination register

imm - specifies the immediate argument

rp - specifies the register to predicate on (-1 if unused)

predicatedOnTrue - speficies the condition to predicate on (ignored if rp is -1)

See Also:

Trips2Machine.minImmediate, Trips2Machine.maxImmediate

ImmediateInstruction

public ImmediateInstruction(int opcode,
                            int ra,
                            long imm)

Create a new non-predicated Immediate Trips instruction in the I:1 format.

Parameters:

opcode - specifies the pseudo-operation

ra - specifies the destination register

imm - specifies the right immediate argument

See Also:

Trips2Machine.minImmediate, Trips2Machine.maxImmediate

Method Detail

created

public static int created()

Return the number of instances of this class created.

remapRegisters

public void remapRegisters(int[] map)

Map the registers used in the instruction to the specified registers.

Overrides:

remapRegisters in class TripsInstruction

Parameters:

map - maps from the virtual register to real register

remapSrcRegister

public void remapSrcRegister(int oldReg,
                             int newReg)

Map the registers used in the instruction as sources to the specified register. If the register is not used as a source register, no change is made.

Overrides:

remapSrcRegister in class TripsInstruction

Parameters:

oldReg - is the previous source register

newReg - is the new source register

remapDestRegister

public void remapDestRegister(int oldReg,
                              int newReg)

Map the registers defined in the instruction as destinations to the specified register. If the register is not used as a destination register, no change is made.

Specified by:

remapDestRegister in class Instruction

Parameters:

oldReg - is the previous destination register

newReg - is the new destination register

getOpcode

public int getOpcode()

Return the instruction opcode.

Specified by:

getOpcode in class Instruction

getDestRegister

public int getDestRegister()

Return the destination register.

Overrides:

getDestRegister in class Instruction

getSrcRegisters

public int[] getSrcRegisters()

This routine returns the source registers for an instruction. Null is returned if there are no source registers.

Overrides:

getSrcRegisters in class TripsInstruction

getFormat

public byte getFormat()

Return the instruction format.

getRa

public int getRa()

Return the ra field.

getRb

public int getRb()

Return the rb field.

getImm

public long getImm()

Return the immediate field.

getDisp

public Displacement getDisp()

Return the displacement field.

setImm

protected void setImm(long imm)

Set the immediate field.

specifyRegisterUsage

public void specifyRegisterUsage(RegisterAllocator rs,
                                 int index,
                                 int strength)

Specify the registers used by this instruction.

Overrides:

specifyRegisterUsage in class TripsInstruction

Parameters:

rs - is the register set in use

index - is an index associated with the instruction

strength - is the importance of the instruction

See Also:

RegisterAllocator.useRegister(int,int,int), RegisterAllocator.defRegister(int,int)

uses

public boolean uses(int register,
                    RegisterSet registers)

Return true if the instruction uses the register.

Overrides:

uses in class TripsInstruction

defs

public boolean defs(int register,
                    RegisterSet registers)

Return true if the instruction sets the register

Overrides:

defs in class Instruction

independent

public boolean independent(Instruction inst,
                           RegisterSet registers)

Return true if this instruction is independent of the specified instruction. If instructions are independent, than one instruction can be moved before or after the other instruction without changing the semantics of the program.

Overrides:

independent in class TripsInstruction

Parameters:

inst - is the specified instruction

instructionSize

public int instructionSize()

Return the number of bytes required for the Trips instruction.

Specified by:

instructionSize in class Instruction

canBeDeleted

public boolean canBeDeleted(RegisterSet registers)

Return true if the instruction can be deleted without changing program semantics.

Overrides:

canBeDeleted in class Instruction

nullify

public void nullify(RegisterSet rs)

Mark the instruction so that it is not used.

Overrides:

nullify in class TripsInstruction

isCopy

public boolean isCopy()

Return true if the instruction copies a value from one register to another without modification. Transfers between integer and floating point registers are not considered to be copy instructions.

Overrides:

isCopy in class Instruction

getCopySrc

public int getCopySrc()

Return the source register of a copy instruction.

Overrides:

getCopySrc in class Instruction

getCopyDest

public int getCopyDest()

Return the source register of a copy instruction.

Overrides:

getCopyDest in class Instruction

ehash

public int ehash()

Return a hash code that can be used to determine equivalence. The hash code does not include predicates or the destination register.

Overrides:

ehash in class Instruction

assembler

public void assembler(Assembler asm,
                      Emit emit)

Insert the assembler representation of the instruction into the output stream.

Specified by:

assembler in class Instruction

toString

public java.lang.String toString()

Return a string representation of the instruction.

Overrides:

toString in class java.lang.Object