xref: /llvm-project/llvm/lib/Target/WebAssembly/WebAssemblyCFGStackify.cpp (revision 1aaa481fc1f8ad45d36e7e9e9340d22790a7c739)
1 //===-- WebAssemblyCFGStackify.cpp - CFG Stackification -------------------===//
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 ///
9 /// \file
10 /// This file implements a CFG stacking pass.
11 ///
12 /// This pass inserts BLOCK, LOOP, and TRY markers to mark the start of scopes,
13 /// since scope boundaries serve as the labels for WebAssembly's control
14 /// transfers.
15 ///
16 /// This is sufficient to convert arbitrary CFGs into a form that works on
17 /// WebAssembly, provided that all loops are single-entry.
18 ///
19 /// In case we use exceptions, this pass also fixes mismatches in unwind
20 /// destinations created during transforming CFG into wasm structured format.
21 ///
22 //===----------------------------------------------------------------------===//
23 
24 #include "MCTargetDesc/WebAssemblyMCTargetDesc.h"
25 #include "WebAssembly.h"
26 #include "WebAssemblyExceptionInfo.h"
27 #include "WebAssemblyMachineFunctionInfo.h"
28 #include "WebAssemblySubtarget.h"
29 #include "WebAssemblyUtilities.h"
30 #include "llvm/CodeGen/MachineDominators.h"
31 #include "llvm/CodeGen/MachineFunction.h"
32 #include "llvm/CodeGen/MachineInstrBuilder.h"
33 #include "llvm/CodeGen/MachineLoopInfo.h"
34 #include "llvm/CodeGen/MachineRegisterInfo.h"
35 #include "llvm/CodeGen/Passes.h"
36 #include "llvm/CodeGen/WasmEHFuncInfo.h"
37 #include "llvm/MC/MCAsmInfo.h"
38 #include "llvm/Support/Debug.h"
39 #include "llvm/Support/raw_ostream.h"
40 #include <cstring>
41 using namespace llvm;
42 
43 #define DEBUG_TYPE "wasm-cfg-stackify"
44 
45 namespace {
46 class WebAssemblyCFGStackify final : public MachineFunctionPass {
47   StringRef getPassName() const override { return "WebAssembly CFG Stackify"; }
48 
49   void getAnalysisUsage(AnalysisUsage &AU) const override {
50     AU.addRequired<MachineDominatorTree>();
51     AU.addRequired<MachineLoopInfo>();
52     AU.addRequired<WebAssemblyExceptionInfo>();
53     MachineFunctionPass::getAnalysisUsage(AU);
54   }
55 
56   bool runOnMachineFunction(MachineFunction &MF) override;
57 
58   // For each block whose label represents the end of a scope, record the block
59   // which holds the beginning of the scope. This will allow us to quickly skip
60   // over scoped regions when walking blocks.
61   SmallVector<MachineBasicBlock *, 8> ScopeTops;
62 
63   void placeMarkers(MachineFunction &MF);
64   void placeBlockMarker(MachineBasicBlock &MBB);
65   void placeLoopMarker(MachineBasicBlock &MBB);
66   void placeTryMarker(MachineBasicBlock &MBB);
67   void removeUnnecessaryInstrs(MachineFunction &MF);
68   void rewriteDepthImmediates(MachineFunction &MF);
69   void fixEndsAtEndOfFunction(MachineFunction &MF);
70 
71   // For each BLOCK|LOOP|TRY, the corresponding END_(BLOCK|LOOP|TRY).
72   DenseMap<const MachineInstr *, MachineInstr *> BeginToEnd;
73   // For each END_(BLOCK|LOOP|TRY), the corresponding BLOCK|LOOP|TRY.
74   DenseMap<const MachineInstr *, MachineInstr *> EndToBegin;
75   // <TRY marker, EH pad> map
76   DenseMap<const MachineInstr *, MachineBasicBlock *> TryToEHPad;
77   // <EH pad, TRY marker> map
78   DenseMap<const MachineBasicBlock *, MachineInstr *> EHPadToTry;
79 
80   // Helper functions to register / unregister scope information created by
81   // marker instructions.
82   void registerScope(MachineInstr *Begin, MachineInstr *End);
83   void registerTryScope(MachineInstr *Begin, MachineInstr *End,
84                         MachineBasicBlock *EHPad);
85   void unregisterScope(MachineInstr *Begin);
86 
87 public:
88   static char ID; // Pass identification, replacement for typeid
89   WebAssemblyCFGStackify() : MachineFunctionPass(ID) {}
90   ~WebAssemblyCFGStackify() override { releaseMemory(); }
91   void releaseMemory() override;
92 };
93 } // end anonymous namespace
94 
95 char WebAssemblyCFGStackify::ID = 0;
96 INITIALIZE_PASS(WebAssemblyCFGStackify, DEBUG_TYPE,
97                 "Insert BLOCK and LOOP markers for WebAssembly scopes", false,
98                 false)
99 
100 FunctionPass *llvm::createWebAssemblyCFGStackify() {
101   return new WebAssemblyCFGStackify();
102 }
103 
104 /// Test whether Pred has any terminators explicitly branching to MBB, as
105 /// opposed to falling through. Note that it's possible (eg. in unoptimized
106 /// code) for a branch instruction to both branch to a block and fallthrough
107 /// to it, so we check the actual branch operands to see if there are any
108 /// explicit mentions.
109 static bool explicitlyBranchesTo(MachineBasicBlock *Pred,
110                                  MachineBasicBlock *MBB) {
111   for (MachineInstr &MI : Pred->terminators())
112     for (MachineOperand &MO : MI.explicit_operands())
113       if (MO.isMBB() && MO.getMBB() == MBB)
114         return true;
115   return false;
116 }
117 
118 // Returns an iterator to the earliest position possible within the MBB,
119 // satisfying the restrictions given by BeforeSet and AfterSet. BeforeSet
120 // contains instructions that should go before the marker, and AfterSet contains
121 // ones that should go after the marker. In this function, AfterSet is only
122 // used for sanity checking.
123 static MachineBasicBlock::iterator
124 getEarliestInsertPos(MachineBasicBlock *MBB,
125                      const SmallPtrSet<const MachineInstr *, 4> &BeforeSet,
126                      const SmallPtrSet<const MachineInstr *, 4> &AfterSet) {
127   auto InsertPos = MBB->end();
128   while (InsertPos != MBB->begin()) {
129     if (BeforeSet.count(&*std::prev(InsertPos))) {
130 #ifndef NDEBUG
131       // Sanity check
132       for (auto Pos = InsertPos, E = MBB->begin(); Pos != E; --Pos)
133         assert(!AfterSet.count(&*std::prev(Pos)));
134 #endif
135       break;
136     }
137     --InsertPos;
138   }
139   return InsertPos;
140 }
141 
142 // Returns an iterator to the latest position possible within the MBB,
143 // satisfying the restrictions given by BeforeSet and AfterSet. BeforeSet
144 // contains instructions that should go before the marker, and AfterSet contains
145 // ones that should go after the marker. In this function, BeforeSet is only
146 // used for sanity checking.
147 static MachineBasicBlock::iterator
148 getLatestInsertPos(MachineBasicBlock *MBB,
149                    const SmallPtrSet<const MachineInstr *, 4> &BeforeSet,
150                    const SmallPtrSet<const MachineInstr *, 4> &AfterSet) {
151   auto InsertPos = MBB->begin();
152   while (InsertPos != MBB->end()) {
153     if (AfterSet.count(&*InsertPos)) {
154 #ifndef NDEBUG
155       // Sanity check
156       for (auto Pos = InsertPos, E = MBB->end(); Pos != E; ++Pos)
157         assert(!BeforeSet.count(&*Pos));
158 #endif
159       break;
160     }
161     ++InsertPos;
162   }
163   return InsertPos;
164 }
165 
166 void WebAssemblyCFGStackify::registerScope(MachineInstr *Begin,
167                                            MachineInstr *End) {
168   BeginToEnd[Begin] = End;
169   EndToBegin[End] = Begin;
170 }
171 
172 void WebAssemblyCFGStackify::registerTryScope(MachineInstr *Begin,
173                                               MachineInstr *End,
174                                               MachineBasicBlock *EHPad) {
175   registerScope(Begin, End);
176   TryToEHPad[Begin] = EHPad;
177   EHPadToTry[EHPad] = Begin;
178 }
179 
180 void WebAssemblyCFGStackify::unregisterScope(MachineInstr *Begin) {
181   assert(BeginToEnd.count(Begin));
182   MachineInstr *End = BeginToEnd[Begin];
183   assert(EndToBegin.count(End));
184   BeginToEnd.erase(Begin);
185   EndToBegin.erase(End);
186   MachineBasicBlock *EHPad = TryToEHPad.lookup(Begin);
187   if (EHPad) {
188     assert(EHPadToTry.count(EHPad));
189     TryToEHPad.erase(Begin);
190     EHPadToTry.erase(EHPad);
191   }
192 }
193 
194 /// Insert a BLOCK marker for branches to MBB (if needed).
195 void WebAssemblyCFGStackify::placeBlockMarker(MachineBasicBlock &MBB) {
196   assert(!MBB.isEHPad());
197   MachineFunction &MF = *MBB.getParent();
198   auto &MDT = getAnalysis<MachineDominatorTree>();
199   const auto &TII = *MF.getSubtarget<WebAssemblySubtarget>().getInstrInfo();
200   const auto &MFI = *MF.getInfo<WebAssemblyFunctionInfo>();
201 
202   // First compute the nearest common dominator of all forward non-fallthrough
203   // predecessors so that we minimize the time that the BLOCK is on the stack,
204   // which reduces overall stack height.
205   MachineBasicBlock *Header = nullptr;
206   bool IsBranchedTo = false;
207   bool IsBrOnExn = false;
208   MachineInstr *BrOnExn = nullptr;
209   int MBBNumber = MBB.getNumber();
210   for (MachineBasicBlock *Pred : MBB.predecessors()) {
211     if (Pred->getNumber() < MBBNumber) {
212       Header = Header ? MDT.findNearestCommonDominator(Header, Pred) : Pred;
213       if (explicitlyBranchesTo(Pred, &MBB)) {
214         IsBranchedTo = true;
215         if (Pred->getFirstTerminator()->getOpcode() == WebAssembly::BR_ON_EXN) {
216           IsBrOnExn = true;
217           assert(!BrOnExn && "There should be only one br_on_exn per block");
218           BrOnExn = &*Pred->getFirstTerminator();
219         }
220       }
221     }
222   }
223   if (!Header)
224     return;
225   if (!IsBranchedTo)
226     return;
227 
228   assert(&MBB != &MF.front() && "Header blocks shouldn't have predecessors");
229   MachineBasicBlock *LayoutPred = MBB.getPrevNode();
230 
231   // If the nearest common dominator is inside a more deeply nested context,
232   // walk out to the nearest scope which isn't more deeply nested.
233   for (MachineFunction::iterator I(LayoutPred), E(Header); I != E; --I) {
234     if (MachineBasicBlock *ScopeTop = ScopeTops[I->getNumber()]) {
235       if (ScopeTop->getNumber() > Header->getNumber()) {
236         // Skip over an intervening scope.
237         I = std::next(ScopeTop->getIterator());
238       } else {
239         // We found a scope level at an appropriate depth.
240         Header = ScopeTop;
241         break;
242       }
243     }
244   }
245 
246   // Decide where in Header to put the BLOCK.
247 
248   // Instructions that should go before the BLOCK.
249   SmallPtrSet<const MachineInstr *, 4> BeforeSet;
250   // Instructions that should go after the BLOCK.
251   SmallPtrSet<const MachineInstr *, 4> AfterSet;
252   for (const auto &MI : *Header) {
253     // If there is a previously placed LOOP marker and the bottom block of the
254     // loop is above MBB, it should be after the BLOCK, because the loop is
255     // nested in this BLOCK. Otherwise it should be before the BLOCK.
256     if (MI.getOpcode() == WebAssembly::LOOP) {
257       auto *LoopBottom = BeginToEnd[&MI]->getParent()->getPrevNode();
258       if (MBB.getNumber() > LoopBottom->getNumber())
259         AfterSet.insert(&MI);
260 #ifndef NDEBUG
261       else
262         BeforeSet.insert(&MI);
263 #endif
264     }
265 
266     // All previously inserted BLOCK/TRY markers should be after the BLOCK
267     // because they are all nested blocks.
268     if (MI.getOpcode() == WebAssembly::BLOCK ||
269         MI.getOpcode() == WebAssembly::TRY)
270       AfterSet.insert(&MI);
271 
272 #ifndef NDEBUG
273     // All END_(BLOCK|LOOP|TRY) markers should be before the BLOCK.
274     if (MI.getOpcode() == WebAssembly::END_BLOCK ||
275         MI.getOpcode() == WebAssembly::END_LOOP ||
276         MI.getOpcode() == WebAssembly::END_TRY)
277       BeforeSet.insert(&MI);
278 #endif
279 
280     // Terminators should go after the BLOCK.
281     if (MI.isTerminator())
282       AfterSet.insert(&MI);
283   }
284 
285   // Local expression tree should go after the BLOCK.
286   for (auto I = Header->getFirstTerminator(), E = Header->begin(); I != E;
287        --I) {
288     if (std::prev(I)->isDebugInstr() || std::prev(I)->isPosition())
289       continue;
290     if (WebAssembly::isChild(*std::prev(I), MFI))
291       AfterSet.insert(&*std::prev(I));
292     else
293       break;
294   }
295 
296   // Add the BLOCK.
297 
298   // 'br_on_exn' extracts except_ref object and pushes variable number of values
299   // depending on its tag. For C++ exception, its a single i32 value, and the
300   // generated code will be in the form of:
301   // block i32
302   //   br_on_exn 0, $__cpp_exception
303   //   rethrow
304   // end_block
305   WebAssembly::ExprType ReturnType = WebAssembly::ExprType::Void;
306   if (IsBrOnExn) {
307     const char *TagName = BrOnExn->getOperand(1).getSymbolName();
308     if (std::strcmp(TagName, "__cpp_exception") != 0)
309       llvm_unreachable("Only C++ exception is supported");
310     ReturnType = WebAssembly::ExprType::I32;
311   }
312 
313   auto InsertPos = getLatestInsertPos(Header, BeforeSet, AfterSet);
314   MachineInstr *Begin =
315       BuildMI(*Header, InsertPos, Header->findDebugLoc(InsertPos),
316               TII.get(WebAssembly::BLOCK))
317           .addImm(int64_t(ReturnType));
318 
319   // Decide where in Header to put the END_BLOCK.
320   BeforeSet.clear();
321   AfterSet.clear();
322   for (auto &MI : MBB) {
323 #ifndef NDEBUG
324     // END_BLOCK should precede existing LOOP and TRY markers.
325     if (MI.getOpcode() == WebAssembly::LOOP ||
326         MI.getOpcode() == WebAssembly::TRY)
327       AfterSet.insert(&MI);
328 #endif
329 
330     // If there is a previously placed END_LOOP marker and the header of the
331     // loop is above this block's header, the END_LOOP should be placed after
332     // the BLOCK, because the loop contains this block. Otherwise the END_LOOP
333     // should be placed before the BLOCK. The same for END_TRY.
334     if (MI.getOpcode() == WebAssembly::END_LOOP ||
335         MI.getOpcode() == WebAssembly::END_TRY) {
336       if (EndToBegin[&MI]->getParent()->getNumber() >= Header->getNumber())
337         BeforeSet.insert(&MI);
338 #ifndef NDEBUG
339       else
340         AfterSet.insert(&MI);
341 #endif
342     }
343   }
344 
345   // Mark the end of the block.
346   InsertPos = getEarliestInsertPos(&MBB, BeforeSet, AfterSet);
347   MachineInstr *End = BuildMI(MBB, InsertPos, MBB.findPrevDebugLoc(InsertPos),
348                               TII.get(WebAssembly::END_BLOCK));
349   registerScope(Begin, End);
350 
351   // Track the farthest-spanning scope that ends at this point.
352   int Number = MBB.getNumber();
353   if (!ScopeTops[Number] ||
354       ScopeTops[Number]->getNumber() > Header->getNumber())
355     ScopeTops[Number] = Header;
356 }
357 
358 /// Insert a LOOP marker for a loop starting at MBB (if it's a loop header).
359 void WebAssemblyCFGStackify::placeLoopMarker(MachineBasicBlock &MBB) {
360   MachineFunction &MF = *MBB.getParent();
361   const auto &MLI = getAnalysis<MachineLoopInfo>();
362   const auto &TII = *MF.getSubtarget<WebAssemblySubtarget>().getInstrInfo();
363 
364   MachineLoop *Loop = MLI.getLoopFor(&MBB);
365   if (!Loop || Loop->getHeader() != &MBB)
366     return;
367 
368   // The operand of a LOOP is the first block after the loop. If the loop is the
369   // bottom of the function, insert a dummy block at the end.
370   MachineBasicBlock *Bottom = WebAssembly::getBottom(Loop);
371   auto Iter = std::next(Bottom->getIterator());
372   if (Iter == MF.end()) {
373     MachineBasicBlock *Label = MF.CreateMachineBasicBlock();
374     // Give it a fake predecessor so that AsmPrinter prints its label.
375     Label->addSuccessor(Label);
376     MF.push_back(Label);
377     Iter = std::next(Bottom->getIterator());
378   }
379   MachineBasicBlock *AfterLoop = &*Iter;
380 
381   // Decide where in Header to put the LOOP.
382   SmallPtrSet<const MachineInstr *, 4> BeforeSet;
383   SmallPtrSet<const MachineInstr *, 4> AfterSet;
384   for (const auto &MI : MBB) {
385     // LOOP marker should be after any existing loop that ends here. Otherwise
386     // we assume the instruction belongs to the loop.
387     if (MI.getOpcode() == WebAssembly::END_LOOP)
388       BeforeSet.insert(&MI);
389 #ifndef NDEBUG
390     else
391       AfterSet.insert(&MI);
392 #endif
393   }
394 
395   // Mark the beginning of the loop.
396   auto InsertPos = getEarliestInsertPos(&MBB, BeforeSet, AfterSet);
397   MachineInstr *Begin = BuildMI(MBB, InsertPos, MBB.findDebugLoc(InsertPos),
398                                 TII.get(WebAssembly::LOOP))
399                             .addImm(int64_t(WebAssembly::ExprType::Void));
400 
401   // Decide where in Header to put the END_LOOP.
402   BeforeSet.clear();
403   AfterSet.clear();
404 #ifndef NDEBUG
405   for (const auto &MI : MBB)
406     // Existing END_LOOP markers belong to parent loops of this loop
407     if (MI.getOpcode() == WebAssembly::END_LOOP)
408       AfterSet.insert(&MI);
409 #endif
410 
411   // Mark the end of the loop (using arbitrary debug location that branched to
412   // the loop end as its location).
413   InsertPos = getEarliestInsertPos(AfterLoop, BeforeSet, AfterSet);
414   DebugLoc EndDL = (*AfterLoop->pred_rbegin())->findBranchDebugLoc();
415   MachineInstr *End =
416       BuildMI(*AfterLoop, InsertPos, EndDL, TII.get(WebAssembly::END_LOOP));
417   registerScope(Begin, End);
418 
419   assert((!ScopeTops[AfterLoop->getNumber()] ||
420           ScopeTops[AfterLoop->getNumber()]->getNumber() < MBB.getNumber()) &&
421          "With block sorting the outermost loop for a block should be first.");
422   if (!ScopeTops[AfterLoop->getNumber()])
423     ScopeTops[AfterLoop->getNumber()] = &MBB;
424 }
425 
426 void WebAssemblyCFGStackify::placeTryMarker(MachineBasicBlock &MBB) {
427   assert(MBB.isEHPad());
428   MachineFunction &MF = *MBB.getParent();
429   auto &MDT = getAnalysis<MachineDominatorTree>();
430   const auto &TII = *MF.getSubtarget<WebAssemblySubtarget>().getInstrInfo();
431   const auto &WEI = getAnalysis<WebAssemblyExceptionInfo>();
432   const auto &MFI = *MF.getInfo<WebAssemblyFunctionInfo>();
433 
434   // Compute the nearest common dominator of all unwind predecessors
435   MachineBasicBlock *Header = nullptr;
436   int MBBNumber = MBB.getNumber();
437   for (auto *Pred : MBB.predecessors()) {
438     if (Pred->getNumber() < MBBNumber) {
439       Header = Header ? MDT.findNearestCommonDominator(Header, Pred) : Pred;
440       assert(!explicitlyBranchesTo(Pred, &MBB) &&
441              "Explicit branch to an EH pad!");
442     }
443   }
444   if (!Header)
445     return;
446 
447   // If this try is at the bottom of the function, insert a dummy block at the
448   // end.
449   WebAssemblyException *WE = WEI.getExceptionFor(&MBB);
450   assert(WE);
451   MachineBasicBlock *Bottom = WebAssembly::getBottom(WE);
452 
453   auto Iter = std::next(Bottom->getIterator());
454   if (Iter == MF.end()) {
455     MachineBasicBlock *Label = MF.CreateMachineBasicBlock();
456     // Give it a fake predecessor so that AsmPrinter prints its label.
457     Label->addSuccessor(Label);
458     MF.push_back(Label);
459     Iter = std::next(Bottom->getIterator());
460   }
461   MachineBasicBlock *Cont = &*Iter;
462 
463   assert(Cont != &MF.front());
464   MachineBasicBlock *LayoutPred = Cont->getPrevNode();
465 
466   // If the nearest common dominator is inside a more deeply nested context,
467   // walk out to the nearest scope which isn't more deeply nested.
468   for (MachineFunction::iterator I(LayoutPred), E(Header); I != E; --I) {
469     if (MachineBasicBlock *ScopeTop = ScopeTops[I->getNumber()]) {
470       if (ScopeTop->getNumber() > Header->getNumber()) {
471         // Skip over an intervening scope.
472         I = std::next(ScopeTop->getIterator());
473       } else {
474         // We found a scope level at an appropriate depth.
475         Header = ScopeTop;
476         break;
477       }
478     }
479   }
480 
481   // Decide where in Header to put the TRY.
482 
483   // Instructions that should go before the TRY.
484   SmallPtrSet<const MachineInstr *, 4> BeforeSet;
485   // Instructions that should go after the TRY.
486   SmallPtrSet<const MachineInstr *, 4> AfterSet;
487   for (const auto &MI : *Header) {
488     // If there is a previously placed LOOP marker and the bottom block of the
489     // loop is above MBB, it should be after the TRY, because the loop is nested
490     // in this TRY. Otherwise it should be before the TRY.
491     if (MI.getOpcode() == WebAssembly::LOOP) {
492       auto *LoopBottom = BeginToEnd[&MI]->getParent()->getPrevNode();
493       if (MBB.getNumber() > LoopBottom->getNumber())
494         AfterSet.insert(&MI);
495 #ifndef NDEBUG
496       else
497         BeforeSet.insert(&MI);
498 #endif
499     }
500 
501     // All previously inserted BLOCK/TRY markers should be after the TRY because
502     // they are all nested trys.
503     if (MI.getOpcode() == WebAssembly::BLOCK ||
504         MI.getOpcode() == WebAssembly::TRY)
505       AfterSet.insert(&MI);
506 
507 #ifndef NDEBUG
508     // All END_(BLOCK/LOOP/TRY) markers should be before the TRY.
509     if (MI.getOpcode() == WebAssembly::END_BLOCK ||
510         MI.getOpcode() == WebAssembly::END_LOOP ||
511         MI.getOpcode() == WebAssembly::END_TRY)
512       BeforeSet.insert(&MI);
513 #endif
514 
515     // Terminators should go after the TRY.
516     if (MI.isTerminator())
517       AfterSet.insert(&MI);
518   }
519 
520   // Local expression tree should go after the TRY.
521   for (auto I = Header->getFirstTerminator(), E = Header->begin(); I != E;
522        --I) {
523     if (std::prev(I)->isDebugInstr() || std::prev(I)->isPosition())
524       continue;
525     if (WebAssembly::isChild(*std::prev(I), MFI))
526       AfterSet.insert(&*std::prev(I));
527     else
528       break;
529   }
530 
531   // If Header unwinds to MBB (= Header contains 'invoke'), the try block should
532   // contain the call within it. So the call should go after the TRY. The
533   // exception is when the header's terminator is a rethrow instruction, in
534   // which case that instruction, not a call instruction before it, is gonna
535   // throw.
536   if (MBB.isPredecessor(Header)) {
537     auto TermPos = Header->getFirstTerminator();
538     if (TermPos == Header->end() ||
539         TermPos->getOpcode() != WebAssembly::RETHROW) {
540       for (const auto &MI : reverse(*Header)) {
541         if (MI.isCall()) {
542           AfterSet.insert(&MI);
543           // Possibly throwing calls are usually wrapped by EH_LABEL
544           // instructions. We don't want to split them and the call.
545           if (MI.getIterator() != Header->begin() &&
546               std::prev(MI.getIterator())->isEHLabel())
547             AfterSet.insert(&*std::prev(MI.getIterator()));
548           break;
549         }
550       }
551     }
552   }
553 
554   // Add the TRY.
555   auto InsertPos = getLatestInsertPos(Header, BeforeSet, AfterSet);
556   MachineInstr *Begin =
557       BuildMI(*Header, InsertPos, Header->findDebugLoc(InsertPos),
558               TII.get(WebAssembly::TRY))
559           .addImm(int64_t(WebAssembly::ExprType::Void));
560 
561   // Decide where in Header to put the END_TRY.
562   BeforeSet.clear();
563   AfterSet.clear();
564   for (const auto &MI : *Cont) {
565 #ifndef NDEBUG
566     // END_TRY should precede existing LOOP and BLOCK markers.
567     if (MI.getOpcode() == WebAssembly::LOOP ||
568         MI.getOpcode() == WebAssembly::BLOCK)
569       AfterSet.insert(&MI);
570 
571     // All END_TRY markers placed earlier belong to exceptions that contains
572     // this one.
573     if (MI.getOpcode() == WebAssembly::END_TRY)
574       AfterSet.insert(&MI);
575 #endif
576 
577     // If there is a previously placed END_LOOP marker and its header is after
578     // where TRY marker is, this loop is contained within the 'catch' part, so
579     // the END_TRY marker should go after that. Otherwise, the whole try-catch
580     // is contained within this loop, so the END_TRY should go before that.
581     if (MI.getOpcode() == WebAssembly::END_LOOP) {
582       // For a LOOP to be after TRY, LOOP's BB should be after TRY's BB; if they
583       // are in the same BB, LOOP is always before TRY.
584       if (EndToBegin[&MI]->getParent()->getNumber() > Header->getNumber())
585         BeforeSet.insert(&MI);
586 #ifndef NDEBUG
587       else
588         AfterSet.insert(&MI);
589 #endif
590     }
591 
592     // It is not possible for an END_BLOCK to be already in this block.
593   }
594 
595   // Mark the end of the TRY.
596   InsertPos = getEarliestInsertPos(Cont, BeforeSet, AfterSet);
597   MachineInstr *End =
598       BuildMI(*Cont, InsertPos, Bottom->findBranchDebugLoc(),
599               TII.get(WebAssembly::END_TRY));
600   registerTryScope(Begin, End, &MBB);
601 
602   // Track the farthest-spanning scope that ends at this point. We create two
603   // mappings: (BB with 'end_try' -> BB with 'try') and (BB with 'catch' -> BB
604   // with 'try'). We need to create 'catch' -> 'try' mapping here too because
605   // markers should not span across 'catch'. For example, this should not
606   // happen:
607   //
608   // try
609   //   block     --|  (X)
610   // catch         |
611   //   end_block --|
612   // end_try
613   for (int Number : {Cont->getNumber(), MBB.getNumber()}) {
614     if (!ScopeTops[Number] ||
615         ScopeTops[Number]->getNumber() > Header->getNumber())
616       ScopeTops[Number] = Header;
617   }
618 }
619 
620 void WebAssemblyCFGStackify::removeUnnecessaryInstrs(MachineFunction &MF) {
621   const auto &TII = *MF.getSubtarget<WebAssemblySubtarget>().getInstrInfo();
622 
623   // When there is an unconditional branch right before a catch instruction and
624   // it branches to the end of end_try marker, we don't need the branch, because
625   // it there is no exception, the control flow transfers to that point anyway.
626   // bb0:
627   //   try
628   //     ...
629   //     br bb2      <- Not necessary
630   // bb1:
631   //   catch
632   //     ...
633   // bb2:
634   //   end
635   for (auto &MBB : MF) {
636     if (!MBB.isEHPad())
637       continue;
638 
639     MachineBasicBlock *TBB = nullptr, *FBB = nullptr;
640     SmallVector<MachineOperand, 4> Cond;
641     MachineBasicBlock *EHPadLayoutPred = MBB.getPrevNode();
642     MachineBasicBlock *Cont = BeginToEnd[EHPadToTry[&MBB]]->getParent();
643     bool Analyzable = !TII.analyzeBranch(*EHPadLayoutPred, TBB, FBB, Cond);
644     if (Analyzable && ((Cond.empty() && TBB && TBB == Cont) ||
645                        (!Cond.empty() && FBB && FBB == Cont)))
646       TII.removeBranch(*EHPadLayoutPred);
647   }
648 
649   // When there are block / end_block markers that overlap with try / end_try
650   // markers, and the block and try markers' return types are the same, the
651   // block /end_block markers are not necessary, because try / end_try markers
652   // also can serve as boundaries for branches.
653   // block         <- Not necessary
654   //   try
655   //     ...
656   //   catch
657   //     ...
658   //   end
659   // end           <- Not necessary
660   SmallVector<MachineInstr *, 32> ToDelete;
661   for (auto &MBB : MF) {
662     for (auto &MI : MBB) {
663       if (MI.getOpcode() != WebAssembly::TRY)
664         continue;
665 
666       MachineInstr *Try = &MI, *EndTry = BeginToEnd[Try];
667       MachineBasicBlock *TryBB = Try->getParent();
668       MachineBasicBlock *Cont = EndTry->getParent();
669       int64_t RetType = Try->getOperand(0).getImm();
670       for (auto B = Try->getIterator(), E = std::next(EndTry->getIterator());
671            B != TryBB->begin() && E != Cont->end() &&
672            std::prev(B)->getOpcode() == WebAssembly::BLOCK &&
673            E->getOpcode() == WebAssembly::END_BLOCK &&
674            std::prev(B)->getOperand(0).getImm() == RetType;
675            --B, ++E) {
676         ToDelete.push_back(&*std::prev(B));
677         ToDelete.push_back(&*E);
678       }
679     }
680   }
681   for (auto *MI : ToDelete) {
682     if (MI->getOpcode() == WebAssembly::BLOCK)
683       unregisterScope(MI);
684     MI->eraseFromParent();
685   }
686 }
687 
688 static unsigned
689 getDepth(const SmallVectorImpl<const MachineBasicBlock *> &Stack,
690          const MachineBasicBlock *MBB) {
691   unsigned Depth = 0;
692   for (auto X : reverse(Stack)) {
693     if (X == MBB)
694       break;
695     ++Depth;
696   }
697   assert(Depth < Stack.size() && "Branch destination should be in scope");
698   return Depth;
699 }
700 
701 /// In normal assembly languages, when the end of a function is unreachable,
702 /// because the function ends in an infinite loop or a noreturn call or similar,
703 /// it isn't necessary to worry about the function return type at the end of
704 /// the function, because it's never reached. However, in WebAssembly, blocks
705 /// that end at the function end need to have a return type signature that
706 /// matches the function signature, even though it's unreachable. This function
707 /// checks for such cases and fixes up the signatures.
708 void WebAssemblyCFGStackify::fixEndsAtEndOfFunction(MachineFunction &MF) {
709   const auto &MFI = *MF.getInfo<WebAssemblyFunctionInfo>();
710   assert(MFI.getResults().size() <= 1);
711 
712   if (MFI.getResults().empty())
713     return;
714 
715   WebAssembly::ExprType RetType;
716   switch (MFI.getResults().front().SimpleTy) {
717   case MVT::i32:
718     RetType = WebAssembly::ExprType::I32;
719     break;
720   case MVT::i64:
721     RetType = WebAssembly::ExprType::I64;
722     break;
723   case MVT::f32:
724     RetType = WebAssembly::ExprType::F32;
725     break;
726   case MVT::f64:
727     RetType = WebAssembly::ExprType::F64;
728     break;
729   case MVT::v16i8:
730   case MVT::v8i16:
731   case MVT::v4i32:
732   case MVT::v2i64:
733   case MVT::v4f32:
734   case MVT::v2f64:
735     RetType = WebAssembly::ExprType::V128;
736     break;
737   case MVT::ExceptRef:
738     RetType = WebAssembly::ExprType::ExceptRef;
739     break;
740   default:
741     llvm_unreachable("unexpected return type");
742   }
743 
744   for (MachineBasicBlock &MBB : reverse(MF)) {
745     for (MachineInstr &MI : reverse(MBB)) {
746       if (MI.isPosition() || MI.isDebugInstr())
747         continue;
748       if (MI.getOpcode() == WebAssembly::END_BLOCK) {
749         EndToBegin[&MI]->getOperand(0).setImm(int32_t(RetType));
750         continue;
751       }
752       if (MI.getOpcode() == WebAssembly::END_LOOP) {
753         EndToBegin[&MI]->getOperand(0).setImm(int32_t(RetType));
754         continue;
755       }
756       // Something other than an `end`. We're done.
757       return;
758     }
759   }
760 }
761 
762 // WebAssembly functions end with an end instruction, as if the function body
763 // were a block.
764 static void appendEndToFunction(MachineFunction &MF,
765                                 const WebAssemblyInstrInfo &TII) {
766   BuildMI(MF.back(), MF.back().end(),
767           MF.back().findPrevDebugLoc(MF.back().end()),
768           TII.get(WebAssembly::END_FUNCTION));
769 }
770 
771 /// Insert LOOP/TRY/BLOCK markers at appropriate places.
772 void WebAssemblyCFGStackify::placeMarkers(MachineFunction &MF) {
773   // We allocate one more than the number of blocks in the function to
774   // accommodate for the possible fake block we may insert at the end.
775   ScopeTops.resize(MF.getNumBlockIDs() + 1);
776   // Place the LOOP for MBB if MBB is the header of a loop.
777   for (auto &MBB : MF)
778     placeLoopMarker(MBB);
779 
780   const MCAsmInfo *MCAI = MF.getTarget().getMCAsmInfo();
781   for (auto &MBB : MF) {
782     if (MBB.isEHPad()) {
783       // Place the TRY for MBB if MBB is the EH pad of an exception.
784       if (MCAI->getExceptionHandlingType() == ExceptionHandling::Wasm &&
785           MF.getFunction().hasPersonalityFn())
786         placeTryMarker(MBB);
787     } else {
788       // Place the BLOCK for MBB if MBB is branched to from above.
789       placeBlockMarker(MBB);
790     }
791   }
792 }
793 
794 void WebAssemblyCFGStackify::rewriteDepthImmediates(MachineFunction &MF) {
795   // Now rewrite references to basic blocks to be depth immediates.
796   SmallVector<const MachineBasicBlock *, 8> Stack;
797   for (auto &MBB : reverse(MF)) {
798     for (auto I = MBB.rbegin(), E = MBB.rend(); I != E; ++I) {
799       MachineInstr &MI = *I;
800       switch (MI.getOpcode()) {
801       case WebAssembly::BLOCK:
802       case WebAssembly::TRY:
803         assert(ScopeTops[Stack.back()->getNumber()]->getNumber() <=
804                    MBB.getNumber() &&
805                "Block/try marker should be balanced");
806         Stack.pop_back();
807         break;
808 
809       case WebAssembly::LOOP:
810         assert(Stack.back() == &MBB && "Loop top should be balanced");
811         Stack.pop_back();
812         break;
813 
814       case WebAssembly::END_BLOCK:
815       case WebAssembly::END_TRY:
816         Stack.push_back(&MBB);
817         break;
818 
819       case WebAssembly::END_LOOP:
820         Stack.push_back(EndToBegin[&MI]->getParent());
821         break;
822 
823       default:
824         if (MI.isTerminator()) {
825           // Rewrite MBB operands to be depth immediates.
826           SmallVector<MachineOperand, 4> Ops(MI.operands());
827           while (MI.getNumOperands() > 0)
828             MI.RemoveOperand(MI.getNumOperands() - 1);
829           for (auto MO : Ops) {
830             if (MO.isMBB())
831               MO = MachineOperand::CreateImm(getDepth(Stack, MO.getMBB()));
832             MI.addOperand(MF, MO);
833           }
834         }
835         break;
836       }
837     }
838   }
839   assert(Stack.empty() && "Control flow should be balanced");
840 }
841 
842 void WebAssemblyCFGStackify::releaseMemory() {
843   ScopeTops.clear();
844   BeginToEnd.clear();
845   EndToBegin.clear();
846   TryToEHPad.clear();
847   EHPadToTry.clear();
848 }
849 
850 bool WebAssemblyCFGStackify::runOnMachineFunction(MachineFunction &MF) {
851   LLVM_DEBUG(dbgs() << "********** CFG Stackifying **********\n"
852                        "********** Function: "
853                     << MF.getName() << '\n');
854   const MCAsmInfo *MCAI = MF.getTarget().getMCAsmInfo();
855 
856   releaseMemory();
857 
858   // Liveness is not tracked for VALUE_STACK physreg.
859   MF.getRegInfo().invalidateLiveness();
860 
861   // Place the BLOCK/LOOP/TRY markers to indicate the beginnings of scopes.
862   placeMarkers(MF);
863 
864   if (MCAI->getExceptionHandlingType() == ExceptionHandling::Wasm &&
865       MF.getFunction().hasPersonalityFn())
866     // Remove unnecessary instructions.
867     removeUnnecessaryInstrs(MF);
868 
869   // Convert MBB operands in terminators to relative depth immediates.
870   rewriteDepthImmediates(MF);
871 
872   // Fix up block/loop/try signatures at the end of the function to conform to
873   // WebAssembly's rules.
874   fixEndsAtEndOfFunction(MF);
875 
876   // Add an end instruction at the end of the function body.
877   const auto &TII = *MF.getSubtarget<WebAssemblySubtarget>().getInstrInfo();
878   if (!MF.getSubtarget<WebAssemblySubtarget>()
879            .getTargetTriple()
880            .isOSBinFormatELF())
881     appendEndToFunction(MF, TII);
882 
883   MF.getInfo<WebAssemblyFunctionInfo>()->setCFGStackified();
884   return true;
885 }
886