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