LLVM 20.0.0git
MachineInstrBundle.cpp
Go to the documentation of this file.
1//===-- lib/CodeGen/MachineInstrBundle.cpp --------------------------------===//
2//
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
6//
7//===----------------------------------------------------------------------===//
8
10#include "llvm/ADT/SmallSet.h"
14#include "llvm/CodeGen/Passes.h"
19#include "llvm/Pass.h"
20#include "llvm/PassRegistry.h"
21#include <utility>
22using namespace llvm;
23
24namespace {
25 class UnpackMachineBundles : public MachineFunctionPass {
26 public:
27 static char ID; // Pass identification
28 UnpackMachineBundles(
29 std::function<bool(const MachineFunction &)> Ftor = nullptr)
30 : MachineFunctionPass(ID), PredicateFtor(std::move(Ftor)) {
32 }
33
34 bool runOnMachineFunction(MachineFunction &MF) override;
35
36 private:
37 std::function<bool(const MachineFunction &)> PredicateFtor;
38 };
39} // end anonymous namespace
40
41char UnpackMachineBundles::ID = 0;
42char &llvm::UnpackMachineBundlesID = UnpackMachineBundles::ID;
43INITIALIZE_PASS(UnpackMachineBundles, "unpack-mi-bundles",
44 "Unpack machine instruction bundles", false, false)
45
46bool UnpackMachineBundles::runOnMachineFunction(MachineFunction &MF) {
47 if (PredicateFtor && !PredicateFtor(MF))
48 return false;
49
50 bool Changed = false;
51 for (MachineBasicBlock &MBB : MF) {
53 MIE = MBB.instr_end(); MII != MIE; ) {
54 MachineInstr *MI = &*MII;
55
56 // Remove BUNDLE instruction and the InsideBundle flags from bundled
57 // instructions.
58 if (MI->isBundle()) {
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);
64 }
65 }
66 MI->eraseFromParent();
67
68 Changed = true;
69 continue;
70 }
71
72 ++MII;
73 }
74 }
75
76 return Changed;
77}
78
81 std::function<bool(const MachineFunction &)> Ftor) {
82 return new UnpackMachineBundles(std::move(Ftor));
83}
84
85namespace {
86 class FinalizeMachineBundles : public MachineFunctionPass {
87 public:
88 static char ID; // Pass identification
89 FinalizeMachineBundles() : MachineFunctionPass(ID) {
91 }
92
93 bool runOnMachineFunction(MachineFunction &MF) override;
94 };
95} // end anonymous namespace
96
97char FinalizeMachineBundles::ID = 0;
98char &llvm::FinalizeMachineBundlesID = FinalizeMachineBundles::ID;
99INITIALIZE_PASS(FinalizeMachineBundles, "finalize-mi-bundles",
100 "Finalize machine instruction bundles", false, false)
101
102bool FinalizeMachineBundles::runOnMachineFunction(MachineFunction &MF) {
103 return llvm::finalizeBundles(MF);
104}
105
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.
111 for (auto MII = FirstMI; MII != LastMI; ++MII)
112 if (MII->getDebugLoc())
113 return MII->getDebugLoc();
114 return DebugLoc();
115}
116
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
122/// instruction.
126 assert(FirstMI != LastMI && "Empty bundle?");
127 MIBundleBuilder Bundle(MBB, FirstMI, LastMI);
128
132
134 BuildMI(MF, getDebugLoc(FirstMI, LastMI), TII->get(TargetOpcode::BUNDLE));
135 Bundle.prepend(MIB);
136
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;
146 for (auto MII = FirstMI; MII != LastMI; ++MII) {
147 // Debug instructions have no effects to track.
148 if (MII->isDebugInstr())
149 continue;
150
151 for (MachineOperand &MO : MII->operands()) {
152 if (!MO.isReg())
153 continue;
154 if (MO.isDef()) {
155 Defs.push_back(&MO);
156 continue;
157 }
158
159 Register Reg = MO.getReg();
160 if (!Reg)
161 continue;
162
163 if (LocalDefSet.count(Reg)) {
164 MO.setIsInternalRead();
165 if (MO.isKill())
166 // Internal def is now killed.
167 KilledDefSet.insert(Reg);
168 } else {
169 if (ExternUseSet.insert(Reg).second) {
170 ExternUses.push_back(Reg);
171 if (MO.isUndef())
172 UndefUseSet.insert(Reg);
173 }
174 if (MO.isKill())
175 // External def is now killed.
176 KilledUseSet.insert(Reg);
177 }
178 }
179
180 for (MachineOperand *MO : Defs) {
181 Register Reg = MO->getReg();
182 if (!Reg)
183 continue;
184
185 if (LocalDefSet.insert(Reg).second) {
186 LocalDefs.push_back(Reg);
187 if (MO->isDead()) {
188 DeadDefSet.insert(Reg);
189 }
190 } else {
191 // Re-defined inside the bundle, it's no longer killed.
192 KilledDefSet.erase(Reg);
193 if (!MO->isDead())
194 // Previously defined but dead.
195 DeadDefSet.erase(Reg);
196 }
197
198 if (!MO->isDead() && Reg.isPhysical()) {
199 for (MCPhysReg SubReg : TRI->subregs(Reg)) {
200 if (LocalDefSet.insert(SubReg).second)
201 LocalDefs.push_back(SubReg);
202 }
203 }
204 }
205
206 Defs.clear();
207 }
208
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));
216 }
217 }
218
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));
224 }
225
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))
231 if (MII->getFlag(MachineInstr::FrameDestroy))
233 }
234}
235
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.
245 MachineBasicBlock::instr_iterator LastMI = std::next(FirstMI);
246 while (LastMI != E && LastMI->isInsideBundle())
247 ++LastMI;
248 finalizeBundle(MBB, FirstMI, LastMI);
249 return LastMI;
250}
251
252/// finalizeBundles - Finalize instruction bundles in the specified
253/// MachineFunction. Return true if any bundles are finalized.
255 bool Changed = false;
256 for (MachineBasicBlock &MBB : MF) {
259 if (MII == MIE)
260 continue;
261 assert(!MII->isInsideBundle() &&
262 "First instr cannot be inside bundle before finalization!");
263
264 for (++MII; MII != MIE; ) {
265 if (!MII->isInsideBundle())
266 ++MII;
267 else {
268 MII = finalizeBundle(MBB, std::prev(MII));
269 Changed = true;
270 }
271 }
272 }
273
274 return Changed;
275}
276
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)
284 continue;
285
286 // Remember each (MI, OpNo) that refers to Reg.
287 if (Ops)
288 Ops->push_back(std::make_pair(MO.getParent(), O.getOperandNo()));
289
290 // Both defs and uses can read virtual registers.
291 if (MO.readsReg()) {
292 RI.Reads = true;
293 if (MO.isDef())
294 RI.Tied = true;
295 }
296
297 // Only defs can write.
298 if (MO.isDef())
299 RI.Writes = true;
300 else if (!RI.Tied &&
301 MO.getParent()->isRegTiedToDefOperand(O.getOperandNo()))
302 RI.Tied = true;
303 }
304 return RI;
305}
306
307std::pair<LaneBitmask, LaneBitmask>
310 const TargetRegisterInfo &TRI) {
311
312 LaneBitmask UseMask, DefMask;
313
314 for (const MachineOperand &MO : const_mi_bundle_ops(MI)) {
315 if (!MO.isReg() || MO.getReg() != Reg)
316 continue;
317
318 unsigned SubReg = MO.getSubReg();
319 if (SubReg == 0 && MO.isUse() && !MO.isUndef())
320 UseMask |= MRI.getMaxLaneMaskForVReg(Reg);
321
322 LaneBitmask SubRegMask = TRI.getSubRegIndexLaneMask(SubReg);
323 if (MO.isDef()) {
324 if (!MO.isUndef())
325 UseMask |= ~SubRegMask;
326 DefMask |= SubRegMask;
327 } else if (!MO.isUndef())
328 UseMask |= SubRegMask;
329 }
330
331 return {UseMask, DefMask};
332}
333
335 const TargetRegisterInfo *TRI) {
336 bool AllDefsDead = true;
337 PhysRegInfo PRI = {false, false, false, false, false, false, false, false};
338
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;
343 continue;
344 }
345
346 if (!MO.isReg())
347 continue;
348
349 Register MOReg = MO.getReg();
350 if (!MOReg || !MOReg.isPhysical())
351 continue;
352
353 if (!TRI->regsOverlap(MOReg, Reg))
354 continue;
355
356 bool Covered = TRI->isSuperRegisterEq(Reg, MOReg);
357 if (MO.readsReg()) {
358 PRI.Read = true;
359 if (Covered) {
360 PRI.FullyRead = true;
361 if (MO.isKill())
362 PRI.Killed = true;
363 }
364 } else if (MO.isDef()) {
365 PRI.Defined = true;
366 if (Covered)
367 PRI.FullyDefined = true;
368 if (!MO.isDead())
369 AllDefsDead = false;
370 }
371 }
372
373 if (AllDefsDead) {
374 if (PRI.FullyDefined || PRI.Clobbered)
375 PRI.DeadDef = true;
376 else if (PRI.Defined)
377 PRI.PartialDeadDef = true;
378 }
379
380 return PRI;
381}
unsigned SubReg
unsigned const MachineRegisterInfo * MRI
MachineBasicBlock & MBB
const HexagonInstrInfo * TII
static bool isUndef(ArrayRef< int > Mask)
IRTranslator LLVM IR MI
static DebugLoc getDebugLoc(MachineBasicBlock::instr_iterator FirstMI, MachineBasicBlock::instr_iterator LastMI)
Return the first found DebugLoc that has a DILocation, given a range of instructions.
unsigned const TargetRegisterInfo * TRI
#define INITIALIZE_PASS(passName, arg, name, cfg, analysis)
Definition: PassSupport.h:38
assert(ImpDefSCC.getReg()==AMDGPU::SCC &&ImpDefSCC.isDef())
This file defines the SmallSet class.
This file defines the SmallVector class.
A debug info location.
Definition: DebugLoc.h:33
FunctionPass class - This class is used to implement most global optimizations.
Definition: Pass.h:310
Helper class for constructing bundles of MachineInstrs.
MIBundleBuilder & prepend(MachineInstr *MI)
Insert MI into MBB by prepending it to the instructions in the bundle.
MIBundleOperands - Iterate over all operands in a bundle of machine instructions.
instr_iterator instr_begin()
Instructions::iterator instr_iterator
instr_iterator instr_end()
const MachineFunction * getParent() const
Return the MachineFunction containing this basic block.
MachineFunctionPass - This class adapts the FunctionPass interface to allow convenient creation of pa...
virtual bool runOnMachineFunction(MachineFunction &MF)=0
runOnMachineFunction - This method must be overloaded to perform the desired machine code transformat...
const TargetSubtargetInfo & getSubtarget() const
getSubtarget - Return the subtarget for which this machine code is being compiled.
const MachineInstrBuilder & setMIFlag(MachineInstr::MIFlag Flag) const
const MachineInstrBuilder & addReg(Register RegNo, unsigned flags=0, unsigned SubReg=0) const
Add a new virtual register operand.
Representation of each machine instruction.
Definition: MachineInstr.h:69
bool isRegTiedToDefOperand(unsigned UseOpIdx, unsigned *DefOpIdx=nullptr) const
Return true if the use operand of the specified index is tied to a def operand.
MachineOperand class - Representation of each machine instruction operand.
bool readsReg() const
readsReg - Returns true if this operand reads the previous value of its register.
bool isReg() const
isReg - Tests if this is a MO_Register operand.
MachineInstr * getParent()
getParent - Return the instruction that this operand belongs to.
Register getReg() const
getReg - Returns the register number.
MachineRegisterInfo - Keep track of information for virtual and physical registers,...
static PassRegistry * getPassRegistry()
getPassRegistry - Access the global registry object, which is automatically initialized at applicatio...
Wrapper class representing virtual and physical registers.
Definition: Register.h:19
constexpr bool isPhysical() const
Return true if the specified register number is in the physical register namespace.
Definition: Register.h:95
SmallSet - This maintains a set of unique values, optimizing for the case when the set is small (less...
Definition: SmallSet.h:135
size_type count(const T &V) const
count - Return 1 if the element is in the set, 0 otherwise.
Definition: SmallSet.h:166
bool erase(const T &V)
Definition: SmallSet.h:207
std::pair< const_iterator, bool > insert(const T &V)
insert - Insert an element into the set if it isn't already there.
Definition: SmallSet.h:179
This class consists of common code factored out of the SmallVector class to reduce code duplication b...
Definition: SmallVector.h:587
void push_back(const T &Elt)
Definition: SmallVector.h:427
This is a 'vector' (really, a variable-sized array), optimized for the case when the array is small.
Definition: SmallVector.h:1210
TargetInstrInfo - Interface to description of machine instruction set.
TargetRegisterInfo base class - We assume that the target defines a static array of TargetRegisterDes...
virtual const TargetRegisterInfo * getRegisterInfo() const
getRegisterInfo - If register information is available, return it.
virtual const TargetInstrInfo * getInstrInfo() const
unsigned ID
LLVM IR allows to use arbitrary numbers as calling convention identifiers.
Definition: CallingConv.h:24
This is an optimization pass for GlobalISel generic memory operations.
Definition: AddressRanges.h:18
char & FinalizeMachineBundlesID
FinalizeMachineBundles - This pass finalize machine instruction bundles (created earlier,...
void finalizeBundle(MachineBasicBlock &MBB, MachineBasicBlock::instr_iterator FirstMI, MachineBasicBlock::instr_iterator LastMI)
finalizeBundle - Finalize a machine instruction bundle which includes a sequence of instructions star...
MachineInstrBuilder BuildMI(MachineFunction &MF, const MIMetadata &MIMD, const MCInstrDesc &MCID)
Builder interface. Specify how to create the initial instruction itself.
bool finalizeBundles(MachineFunction &MF)
finalizeBundles - Finalize instruction bundles in the specified MachineFunction.
PhysRegInfo AnalyzePhysRegInBundle(const MachineInstr &MI, Register Reg, const TargetRegisterInfo *TRI)
AnalyzePhysRegInBundle - Analyze how the current instruction or bundle uses a physical register.
unsigned getDeadRegState(bool B)
void initializeFinalizeMachineBundlesPass(PassRegistry &)
void initializeUnpackMachineBundlesPass(PassRegistry &)
unsigned getImplRegState(bool B)
iterator_range< ConstMIBundleOperands > const_mi_bundle_ops(const MachineInstr &MI)
VirtRegInfo AnalyzeVirtRegInBundle(MachineInstr &MI, Register Reg, SmallVectorImpl< std::pair< MachineInstr *, unsigned > > *Ops=nullptr)
AnalyzeVirtRegInBundle - Analyze how the current instruction or bundle uses a virtual register.
unsigned getUndefRegState(bool B)
unsigned getDefRegState(bool B)
unsigned getKillRegState(bool B)
FunctionPass * createUnpackMachineBundles(std::function< bool(const MachineFunction &)> Ftor)
OutputIt move(R &&Range, OutputIt Out)
Provide wrappers to std::move which take ranges instead of having to pass begin/end explicitly.
Definition: STLExtras.h:1849
char & UnpackMachineBundlesID
UnpackMachineBundles - This pass unpack machine instruction bundles.
std::pair< LaneBitmask, LaneBitmask > AnalyzeVirtRegLanesInBundle(const MachineInstr &MI, Register Reg, const MachineRegisterInfo &MRI, const TargetRegisterInfo &TRI)
Return a pair of lane masks (reads, writes) indicating which lanes this instruction uses with Reg.
Implement std::hash so that hash_code can be used in STL containers.
Definition: BitVector.h:858
Information about how a physical register Reg is used by a set of operands.
bool Read
Reg or one of its aliases is read.
bool Defined
Reg or one of its aliases is defined.
bool Killed
There is a use operand of reg or a super-register with kill flag set.
bool PartialDeadDef
Reg is Defined and all defs of reg or an overlapping register are dead.
bool Clobbered
There is a regmask operand indicating Reg is clobbered.
bool FullyRead
Reg or a super-register is read. The full register is read.
bool FullyDefined
Reg or a super-register is defined.
VirtRegInfo - Information about a virtual register used by a set of operands.
bool Reads
Reads - One of the operands read the virtual register.
bool Tied
Tied - Uses and defs must use the same register.
bool Writes
Writes - One of the operands writes the virtual register.