1 //==- llvm/CodeGen/BreakFalseDeps.cpp - Break False Dependency Fix -*- C++ -*==//
3 // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
4 // See https://llvm.org/LICENSE.txt for license information.
5 // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
7 //===----------------------------------------------------------------------===//
9 /// \file Break False Dependency pass.
11 /// Some instructions have false dependencies which cause unnecessary stalls.
12 /// For example, instructions may write part of a register and implicitly
13 /// need to read the other parts of the register. This may cause unwanted
14 /// stalls preventing otherwise unrelated instructions from executing in
15 /// parallel in an out-of-order CPU.
16 /// This pass is aimed at identifying and avoiding these dependencies.
18 //===----------------------------------------------------------------------===//
20 #include "llvm/ADT/DepthFirstIterator.h"
21 #include "llvm/CodeGen/LivePhysRegs.h"
22 #include "llvm/CodeGen/MachineFunctionPass.h"
23 #include "llvm/CodeGen/ReachingDefAnalysis.h"
24 #include "llvm/CodeGen/RegisterClassInfo.h"
25 #include "llvm/CodeGen/TargetInstrInfo.h"
26 #include "llvm/InitializePasses.h"
27 #include "llvm/MC/MCInstrDesc.h"
28 #include "llvm/MC/MCRegister.h"
29 #include "llvm/MC/MCRegisterInfo.h"
30 #include "llvm/Support/Debug.h"
36 class BreakFalseDeps
: public MachineFunctionPass
{
38 MachineFunction
*MF
= nullptr;
39 const TargetInstrInfo
*TII
= nullptr;
40 const TargetRegisterInfo
*TRI
= nullptr;
41 RegisterClassInfo RegClassInfo
;
43 /// List of undefined register reads in this block in forward order.
44 std::vector
<std::pair
<MachineInstr
*, unsigned>> UndefReads
;
46 /// Storage for register unit liveness.
47 LivePhysRegs LiveRegSet
;
49 ReachingDefAnalysis
*RDA
= nullptr;
52 static char ID
; // Pass identification, replacement for typeid
54 BreakFalseDeps() : MachineFunctionPass(ID
) {
55 initializeBreakFalseDepsPass(*PassRegistry::getPassRegistry());
58 void getAnalysisUsage(AnalysisUsage
&AU
) const override
{
60 AU
.addRequired
<ReachingDefAnalysis
>();
61 MachineFunctionPass::getAnalysisUsage(AU
);
64 bool runOnMachineFunction(MachineFunction
&MF
) override
;
66 MachineFunctionProperties
getRequiredProperties() const override
{
67 return MachineFunctionProperties().set(
68 MachineFunctionProperties::Property::NoVRegs
);
72 /// Process he given basic block.
73 void processBasicBlock(MachineBasicBlock
*MBB
);
75 /// Update def-ages for registers defined by MI.
76 /// Also break dependencies on partial defs and undef uses.
77 void processDefs(MachineInstr
*MI
);
79 /// Helps avoid false dependencies on undef registers by updating the
80 /// machine instructions' undef operand to use a register that the instruction
81 /// is truly dependent on, or use a register with clearance higher than Pref.
82 /// Returns true if it was able to find a true dependency, thus not requiring
83 /// a dependency breaking instruction regardless of clearance.
84 bool pickBestRegisterForUndef(MachineInstr
*MI
, unsigned OpIdx
,
87 /// Return true to if it makes sense to break dependence on a partial
89 bool shouldBreakDependence(MachineInstr
*, unsigned OpIdx
, unsigned Pref
);
91 /// Break false dependencies on undefined register reads.
92 /// Walk the block backward computing precise liveness. This is expensive, so
93 /// we only do it on demand. Note that the occurrence of undefined register
94 /// reads that should be broken is very rare, but when they occur we may have
95 /// many in a single block.
96 void processUndefReads(MachineBasicBlock
*);
101 #define DEBUG_TYPE "break-false-deps"
103 char BreakFalseDeps::ID
= 0;
104 INITIALIZE_PASS_BEGIN(BreakFalseDeps
, DEBUG_TYPE
, "BreakFalseDeps", false, false)
105 INITIALIZE_PASS_DEPENDENCY(ReachingDefAnalysis
)
106 INITIALIZE_PASS_END(BreakFalseDeps
, DEBUG_TYPE
, "BreakFalseDeps", false, false)
108 FunctionPass
*llvm::createBreakFalseDeps() { return new BreakFalseDeps(); }
110 bool BreakFalseDeps::pickBestRegisterForUndef(MachineInstr
*MI
, unsigned OpIdx
,
113 // We can't change tied operands.
114 if (MI
->isRegTiedToDefOperand(OpIdx
))
117 MachineOperand
&MO
= MI
->getOperand(OpIdx
);
118 assert(MO
.isUndef() && "Expected undef machine operand");
120 // We can't change registers that aren't renamable.
121 if (!MO
.isRenamable())
124 MCRegister OriginalReg
= MO
.getReg().asMCReg();
126 // Update only undef operands that have reg units that are mapped to one root.
127 for (MCRegUnit Unit
: TRI
->regunits(OriginalReg
)) {
128 unsigned NumRoots
= 0;
129 for (MCRegUnitRootIterator
Root(Unit
, TRI
); Root
.isValid(); ++Root
) {
136 // Get the undef operand's register class
137 const TargetRegisterClass
*OpRC
=
138 TII
->getRegClass(MI
->getDesc(), OpIdx
, TRI
, *MF
);
139 assert(OpRC
&& "Not a valid register class");
141 // If the instruction has a true dependency, we can hide the false depdency
143 for (MachineOperand
&CurrMO
: MI
->all_uses()) {
144 if (CurrMO
.isUndef() || !OpRC
->contains(CurrMO
.getReg()))
146 // We found a true dependency - replace the undef register with the true
148 MO
.setReg(CurrMO
.getReg());
152 // Go over all registers in the register class and find the register with
153 // max clearance or clearance higher than Pref.
154 unsigned MaxClearance
= 0;
155 unsigned MaxClearanceReg
= OriginalReg
;
156 ArrayRef
<MCPhysReg
> Order
= RegClassInfo
.getOrder(OpRC
);
157 for (MCPhysReg Reg
: Order
) {
158 unsigned Clearance
= RDA
->getClearance(MI
, Reg
);
159 if (Clearance
<= MaxClearance
)
161 MaxClearance
= Clearance
;
162 MaxClearanceReg
= Reg
;
164 if (MaxClearance
> Pref
)
168 // Update the operand if we found a register with better clearance.
169 if (MaxClearanceReg
!= OriginalReg
)
170 MO
.setReg(MaxClearanceReg
);
175 bool BreakFalseDeps::shouldBreakDependence(MachineInstr
*MI
, unsigned OpIdx
,
177 MCRegister Reg
= MI
->getOperand(OpIdx
).getReg().asMCReg();
178 unsigned Clearance
= RDA
->getClearance(MI
, Reg
);
179 LLVM_DEBUG(dbgs() << "Clearance: " << Clearance
<< ", want " << Pref
);
181 if (Pref
> Clearance
) {
182 LLVM_DEBUG(dbgs() << ": Break dependency.\n");
185 LLVM_DEBUG(dbgs() << ": OK .\n");
189 void BreakFalseDeps::processDefs(MachineInstr
*MI
) {
190 assert(!MI
->isDebugInstr() && "Won't process debug values");
192 const MCInstrDesc
&MCID
= MI
->getDesc();
194 // Break dependence on undef uses. Do this before updating LiveRegs below.
195 // This can remove a false dependence with no additional instructions.
196 for (unsigned i
= MCID
.getNumDefs(), e
= MCID
.getNumOperands(); i
!= e
; ++i
) {
197 MachineOperand
&MO
= MI
->getOperand(i
);
198 if (!MO
.isReg() || !MO
.getReg() || !MO
.isUse() || !MO
.isUndef())
201 unsigned Pref
= TII
->getUndefRegClearance(*MI
, i
, TRI
);
203 bool HadTrueDependency
= pickBestRegisterForUndef(MI
, i
, Pref
);
204 // We don't need to bother trying to break a dependency if this
205 // instruction has a true dependency on that register through another
206 // operand - we'll have to wait for it to be available regardless.
207 if (!HadTrueDependency
&& shouldBreakDependence(MI
, i
, Pref
))
208 UndefReads
.push_back(std::make_pair(MI
, i
));
212 // The code below allows the target to create a new instruction to break the
213 // dependence. That opposes the goal of minimizing size, so bail out now.
214 if (MF
->getFunction().hasMinSize())
218 e
= MI
->isVariadic() ? MI
->getNumOperands() : MCID
.getNumDefs();
220 MachineOperand
&MO
= MI
->getOperand(i
);
221 if (!MO
.isReg() || !MO
.getReg())
225 // Check clearance before partial register updates.
226 unsigned Pref
= TII
->getPartialRegUpdateClearance(*MI
, i
, TRI
);
227 if (Pref
&& shouldBreakDependence(MI
, i
, Pref
))
228 TII
->breakPartialRegDependency(*MI
, i
, TRI
);
232 void BreakFalseDeps::processUndefReads(MachineBasicBlock
*MBB
) {
233 if (UndefReads
.empty())
236 // The code below allows the target to create a new instruction to break the
237 // dependence. That opposes the goal of minimizing size, so bail out now.
238 if (MF
->getFunction().hasMinSize())
241 // Collect this block's live out register units.
242 LiveRegSet
.init(*TRI
);
243 // We do not need to care about pristine registers as they are just preserved
244 // but not actually used in the function.
245 LiveRegSet
.addLiveOutsNoPristines(*MBB
);
247 MachineInstr
*UndefMI
= UndefReads
.back().first
;
248 unsigned OpIdx
= UndefReads
.back().second
;
250 for (MachineInstr
&I
: llvm::reverse(*MBB
)) {
251 // Update liveness, including the current instruction's defs.
252 LiveRegSet
.stepBackward(I
);
255 if (!LiveRegSet
.contains(UndefMI
->getOperand(OpIdx
).getReg()))
256 TII
->breakPartialRegDependency(*UndefMI
, OpIdx
, TRI
);
258 UndefReads
.pop_back();
259 if (UndefReads
.empty())
262 UndefMI
= UndefReads
.back().first
;
263 OpIdx
= UndefReads
.back().second
;
268 void BreakFalseDeps::processBasicBlock(MachineBasicBlock
*MBB
) {
270 // If this block is not done, it makes little sense to make any decisions
271 // based on clearance information. We need to make a second pass anyway,
272 // and by then we'll have better information, so we can avoid doing the work
273 // to try and break dependencies now.
274 for (MachineInstr
&MI
: *MBB
) {
275 if (!MI
.isDebugInstr())
278 processUndefReads(MBB
);
281 bool BreakFalseDeps::runOnMachineFunction(MachineFunction
&mf
) {
282 if (skipFunction(mf
.getFunction()))
285 TII
= MF
->getSubtarget().getInstrInfo();
286 TRI
= MF
->getSubtarget().getRegisterInfo();
287 RDA
= &getAnalysis
<ReachingDefAnalysis
>();
289 RegClassInfo
.runOnMachineFunction(mf
);
291 LLVM_DEBUG(dbgs() << "********** BREAK FALSE DEPENDENCIES **********\n");
293 // Skip Dead blocks due to ReachingDefAnalysis has no idea about instructions
295 df_iterator_default_set
<MachineBasicBlock
*> Reachable
;
296 for (MachineBasicBlock
*MBB
: depth_first_ext(&mf
, Reachable
))
297 (void)MBB
/* Mark all reachable blocks */;
299 // Traverse the basic blocks.
300 for (MachineBasicBlock
&MBB
: mf
)
301 if (Reachable
.count(&MBB
))
302 processBasicBlock(&MBB
);