xref: /freebsd-src/contrib/llvm-project/llvm/lib/CodeGen/GlobalISel/InstructionSelect.cpp (revision 4824e7fd18a1223177218d4aec1b3c6c5c4a444e)
1 //===- llvm/CodeGen/GlobalISel/InstructionSelect.cpp - InstructionSelect ---==//
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 /// \file
9 /// This file implements the InstructionSelect class.
10 //===----------------------------------------------------------------------===//
11 
12 #include "llvm/CodeGen/GlobalISel/InstructionSelect.h"
13 #include "llvm/ADT/PostOrderIterator.h"
14 #include "llvm/ADT/ScopeExit.h"
15 #include "llvm/ADT/Twine.h"
16 #include "llvm/Analysis/BlockFrequencyInfo.h"
17 #include "llvm/Analysis/LazyBlockFrequencyInfo.h"
18 #include "llvm/Analysis/ProfileSummaryInfo.h"
19 #include "llvm/CodeGen/GlobalISel/GISelKnownBits.h"
20 #include "llvm/CodeGen/GlobalISel/InstructionSelector.h"
21 #include "llvm/CodeGen/GlobalISel/LegalizerInfo.h"
22 #include "llvm/CodeGen/GlobalISel/Utils.h"
23 #include "llvm/CodeGen/MachineFrameInfo.h"
24 #include "llvm/CodeGen/MachineOptimizationRemarkEmitter.h"
25 #include "llvm/CodeGen/MachineRegisterInfo.h"
26 #include "llvm/CodeGen/TargetInstrInfo.h"
27 #include "llvm/CodeGen/TargetLowering.h"
28 #include "llvm/CodeGen/TargetPassConfig.h"
29 #include "llvm/CodeGen/TargetSubtargetInfo.h"
30 #include "llvm/Config/config.h"
31 #include "llvm/IR/Constants.h"
32 #include "llvm/IR/Function.h"
33 #include "llvm/MC/TargetRegistry.h"
34 #include "llvm/Support/CommandLine.h"
35 #include "llvm/Support/Debug.h"
36 #include "llvm/Target/TargetMachine.h"
37 
38 #define DEBUG_TYPE "instruction-select"
39 
40 using namespace llvm;
41 
42 #ifdef LLVM_GISEL_COV_PREFIX
43 static cl::opt<std::string>
44     CoveragePrefix("gisel-coverage-prefix", cl::init(LLVM_GISEL_COV_PREFIX),
45                    cl::desc("Record GlobalISel rule coverage files of this "
46                             "prefix if instrumentation was generated"));
47 #else
48 static const std::string CoveragePrefix;
49 #endif
50 
51 char InstructionSelect::ID = 0;
52 INITIALIZE_PASS_BEGIN(InstructionSelect, DEBUG_TYPE,
53                       "Select target instructions out of generic instructions",
54                       false, false)
55 INITIALIZE_PASS_DEPENDENCY(TargetPassConfig)
56 INITIALIZE_PASS_DEPENDENCY(GISelKnownBitsAnalysis)
57 INITIALIZE_PASS_DEPENDENCY(ProfileSummaryInfoWrapperPass)
58 INITIALIZE_PASS_DEPENDENCY(LazyBlockFrequencyInfoPass)
59 INITIALIZE_PASS_END(InstructionSelect, DEBUG_TYPE,
60                     "Select target instructions out of generic instructions",
61                     false, false)
62 
63 InstructionSelect::InstructionSelect(CodeGenOpt::Level OL)
64     : MachineFunctionPass(ID), OptLevel(OL) {}
65 
66 // In order not to crash when calling getAnalysis during testing with -run-pass
67 // we use the default opt level here instead of None, so that the addRequired()
68 // calls are made in getAnalysisUsage().
69 InstructionSelect::InstructionSelect()
70     : MachineFunctionPass(ID), OptLevel(CodeGenOpt::Default) {}
71 
72 void InstructionSelect::getAnalysisUsage(AnalysisUsage &AU) const {
73   AU.addRequired<TargetPassConfig>();
74   if (OptLevel != CodeGenOpt::None) {
75     AU.addRequired<GISelKnownBitsAnalysis>();
76     AU.addPreserved<GISelKnownBitsAnalysis>();
77     AU.addRequired<ProfileSummaryInfoWrapperPass>();
78     LazyBlockFrequencyInfoPass::getLazyBFIAnalysisUsage(AU);
79   }
80   getSelectionDAGFallbackAnalysisUsage(AU);
81   MachineFunctionPass::getAnalysisUsage(AU);
82 }
83 
84 bool InstructionSelect::runOnMachineFunction(MachineFunction &MF) {
85   // If the ISel pipeline failed, do not bother running that pass.
86   if (MF.getProperties().hasProperty(
87           MachineFunctionProperties::Property::FailedISel))
88     return false;
89 
90   LLVM_DEBUG(dbgs() << "Selecting function: " << MF.getName() << '\n');
91 
92   const TargetPassConfig &TPC = getAnalysis<TargetPassConfig>();
93   InstructionSelector *ISel = MF.getSubtarget().getInstructionSelector();
94 
95   CodeGenOpt::Level OldOptLevel = OptLevel;
96   auto RestoreOptLevel = make_scope_exit([=]() { OptLevel = OldOptLevel; });
97   OptLevel = MF.getFunction().hasOptNone() ? CodeGenOpt::None
98                                            : MF.getTarget().getOptLevel();
99 
100   GISelKnownBits *KB = nullptr;
101   if (OptLevel != CodeGenOpt::None) {
102     KB = &getAnalysis<GISelKnownBitsAnalysis>().get(MF);
103     PSI = &getAnalysis<ProfileSummaryInfoWrapperPass>().getPSI();
104     if (PSI && PSI->hasProfileSummary())
105       BFI = &getAnalysis<LazyBlockFrequencyInfoPass>().getBFI();
106   }
107 
108   CodeGenCoverage CoverageInfo;
109   assert(ISel && "Cannot work without InstructionSelector");
110   ISel->setupMF(MF, KB, CoverageInfo, PSI, BFI);
111 
112   // An optimization remark emitter. Used to report failures.
113   MachineOptimizationRemarkEmitter MORE(MF, /*MBFI=*/nullptr);
114 
115   // FIXME: There are many other MF/MFI fields we need to initialize.
116 
117   MachineRegisterInfo &MRI = MF.getRegInfo();
118 #ifndef NDEBUG
119   // Check that our input is fully legal: we require the function to have the
120   // Legalized property, so it should be.
121   // FIXME: This should be in the MachineVerifier, as the RegBankSelected
122   // property check already is.
123   if (!DisableGISelLegalityCheck)
124     if (const MachineInstr *MI = machineFunctionIsIllegal(MF)) {
125       reportGISelFailure(MF, TPC, MORE, "gisel-select",
126                          "instruction is not legal", *MI);
127       return false;
128     }
129   // FIXME: We could introduce new blocks and will need to fix the outer loop.
130   // Until then, keep track of the number of blocks to assert that we don't.
131   const size_t NumBlocks = MF.size();
132 #endif
133   // Keep track of selected blocks, so we can delete unreachable ones later.
134   DenseSet<MachineBasicBlock *> SelectedBlocks;
135 
136   for (MachineBasicBlock *MBB : post_order(&MF)) {
137     ISel->CurMBB = MBB;
138     SelectedBlocks.insert(MBB);
139     if (MBB->empty())
140       continue;
141 
142     // Select instructions in reverse block order. We permit erasing so have
143     // to resort to manually iterating and recognizing the begin (rend) case.
144     bool ReachedBegin = false;
145     for (auto MII = std::prev(MBB->end()), Begin = MBB->begin();
146          !ReachedBegin;) {
147 #ifndef NDEBUG
148       // Keep track of the insertion range for debug printing.
149       const auto AfterIt = std::next(MII);
150 #endif
151       // Select this instruction.
152       MachineInstr &MI = *MII;
153 
154       // And have our iterator point to the next instruction, if there is one.
155       if (MII == Begin)
156         ReachedBegin = true;
157       else
158         --MII;
159 
160       LLVM_DEBUG(dbgs() << "Selecting: \n  " << MI);
161 
162       // We could have folded this instruction away already, making it dead.
163       // If so, erase it.
164       if (isTriviallyDead(MI, MRI)) {
165         LLVM_DEBUG(dbgs() << "Is dead; erasing.\n");
166         MI.eraseFromParentAndMarkDBGValuesForRemoval();
167         continue;
168       }
169 
170       // Eliminate hints.
171       if (isPreISelGenericOptimizationHint(MI.getOpcode())) {
172         Register DstReg = MI.getOperand(0).getReg();
173         Register SrcReg = MI.getOperand(1).getReg();
174 
175         // At this point, the destination register class of the hint may have
176         // been decided.
177         //
178         // Propagate that through to the source register.
179         const TargetRegisterClass *DstRC = MRI.getRegClassOrNull(DstReg);
180         if (DstRC)
181           MRI.setRegClass(SrcReg, DstRC);
182         assert(canReplaceReg(DstReg, SrcReg, MRI) &&
183                "Must be able to replace dst with src!");
184         MI.eraseFromParent();
185         MRI.replaceRegWith(DstReg, SrcReg);
186         continue;
187       }
188 
189       if (!ISel->select(MI)) {
190         // FIXME: It would be nice to dump all inserted instructions.  It's
191         // not obvious how, esp. considering select() can insert after MI.
192         reportGISelFailure(MF, TPC, MORE, "gisel-select", "cannot select", MI);
193         return false;
194       }
195 
196       // Dump the range of instructions that MI expanded into.
197       LLVM_DEBUG({
198         auto InsertedBegin = ReachedBegin ? MBB->begin() : std::next(MII);
199         dbgs() << "Into:\n";
200         for (auto &InsertedMI : make_range(InsertedBegin, AfterIt))
201           dbgs() << "  " << InsertedMI;
202         dbgs() << '\n';
203       });
204     }
205   }
206 
207   for (MachineBasicBlock &MBB : MF) {
208     if (MBB.empty())
209       continue;
210 
211     if (!SelectedBlocks.contains(&MBB)) {
212       // This is an unreachable block and therefore hasn't been selected, since
213       // the main selection loop above uses a postorder block traversal.
214       // We delete all the instructions in this block since it's unreachable.
215       MBB.clear();
216       // Don't delete the block in case the block has it's address taken or is
217       // still being referenced by a phi somewhere.
218       continue;
219     }
220     // Try to find redundant copies b/w vregs of the same register class.
221     bool ReachedBegin = false;
222     for (auto MII = std::prev(MBB.end()), Begin = MBB.begin(); !ReachedBegin;) {
223       // Select this instruction.
224       MachineInstr &MI = *MII;
225 
226       // And have our iterator point to the next instruction, if there is one.
227       if (MII == Begin)
228         ReachedBegin = true;
229       else
230         --MII;
231       if (MI.getOpcode() != TargetOpcode::COPY)
232         continue;
233       Register SrcReg = MI.getOperand(1).getReg();
234       Register DstReg = MI.getOperand(0).getReg();
235       if (Register::isVirtualRegister(SrcReg) &&
236           Register::isVirtualRegister(DstReg)) {
237         auto SrcRC = MRI.getRegClass(SrcReg);
238         auto DstRC = MRI.getRegClass(DstReg);
239         if (SrcRC == DstRC) {
240           MRI.replaceRegWith(DstReg, SrcReg);
241           MI.eraseFromParent();
242         }
243       }
244     }
245   }
246 
247 #ifndef NDEBUG
248   const TargetRegisterInfo &TRI = *MF.getSubtarget().getRegisterInfo();
249   // Now that selection is complete, there are no more generic vregs.  Verify
250   // that the size of the now-constrained vreg is unchanged and that it has a
251   // register class.
252   for (unsigned I = 0, E = MRI.getNumVirtRegs(); I != E; ++I) {
253     unsigned VReg = Register::index2VirtReg(I);
254 
255     MachineInstr *MI = nullptr;
256     if (!MRI.def_empty(VReg))
257       MI = &*MRI.def_instr_begin(VReg);
258     else if (!MRI.use_empty(VReg))
259       MI = &*MRI.use_instr_begin(VReg);
260     if (!MI)
261       continue;
262 
263     const TargetRegisterClass *RC = MRI.getRegClassOrNull(VReg);
264     if (!RC) {
265       reportGISelFailure(MF, TPC, MORE, "gisel-select",
266                          "VReg has no regclass after selection", *MI);
267       return false;
268     }
269 
270     const LLT Ty = MRI.getType(VReg);
271     if (Ty.isValid() && Ty.getSizeInBits() > TRI.getRegSizeInBits(*RC)) {
272       reportGISelFailure(
273           MF, TPC, MORE, "gisel-select",
274           "VReg's low-level type and register class have different sizes", *MI);
275       return false;
276     }
277   }
278 
279   if (MF.size() != NumBlocks) {
280     MachineOptimizationRemarkMissed R("gisel-select", "GISelFailure",
281                                       MF.getFunction().getSubprogram(),
282                                       /*MBB=*/nullptr);
283     R << "inserting blocks is not supported yet";
284     reportGISelFailure(MF, TPC, MORE, R);
285     return false;
286   }
287 #endif
288   // Determine if there are any calls in this machine function. Ported from
289   // SelectionDAG.
290   MachineFrameInfo &MFI = MF.getFrameInfo();
291   for (const auto &MBB : MF) {
292     if (MFI.hasCalls() && MF.hasInlineAsm())
293       break;
294 
295     for (const auto &MI : MBB) {
296       if ((MI.isCall() && !MI.isReturn()) || MI.isStackAligningInlineAsm())
297         MFI.setHasCalls(true);
298       if (MI.isInlineAsm())
299         MF.setHasInlineAsm(true);
300     }
301   }
302 
303   // FIXME: FinalizeISel pass calls finalizeLowering, so it's called twice.
304   auto &TLI = *MF.getSubtarget().getTargetLowering();
305   TLI.finalizeLowering(MF);
306 
307   LLVM_DEBUG({
308     dbgs() << "Rules covered by selecting function: " << MF.getName() << ":";
309     for (auto RuleID : CoverageInfo.covered())
310       dbgs() << " id" << RuleID;
311     dbgs() << "\n\n";
312   });
313   CoverageInfo.emit(CoveragePrefix,
314                     TLI.getTargetMachine().getTarget().getBackendName());
315 
316   // If we successfully selected the function nothing is going to use the vreg
317   // types after us (otherwise MIRPrinter would need them). Make sure the types
318   // disappear.
319   MRI.clearVirtRegTypes();
320 
321   // FIXME: Should we accurately track changes?
322   return true;
323 }
324