scale.backend.sparc
Class SparcBranch

java.lang.Object
  scale.backend.Instruction
      scale.backend.Branch
          scale.backend.sparc.SparcBranch

All Implemented Interfaces:

java.lang.Cloneable

Direct Known Subclasses:

BranchCCInstruction, BranchInstruction, BranchRegInstruction, CallInstruction, JmplInstruction, JmplLitInstruction, ReturnInstruction, ReturnLitInstruction

public abstract class SparcBranch
extends Branch

This is the abstract class for all machine SparcBranch instructions.

$Id: SparcBranch.java,v 1.25 2006-11-16 17:49:38 burrill Exp $

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

Field Summary

protected boolean	annulled Annulled?
protected SparcInstruction	delaySlot The delay slot instruction is kept as part of the branch.
protected int	opcode the instruction opcode
protected boolean	pt True branch predicted?

Constructor Summary

protected

SparcBranch(int opcode, boolean annulled, boolean pt, int numTargets, SparcInstruction delaySlot)

Method Summary

protected void	assembleDelay(Assembler asm, Emit emit) Assemble the delay slot instruction.
java.lang.String	assembleDisp(Assembler asm, Displacement disp, int ftn) Generate a String representation of a Displacement that can be used by the assembly code generater.
boolean	canBeAnnulled() Return true if the branch can be annulled.
boolean	canBeDeleted(RegisterSet registers) Return true if the instruction can be deleted without changing program semantics.
boolean	defs(int register, RegisterSet registers) Return true if the instruction sets the register.
protected void	delayToStringBuf(java.lang.StringBuffer buf) toString() helper method.
boolean	getAnnulled()
SparcInstruction	getDelaySlot()
int	getOpcode() Return the numeric opcode of the instruction.
boolean	getPt()
int	instructionSize() Return the number of bytes required for the instruction.
boolean	isUnconditional() Return true if the branch is an unconditional transfer of control to a new address.
boolean	mods(int register, RegisterSet registers) Return true if the instruction clobbers the register.
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 virtual registers referenced in the instruction to the specified real registers.
void	remapSrcRegister(int oldReg, int newReg) Map the registers used in the instruction as sources to the specified register.
protected void	setAnnulled(boolean annulled) Specify if the following instruction is annulled.
protected void	setDelaySlot(SparcInstruction delaySlot)
protected void	setOpcode(int opcode)
protected void	setReturnedStructSize(int size) Specifiy the size of the struct returned by the call or 0 if none.
void	specifyRegisterUsage(RegisterAllocator rs, int index, int strength) Specify the registers used by this instruction.
boolean	uses(int register, RegisterSet registers) Return true if the instruction uses the register.

Methods inherited from class scale.backend.Branch

additionalRegsKilled, additionalRegsSet, additionalRegsUsed, addTarget, copy, getBranchProbability, getExecutionCycles, getRegsKilled, getTarget, independent, isBranch, isCall, markAsCall, nullify, numTargets, setBranchProbability, toString, uses

Methods inherited from class scale.backend.Instruction

assembler, clone, ehash, getBBID, getCopyDest, getCopySrc, getDestRegister, getFunctionalUnit, getLoopNumber, getNext, getPredicate, getPredicates, getSrcRegisters, getTag, isCopy, isLabel, isLoad, isMandatory, isMarker, isPhi, isPredicated, isPredicatedOnTrue, isPrefetch, isSpillInstruction, isSpillLoadPoint, isSpillStorePoint, isStore, markSpillInstruction, nullified, numPredicates, removePredicates, setBBID, setLoopNumber, setMandatory, setNext, setPredicate, setPredicate, setPredicatedOnTrue, setPredicates, setsSpecialReg, setTag, specifyNotSpillLoadPoint, specifySpillStorePoint

Methods inherited from class java.lang.Object

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

Field Detail

opcode

protected int opcode

the instruction opcode

annulled

protected boolean annulled

Annulled?

pt

protected boolean pt

True branch predicted?

delaySlot

protected SparcInstruction delaySlot

The delay slot instruction is kept as part of the branch.

Constructor Detail

SparcBranch

protected SparcBranch(int opcode,
                      boolean annulled,
                      boolean pt,
                      int numTargets,
                      SparcInstruction delaySlot)

Parameters:

numTargets - is the number of successors of this instruction.

annulled - is true if the next instruction is annulled

pt - is true if the true condition is predicted

delaySlot - is the delay slot instruction For routine calls, it does not include the routine called.

Method Detail

setReturnedStructSize

protected void setReturnedStructSize(int size)

Specifiy the size of the struct returned by the call or 0 if none.

specifyRegisterUsage

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

Specify the registers used by this instruction.

Overrides:

specifyRegisterUsage in class Branch

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)

remapRegisters

public void remapRegisters(int[] map)

Description copied from class: Branch

Map the virtual registers referenced in the instruction to the specified real registers. The mapping is specified using an array that is indexed by the virtual register to return the real register.

Overrides:

remapRegisters in class Branch

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 Branch

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.

Overrides:

remapDestRegister in class Branch

Parameters:

oldReg - is the previous destination register

newReg - is the new destination register

uses

public boolean uses(int register,
                    RegisterSet registers)

Return true if the instruction uses the register.

Overrides:

uses in class Branch

defs

public boolean defs(int register,
                    RegisterSet registers)

Return true if the instruction sets the register.

Overrides:

defs in class Branch

mods

public boolean mods(int register,
                    RegisterSet registers)

Return true if the instruction clobbers the register.

Overrides:

mods in class Branch

assembleDisp

public java.lang.String assembleDisp(Assembler asm,
                                     Displacement disp,
                                     int ftn)

Generate a String representation of a Displacement that can be used by the assembly code generater.

getOpcode

public int getOpcode()

Description copied from class: Instruction

Return the numeric opcode of the instruction. This opcode may be an encoding of the actual instruction opcode.

Specified by:

getOpcode in class Instruction

setOpcode

protected void setOpcode(int opcode)

getDelaySlot

public SparcInstruction getDelaySlot()

setDelaySlot

protected void setDelaySlot(SparcInstruction delaySlot)

getAnnulled

public boolean getAnnulled()

Returns:

true if the following instruction is annulled

setAnnulled

protected void setAnnulled(boolean annulled)

Specify if the following instruction is annulled.

getPt

public boolean getPt()

Returns:

true if the branch is predicited to occur

canBeDeleted

public boolean canBeDeleted(RegisterSet registers)

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

Overrides:

canBeDeleted in class Instruction

instructionSize

public int instructionSize()

Description copied from class: Instruction

Return the number of bytes required for the instruction.

Specified by:

instructionSize in class Instruction

Returns:

the number of bytes required for the Branch Instruction

assembleDelay

protected final void assembleDelay(Assembler asm,
                                   Emit emit)

Assemble the delay slot instruction.

delayToStringBuf

protected final void delayToStringBuf(java.lang.StringBuffer buf)

toString() helper method.

canBeAnnulled

public boolean canBeAnnulled()

Return true if the branch can be annulled.

isUnconditional

public boolean isUnconditional()

Return true if the branch is an unconditional transfer of control to a new address.