LLVM 20.0.0git
Public Member Functions | Public Attributes | List of all members
false::Chain Class Reference

A Chain is a sequence of instructions that are linked together by an accumulation operand. More...

Public Member Functions

 Chain (MachineInstr *MI, unsigned Idx, Color C)
 
void add (MachineInstr *MI, unsigned Idx, Color C)
 Add a new instruction into the chain.
 
bool contains (MachineInstr &MI)
 Return true if MI is a member of the chain.
 
unsigned size () const
 Return the number of instructions in the chain.
 
void setKill (MachineInstr *MI, unsigned Idx, bool Immutable)
 Inform the chain that its last active register (the dest register of LastInst) is killed by MI with no intervening uses or defs.
 
MachineInstrgetStart () const
 Return the first instruction in the chain.
 
MachineInstrgetLast () const
 Return the last instruction in the chain.
 
MachineInstrgetKill () const
 Return the "kill" instruction (as set with setKill()) or NULL.
 
MachineBasicBlock::iterator end () const
 Return an instruction that can be used as an iterator for the end of the chain.
 
MachineBasicBlock::iterator begin () const
 
bool isKillImmutable () const
 Can the Kill instruction (assuming one exists) be modified?
 
Color getPreferredColor ()
 Return the preferred color of this chain.
 
bool rangeOverlapsWith (const Chain &Other) const
 Return true if this chain (StartInst..KillInst) overlaps with Other.
 
bool startsBefore (const Chain *Other) const
 Return true if this chain starts before Other.
 
bool requiresFixup () const
 Return true if the group will require a fixup MOV at the end.
 
std::string str () const
 Return a simple string representation of the chain.
 

Public Attributes

MachineInstrStartInst
 The important (marker) instructions.
 
MachineInstrLastInst
 
MachineInstrKillInst
 
unsigned StartInstIdx
 The index, from the start of the basic block, that each marker appears.
 
unsigned LastInstIdx
 
unsigned KillInstIdx
 
std::set< MachineInstr * > Insts
 All instructions in the chain.
 
bool KillIsImmutable
 True if KillInst cannot be modified.
 
Color LastColor
 The "color" of LastInst.
 

Detailed Description

A Chain is a sequence of instructions that are linked together by an accumulation operand.

For example:

fmul def d0, ? fmla def d1, ?, ?, killed d0 fmla def d2, ?, ?, killed d1

There may be other instructions interleaved in the sequence that do not belong to the chain. These other instructions must not use the "chain" register at any point.

We currently only support chains where the "chain" operand is killed at each link in the chain for simplicity. A chain has three important instructions - Start, Last and Kill.

Without a kill instruction, we must assume the outgoing value escapes beyond our model and either must not change its register or must create a fixup FMOV to keep the old register value consistent.

Definition at line 184 of file AArch64A57FPLoadBalancing.cpp.

Constructor & Destructor Documentation

◆ Chain()

false::Chain::Chain ( MachineInstr MI,
unsigned  Idx,
Color  C 
)
inline

Definition at line 202 of file AArch64A57FPLoadBalancing.cpp.

References MI.

Member Function Documentation

◆ add()

void false::Chain::add ( MachineInstr MI,
unsigned  Idx,
Color  C 
)
inline

Add a new instruction into the chain.

The instruction's dest operand has the given color.

Definition at line 211 of file AArch64A57FPLoadBalancing.cpp.

References assert(), llvm::CallingConv::C, Idx, and MI.

◆ begin()

MachineBasicBlock::iterator false::Chain::begin ( ) const
inline

Definition at line 252 of file AArch64A57FPLoadBalancing.cpp.

◆ contains()

bool false::Chain::contains ( MachineInstr MI)
inline

Return true if MI is a member of the chain.

Definition at line 223 of file AArch64A57FPLoadBalancing.cpp.

References MI.

◆ end()

MachineBasicBlock::iterator false::Chain::end ( ) const
inline

Return an instruction that can be used as an iterator for the end of the chain.

This is the maximum of KillInst (if set) and LastInst.

Definition at line 249 of file AArch64A57FPLoadBalancing.cpp.

◆ getKill()

MachineInstr * false::Chain::getKill ( ) const
inline

Return the "kill" instruction (as set with setKill()) or NULL.

Definition at line 246 of file AArch64A57FPLoadBalancing.cpp.

◆ getLast()

MachineInstr * false::Chain::getLast ( ) const
inline

Return the last instruction in the chain.

Definition at line 244 of file AArch64A57FPLoadBalancing.cpp.

◆ getPreferredColor()

Color false::Chain::getPreferredColor ( )
inline

Return the preferred color of this chain.

Definition at line 258 of file AArch64A57FPLoadBalancing.cpp.

References OverrideBalance.

◆ getStart()

MachineInstr * false::Chain::getStart ( ) const
inline

Return the first instruction in the chain.

Definition at line 242 of file AArch64A57FPLoadBalancing.cpp.

◆ isKillImmutable()

bool false::Chain::isKillImmutable ( ) const
inline

Can the Kill instruction (assuming one exists) be modified?

Definition at line 255 of file AArch64A57FPLoadBalancing.cpp.

◆ rangeOverlapsWith()

bool false::Chain::rangeOverlapsWith ( const Chain Other) const
inline

Return true if this chain (StartInst..KillInst) overlaps with Other.

Definition at line 265 of file AArch64A57FPLoadBalancing.cpp.

References End, and Other.

◆ requiresFixup()

bool false::Chain::requiresFixup ( ) const
inline

Return true if the group will require a fixup MOV at the end.

Definition at line 279 of file AArch64A57FPLoadBalancing.cpp.

◆ setKill()

void false::Chain::setKill ( MachineInstr MI,
unsigned  Idx,
bool  Immutable 
)
inline

Inform the chain that its last active register (the dest register of LastInst) is killed by MI with no intervening uses or defs.

Definition at line 232 of file AArch64A57FPLoadBalancing.cpp.

References assert(), Idx, and MI.

◆ size()

unsigned false::Chain::size ( ) const
inline

Return the number of instructions in the chain.

Definition at line 226 of file AArch64A57FPLoadBalancing.cpp.

◆ startsBefore()

bool false::Chain::startsBefore ( const Chain Other) const
inline

Return true if this chain starts before Other.

Definition at line 274 of file AArch64A57FPLoadBalancing.cpp.

References Other.

◆ str()

std::string false::Chain::str ( ) const
inline

Return a simple string representation of the chain.

Definition at line 284 of file AArch64A57FPLoadBalancing.cpp.

References OS, and llvm::MachineInstr::print().

Member Data Documentation

◆ Insts

std::set<MachineInstr*> false::Chain::Insts

All instructions in the chain.

Definition at line 192 of file AArch64A57FPLoadBalancing.cpp.

◆ KillInst

MachineInstr * false::Chain::KillInst

Definition at line 187 of file AArch64A57FPLoadBalancing.cpp.

◆ KillInstIdx

unsigned false::Chain::KillInstIdx

Definition at line 190 of file AArch64A57FPLoadBalancing.cpp.

◆ KillIsImmutable

bool false::Chain::KillIsImmutable

True if KillInst cannot be modified.

If this is true, we cannot change LastInst's outgoing register. This will be true for tied values and regmasks.

Definition at line 196 of file AArch64A57FPLoadBalancing.cpp.

◆ LastColor

Color false::Chain::LastColor

The "color" of LastInst.

This will be the preferred chain color, as changing intermediate nodes is easy but changing the last instruction can be more tricky.

Definition at line 200 of file AArch64A57FPLoadBalancing.cpp.

◆ LastInst

MachineInstr * false::Chain::LastInst

Definition at line 187 of file AArch64A57FPLoadBalancing.cpp.

◆ LastInstIdx

unsigned false::Chain::LastInstIdx

Definition at line 190 of file AArch64A57FPLoadBalancing.cpp.

◆ StartInst

MachineInstr* false::Chain::StartInst

The important (marker) instructions.

Definition at line 187 of file AArch64A57FPLoadBalancing.cpp.

◆ StartInstIdx

unsigned false::Chain::StartInstIdx

The index, from the start of the basic block, that each marker appears.

These are stored so we can do quick interval tests.

Definition at line 190 of file AArch64A57FPLoadBalancing.cpp.


The documentation for this class was generated from the following file: