1 //===-- lib/CodeGen/MachineInstrBundle.cpp --------------------------------===//
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 #include "llvm/CodeGen/MachineInstrBundle.h"
10 #include "llvm/ADT/SmallSet.h"
11 #include "llvm/ADT/SmallVector.h"
12 #include "llvm/CodeGen/MachineFunctionPass.h"
13 #include "llvm/CodeGen/MachineInstrBuilder.h"
14 #include "llvm/CodeGen/Passes.h"
15 #include "llvm/CodeGen/TargetInstrInfo.h"
16 #include "llvm/CodeGen/TargetRegisterInfo.h"
17 #include "llvm/CodeGen/TargetSubtargetInfo.h"
18 #include "llvm/InitializePasses.h"
19 #include "llvm/Pass.h"
20 #include "llvm/PassRegistry.h"
25 class UnpackMachineBundles
: public MachineFunctionPass
{
27 static char ID
; // Pass identification
29 std::function
<bool(const MachineFunction
&)> Ftor
= nullptr)
30 : MachineFunctionPass(ID
), PredicateFtor(std::move(Ftor
)) {
31 initializeUnpackMachineBundlesPass(*PassRegistry::getPassRegistry());
34 bool runOnMachineFunction(MachineFunction
&MF
) override
;
37 std::function
<bool(const MachineFunction
&)> PredicateFtor
;
39 } // end anonymous namespace
41 char UnpackMachineBundles::ID
= 0;
42 char &llvm::UnpackMachineBundlesID
= UnpackMachineBundles::ID
;
43 INITIALIZE_PASS(UnpackMachineBundles
, "unpack-mi-bundles",
44 "Unpack machine instruction bundles", false, false)
46 bool UnpackMachineBundles::runOnMachineFunction(MachineFunction
&MF
) {
47 if (PredicateFtor
&& !PredicateFtor(MF
))
51 for (MachineBasicBlock
&MBB
: MF
) {
52 for (MachineBasicBlock::instr_iterator MII
= MBB
.instr_begin(),
53 MIE
= MBB
.instr_end(); MII
!= MIE
; ) {
54 MachineInstr
*MI
= &*MII
;
56 // Remove BUNDLE instruction and the InsideBundle flags from bundled
59 while (++MII
!= MIE
&& MII
->isBundledWithPred()) {
60 MII
->unbundleFromPred();
61 for (MachineOperand
&MO
: MII
->operands()) {
62 if (MO
.isReg() && MO
.isInternalRead())
63 MO
.setIsInternalRead(false);
66 MI
->eraseFromParent();
80 llvm::createUnpackMachineBundles(
81 std::function
<bool(const MachineFunction
&)> Ftor
) {
82 return new UnpackMachineBundles(std::move(Ftor
));
86 class FinalizeMachineBundles
: public MachineFunctionPass
{
88 static char ID
; // Pass identification
89 FinalizeMachineBundles() : MachineFunctionPass(ID
) {
90 initializeFinalizeMachineBundlesPass(*PassRegistry::getPassRegistry());
93 bool runOnMachineFunction(MachineFunction
&MF
) override
;
95 } // end anonymous namespace
97 char FinalizeMachineBundles::ID
= 0;
98 char &llvm::FinalizeMachineBundlesID
= FinalizeMachineBundles::ID
;
99 INITIALIZE_PASS(FinalizeMachineBundles
, "finalize-mi-bundles",
100 "Finalize machine instruction bundles", false, false)
102 bool FinalizeMachineBundles::runOnMachineFunction(MachineFunction
&MF
) {
103 return llvm::finalizeBundles(MF
);
106 /// Return the first found DebugLoc that has a DILocation, given a range of
107 /// instructions. The search range is from FirstMI to LastMI (exclusive). If no
108 /// DILocation is found, then an empty location is returned.
109 static DebugLoc
getDebugLoc(MachineBasicBlock::instr_iterator FirstMI
,
110 MachineBasicBlock::instr_iterator LastMI
) {
111 for (auto MII
= FirstMI
; MII
!= LastMI
; ++MII
)
112 if (MII
->getDebugLoc())
113 return MII
->getDebugLoc();
117 /// finalizeBundle - Finalize a machine instruction bundle which includes
118 /// a sequence of instructions starting from FirstMI to LastMI (exclusive).
119 /// This routine adds a BUNDLE instruction to represent the bundle, it adds
120 /// IsInternalRead markers to MachineOperands which are defined inside the
121 /// bundle, and it copies externally visible defs and uses to the BUNDLE
123 void llvm::finalizeBundle(MachineBasicBlock
&MBB
,
124 MachineBasicBlock::instr_iterator FirstMI
,
125 MachineBasicBlock::instr_iterator LastMI
) {
126 assert(FirstMI
!= LastMI
&& "Empty bundle?");
127 MIBundleBuilder
Bundle(MBB
, FirstMI
, LastMI
);
129 MachineFunction
&MF
= *MBB
.getParent();
130 const TargetInstrInfo
*TII
= MF
.getSubtarget().getInstrInfo();
131 const TargetRegisterInfo
*TRI
= MF
.getSubtarget().getRegisterInfo();
133 MachineInstrBuilder MIB
=
134 BuildMI(MF
, getDebugLoc(FirstMI
, LastMI
), TII
->get(TargetOpcode::BUNDLE
));
137 SmallVector
<Register
, 32> LocalDefs
;
138 SmallSet
<Register
, 32> LocalDefSet
;
139 SmallSet
<Register
, 8> DeadDefSet
;
140 SmallSet
<Register
, 16> KilledDefSet
;
141 SmallVector
<Register
, 8> ExternUses
;
142 SmallSet
<Register
, 8> ExternUseSet
;
143 SmallSet
<Register
, 8> KilledUseSet
;
144 SmallSet
<Register
, 8> UndefUseSet
;
145 SmallVector
<MachineOperand
*, 4> Defs
;
146 for (auto MII
= FirstMI
; MII
!= LastMI
; ++MII
) {
147 // Debug instructions have no effects to track.
148 if (MII
->isDebugInstr())
151 for (MachineOperand
&MO
: MII
->operands()) {
159 Register Reg
= MO
.getReg();
163 if (LocalDefSet
.count(Reg
)) {
164 MO
.setIsInternalRead();
166 // Internal def is now killed.
167 KilledDefSet
.insert(Reg
);
169 if (ExternUseSet
.insert(Reg
).second
) {
170 ExternUses
.push_back(Reg
);
172 UndefUseSet
.insert(Reg
);
175 // External def is now killed.
176 KilledUseSet
.insert(Reg
);
180 for (MachineOperand
*MO
: Defs
) {
181 Register Reg
= MO
->getReg();
185 if (LocalDefSet
.insert(Reg
).second
) {
186 LocalDefs
.push_back(Reg
);
188 DeadDefSet
.insert(Reg
);
191 // Re-defined inside the bundle, it's no longer killed.
192 KilledDefSet
.erase(Reg
);
194 // Previously defined but dead.
195 DeadDefSet
.erase(Reg
);
198 if (!MO
->isDead() && Reg
.isPhysical()) {
199 for (MCPhysReg SubReg
: TRI
->subregs(Reg
)) {
200 if (LocalDefSet
.insert(SubReg
).second
)
201 LocalDefs
.push_back(SubReg
);
209 SmallSet
<Register
, 32> Added
;
210 for (Register Reg
: LocalDefs
) {
211 if (Added
.insert(Reg
).second
) {
212 // If it's not live beyond end of the bundle, mark it dead.
213 bool isDead
= DeadDefSet
.count(Reg
) || KilledDefSet
.count(Reg
);
214 MIB
.addReg(Reg
, getDefRegState(true) | getDeadRegState(isDead
) |
215 getImplRegState(true));
219 for (Register Reg
: ExternUses
) {
220 bool isKill
= KilledUseSet
.count(Reg
);
221 bool isUndef
= UndefUseSet
.count(Reg
);
222 MIB
.addReg(Reg
, getKillRegState(isKill
) | getUndefRegState(isUndef
) |
223 getImplRegState(true));
226 // Set FrameSetup/FrameDestroy for the bundle. If any of the instructions got
227 // the property, then also set it on the bundle.
228 for (auto MII
= FirstMI
; MII
!= LastMI
; ++MII
) {
229 if (MII
->getFlag(MachineInstr::FrameSetup
))
230 MIB
.setMIFlag(MachineInstr::FrameSetup
);
231 if (MII
->getFlag(MachineInstr::FrameDestroy
))
232 MIB
.setMIFlag(MachineInstr::FrameDestroy
);
236 /// finalizeBundle - Same functionality as the previous finalizeBundle except
237 /// the last instruction in the bundle is not provided as an input. This is
238 /// used in cases where bundles are pre-determined by marking instructions
239 /// with 'InsideBundle' marker. It returns the MBB instruction iterator that
240 /// points to the end of the bundle.
241 MachineBasicBlock::instr_iterator
242 llvm::finalizeBundle(MachineBasicBlock
&MBB
,
243 MachineBasicBlock::instr_iterator FirstMI
) {
244 MachineBasicBlock::instr_iterator E
= MBB
.instr_end();
245 MachineBasicBlock::instr_iterator LastMI
= std::next(FirstMI
);
246 while (LastMI
!= E
&& LastMI
->isInsideBundle())
248 finalizeBundle(MBB
, FirstMI
, LastMI
);
252 /// finalizeBundles - Finalize instruction bundles in the specified
253 /// MachineFunction. Return true if any bundles are finalized.
254 bool llvm::finalizeBundles(MachineFunction
&MF
) {
255 bool Changed
= false;
256 for (MachineBasicBlock
&MBB
: MF
) {
257 MachineBasicBlock::instr_iterator MII
= MBB
.instr_begin();
258 MachineBasicBlock::instr_iterator MIE
= MBB
.instr_end();
261 assert(!MII
->isInsideBundle() &&
262 "First instr cannot be inside bundle before finalization!");
264 for (++MII
; MII
!= MIE
; ) {
265 if (!MII
->isInsideBundle())
268 MII
= finalizeBundle(MBB
, std::prev(MII
));
277 VirtRegInfo
llvm::AnalyzeVirtRegInBundle(
278 MachineInstr
&MI
, Register Reg
,
279 SmallVectorImpl
<std::pair
<MachineInstr
*, unsigned>> *Ops
) {
280 VirtRegInfo RI
= {false, false, false};
281 for (MIBundleOperands
O(MI
); O
.isValid(); ++O
) {
282 MachineOperand
&MO
= *O
;
283 if (!MO
.isReg() || MO
.getReg() != Reg
)
286 // Remember each (MI, OpNo) that refers to Reg.
288 Ops
->push_back(std::make_pair(MO
.getParent(), O
.getOperandNo()));
290 // Both defs and uses can read virtual registers.
297 // Only defs can write.
301 MO
.getParent()->isRegTiedToDefOperand(O
.getOperandNo()))
307 std::pair
<LaneBitmask
, LaneBitmask
>
308 llvm::AnalyzeVirtRegLanesInBundle(const MachineInstr
&MI
, Register Reg
,
309 const MachineRegisterInfo
&MRI
,
310 const TargetRegisterInfo
&TRI
) {
312 LaneBitmask UseMask
, DefMask
;
314 for (const MachineOperand
&MO
: const_mi_bundle_ops(MI
)) {
315 if (!MO
.isReg() || MO
.getReg() != Reg
)
318 unsigned SubReg
= MO
.getSubReg();
319 if (SubReg
== 0 && MO
.isUse() && !MO
.isUndef())
320 UseMask
|= MRI
.getMaxLaneMaskForVReg(Reg
);
322 LaneBitmask SubRegMask
= TRI
.getSubRegIndexLaneMask(SubReg
);
325 UseMask
|= ~SubRegMask
;
326 DefMask
|= SubRegMask
;
327 } else if (!MO
.isUndef())
328 UseMask
|= SubRegMask
;
331 return {UseMask
, DefMask
};
334 PhysRegInfo
llvm::AnalyzePhysRegInBundle(const MachineInstr
&MI
, Register Reg
,
335 const TargetRegisterInfo
*TRI
) {
336 bool AllDefsDead
= true;
337 PhysRegInfo PRI
= {false, false, false, false, false, false, false, false};
339 assert(Reg
.isPhysical() && "analyzePhysReg not given a physical register!");
340 for (const MachineOperand
&MO
: const_mi_bundle_ops(MI
)) {
341 if (MO
.isRegMask() && MO
.clobbersPhysReg(Reg
)) {
342 PRI
.Clobbered
= true;
349 Register MOReg
= MO
.getReg();
350 if (!MOReg
|| !MOReg
.isPhysical())
353 if (!TRI
->regsOverlap(MOReg
, Reg
))
356 bool Covered
= TRI
->isSuperRegisterEq(Reg
, MOReg
);
360 PRI
.FullyRead
= true;
364 } else if (MO
.isDef()) {
367 PRI
.FullyDefined
= true;
374 if (PRI
.FullyDefined
|| PRI
.Clobbered
)
376 else if (PRI
.Defined
)
377 PRI
.PartialDeadDef
= true;