LLVM 23.0.0git
WebAssemblyTargetMachine.cpp
Go to the documentation of this file.
1//===- WebAssemblyTargetMachine.cpp - Define TargetMachine for WebAssembly -==//
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 defines the WebAssembly-specific subclass of TargetMachine.
11///
12//===----------------------------------------------------------------------===//
13
17#include "WebAssembly.h"
28#include "llvm/CodeGen/Passes.h"
31#include "llvm/IR/Function.h"
39#include <optional>
40using namespace llvm;
41
42#define DEBUG_TYPE "wasm"
43
44// A command-line option to keep implicit locals
45// for the purpose of testing with lit/llc ONLY.
46// This produces output which is not valid WebAssembly, and is not supported
47// by assemblers/disassemblers and other MC based tools.
49 "wasm-disable-explicit-locals", cl::Hidden,
50 cl::desc("WebAssembly: output implicit locals in"
51 " instruction output for test purposes only."),
52 cl::init(false));
53
54// Exception handling & setjmp-longjmp handling related options.
55
56// Emscripten's asm.js-style exception handling
58 "enable-emscripten-cxx-exceptions",
59 cl::desc("WebAssembly Emscripten-style exception handling"),
60 cl::init(false));
61// Emscripten's asm.js-style setjmp/longjmp handling
63 "enable-emscripten-sjlj",
64 cl::desc("WebAssembly Emscripten-style setjmp/longjmp handling"),
65 cl::init(false));
66// Exception handling using wasm EH instructions
68 WebAssembly::WasmEnableEH("wasm-enable-eh",
69 cl::desc("WebAssembly exception handling"));
70// setjmp/longjmp handling using wasm EH instrutions
72 "wasm-enable-sjlj", cl::desc("WebAssembly setjmp/longjmp handling"));
73// If true, use the legacy Wasm EH proposal:
74// https://github.com/WebAssembly/exception-handling/blob/main/proposals/exception-handling/legacy/Exceptions.md
75// And if false, use the standardized Wasm EH proposal:
76// https://github.com/WebAssembly/exception-handling/blob/main/proposals/exception-handling/Exceptions.md
77// Currently set to true by default because not all major web browsers turn on
78// the new standard proposal by default, but will later change to false.
80 "wasm-use-legacy-eh", cl::desc("WebAssembly exception handling (legacy)"),
81 cl::init(true));
82
85 // Register the target.
90
91 // Register backend passes
125}
126
127//===----------------------------------------------------------------------===//
128// WebAssembly Lowering public interface.
129//===----------------------------------------------------------------------===//
130
131static Reloc::Model getEffectiveRelocModel(std::optional<Reloc::Model> RM) {
132 // Default to static relocation model. This should always be more optimial
133 // than PIC since the static linker can determine all global addresses and
134 // assume direct function calls.
135 return RM.value_or(Reloc::Static);
136}
137
142
144
145 // You can't enable two modes of EH at the same time
146 if (WasmEnableEmEH && WasmEnableEH)
148 "-enable-emscripten-cxx-exceptions not allowed with -wasm-enable-eh");
149 // You can't enable two modes of SjLj at the same time
150 if (WasmEnableEmSjLj && WasmEnableSjLj)
152 "-enable-emscripten-sjlj not allowed with -wasm-enable-sjlj");
153 // You can't mix Emscripten EH with Wasm SjLj.
154 if (WasmEnableEmEH && WasmEnableSjLj)
156 "-enable-emscripten-cxx-exceptions not allowed with -wasm-enable-sjlj");
157
159 // FIXME: These flags should be removed in favor of directly using the
160 // generically configured ExceptionsType
163 }
164
165 // Basic Correctness checking related to -exception-model
168 report_fatal_error("-exception-model should be either 'none' or 'wasm'");
169 if (WasmEnableEmEH && TM->Options.ExceptionModel == ExceptionHandling::Wasm)
170 report_fatal_error("-exception-model=wasm not allowed with "
171 "-enable-emscripten-cxx-exceptions");
172 if (WasmEnableEH && TM->Options.ExceptionModel != ExceptionHandling::Wasm)
174 "-wasm-enable-eh only allowed with -exception-model=wasm");
175 if (WasmEnableSjLj && TM->Options.ExceptionModel != ExceptionHandling::Wasm)
177 "-wasm-enable-sjlj only allowed with -exception-model=wasm");
178 if ((!WasmEnableEH && !WasmEnableSjLj) &&
181 "-exception-model=wasm only allowed with at least one of "
182 "-wasm-enable-eh or -wasm-enable-sjlj");
183
184 // Currently it is allowed to mix Wasm EH with Emscripten SjLj as an interim
185 // measure, but some code will error out at compile time in this combination.
186 // See WebAssemblyLowerEmscriptenEHSjLj pass for details.
187}
188
189/// Create an WebAssembly architecture model.
190///
192 const Target &T, const Triple &TT, StringRef CPU, StringRef FS,
193 const TargetOptions &Options, std::optional<Reloc::Model> RM,
194 std::optional<CodeModel::Model> CM, CodeGenOptLevel OL, bool JIT)
195 : CodeGenTargetMachineImpl(T, TT.computeDataLayout(), TT, CPU, FS, Options,
197 getEffectiveCodeModel(CM, CodeModel::Large), OL),
198 TLOF(new WebAssemblyTargetObjectFile()),
199 UsesMultivalueABI(Options.MCOptions.getABIName() == "experimental-mv") {
200 // WebAssembly type-checks instructions, but a noreturn function with a return
201 // type that doesn't match the context will cause a check failure. So we lower
202 // LLVM 'unreachable' to ISD::TRAP and then lower that to WebAssembly's
203 // 'unreachable' instructions which is meant for that case. Formerly, we also
204 // needed to add checks to SP failure emission in the instruction selection
205 // backends, but this has since been tied to TrapUnreachable and is no longer
206 // necessary.
207 this->Options.TrapUnreachable = true;
208 this->Options.NoTrapAfterNoreturn = false;
209
210 // WebAssembly treats each function as an independent unit. Force
211 // -ffunction-sections, effectively, so that we can emit them independently.
212 this->Options.FunctionSections = true;
213 this->Options.DataSections = true;
214 this->Options.UniqueSectionNames = true;
215
217 initAsmInfo();
218 // Note that we don't use setRequiresStructuredCFG(true). It disables
219 // optimizations than we're ok with, and want, such as critical edge
220 // splitting and tail merging.
221}
222
224
229
232 std::string FS) const {
233 auto &I = SubtargetMap[CPU + FS];
234 if (!I) {
235 I = std::make_unique<WebAssemblySubtarget>(TargetTriple, CPU, FS, *this);
236 }
237 return I.get();
238}
239
242 Attribute CPUAttr = F.getFnAttribute("target-cpu");
243 Attribute FSAttr = F.getFnAttribute("target-features");
244
245 std::string CPU =
246 CPUAttr.isValid() ? CPUAttr.getValueAsString().str() : TargetCPU;
247 std::string FS =
248 FSAttr.isValid() ? FSAttr.getValueAsString().str() : TargetFS;
249
250 // This needs to be done before we create a new subtarget since any
251 // creation will depend on the TM and the code generation flags on the
252 // function that reside in TargetOptions.
254
255 return getSubtargetImpl(CPU, FS);
256}
257
258namespace {
259
260class CoalesceFeaturesAndStripAtomics final : public ModulePass {
261 // Take the union of all features used in the module and use it for each
262 // function individually, since having multiple feature sets in one module
263 // currently does not make sense for WebAssembly. If atomics are not enabled,
264 // also strip atomic operations and thread local storage.
265 static char ID;
267
268public:
269 CoalesceFeaturesAndStripAtomics(WebAssemblyTargetMachine *WasmTM)
270 : ModulePass(ID), WasmTM(WasmTM) {}
271
272 bool runOnModule(Module &M) override {
273 FeatureBitset Features = coalesceFeatures(M);
274
275 std::string FeatureStr = getFeatureString(Features);
276 WasmTM->setTargetFeatureString(FeatureStr);
277 for (auto &F : M)
278 replaceFeatures(F, FeatureStr);
279
280 bool StrippedAtomics = false;
281 bool StrippedTLS = false;
282
283 if (!Features[WebAssembly::FeatureAtomics]) {
284 StrippedAtomics = stripAtomics(M);
285 StrippedTLS = stripThreadLocals(M);
286 } else if (!Features[WebAssembly::FeatureBulkMemory]) {
287 StrippedTLS |= stripThreadLocals(M);
288 }
289
290 if (StrippedAtomics && !StrippedTLS)
291 stripThreadLocals(M);
292 else if (StrippedTLS && !StrippedAtomics)
293 stripAtomics(M);
294
295 recordFeatures(M, Features, StrippedAtomics || StrippedTLS);
296
297 // Conservatively assume we have made some change
298 return true;
299 }
300
301private:
302 FeatureBitset coalesceFeatures(const Module &M) {
303 // Union the features of all defined functions. Start with an empty set, so
304 // that if a feature is disabled in every function, we'll compute it as
305 // disabled. If any function lacks a target-features attribute, it'll
306 // default to the target CPU from the `TargetMachine`.
307 FeatureBitset Features;
308 bool AnyDefinedFuncs = false;
309 for (auto &F : M) {
310 if (F.isDeclaration())
311 continue;
312
313 Features |= WasmTM->getSubtargetImpl(F)->getFeatureBits();
314 AnyDefinedFuncs = true;
315 }
316
317 // If we have no defined functions, use the target CPU from the
318 // `TargetMachine`.
319 if (!AnyDefinedFuncs) {
320 Features =
321 WasmTM
322 ->getSubtargetImpl(std::string(WasmTM->getTargetCPU()),
323 std::string(WasmTM->getTargetFeatureString()))
324 ->getFeatureBits();
325 }
326
327 return Features;
328 }
329
330 static std::string getFeatureString(const FeatureBitset &Features) {
331 std::string Ret;
332 for (const SubtargetFeatureKV &KV : WebAssemblyFeatureKV) {
333 if (Features[KV.Value])
334 Ret += (StringRef("+") + KV.Key + ",").str();
335 else
336 Ret += (StringRef("-") + KV.Key + ",").str();
337 }
338 // remove trailing ','
339 Ret.pop_back();
340 return Ret;
341 }
342
343 void replaceFeatures(Function &F, const std::string &Features) {
344 F.removeFnAttr("target-features");
345 F.removeFnAttr("target-cpu");
346 F.addFnAttr("target-features", Features);
347 }
348
349 bool stripAtomics(Module &M) {
350 // Detect whether any atomics will be lowered, since there is no way to tell
351 // whether the LowerAtomic pass lowers e.g. stores.
352 bool Stripped = false;
353 for (auto &F : M) {
354 for (auto &B : F) {
355 for (auto &I : B) {
356 if (I.isAtomic()) {
357 Stripped = true;
358 goto done;
359 }
360 }
361 }
362 }
363
364 done:
365 if (!Stripped)
366 return false;
367
368 LowerAtomicPass Lowerer;
370 for (auto &F : M)
371 Lowerer.run(F, FAM);
372
373 return true;
374 }
375
376 bool stripThreadLocals(Module &M) {
377 bool Stripped = false;
378 for (auto &GV : M.globals()) {
379 if (GV.isThreadLocal()) {
380 // replace `@llvm.threadlocal.address.pX(GV)` with `GV`.
381 for (Use &U : make_early_inc_range(GV.uses())) {
382 if (IntrinsicInst *II = dyn_cast<IntrinsicInst>(U.getUser())) {
383 if (II->getIntrinsicID() == Intrinsic::threadlocal_address &&
384 II->getArgOperand(0) == &GV) {
385 II->replaceAllUsesWith(&GV);
386 II->eraseFromParent();
387 }
388 }
389 }
390
391 Stripped = true;
392 GV.setThreadLocal(false);
393 }
394 }
395 return Stripped;
396 }
397
398 void recordFeatures(Module &M, const FeatureBitset &Features, bool Stripped) {
399 for (const SubtargetFeatureKV &KV : WebAssemblyFeatureKV) {
400 if (Features[KV.Value]) {
401 // Mark features as used
402 std::string MDKey = (StringRef("wasm-feature-") + KV.Key).str();
403 M.addModuleFlag(Module::ModFlagBehavior::Error, MDKey,
405 }
406 }
407 // Code compiled without atomics or bulk-memory may have had its atomics or
408 // thread-local data lowered to nonatomic operations or non-thread-local
409 // data. In that case, we mark the pseudo-feature "shared-mem" as disallowed
410 // to tell the linker that it would be unsafe to allow this code ot be used
411 // in a module with shared memory.
412 if (Stripped) {
413 M.addModuleFlag(Module::ModFlagBehavior::Error, "wasm-feature-shared-mem",
415 }
416 }
417};
418char CoalesceFeaturesAndStripAtomics::ID = 0;
419
420/// WebAssembly Code Generator Pass Configuration Options.
421class WebAssemblyPassConfig final : public TargetPassConfig {
422public:
423 WebAssemblyPassConfig(WebAssemblyTargetMachine &TM, PassManagerBase &PM)
424 : TargetPassConfig(TM, PM) {}
425
426 WebAssemblyTargetMachine &getWebAssemblyTargetMachine() const {
428 }
429
430 FunctionPass *createTargetRegisterAllocator(bool) override;
431
432 void addIRPasses() override;
433 void addISelPrepare() override;
434 bool addInstSelector() override;
435 void addOptimizedRegAlloc() override;
436 void addPostRegAlloc() override;
437 bool addGCPasses() override { return false; }
438 void addPreEmitPass() override;
439 bool addPreISel() override;
440
441 // No reg alloc
442 bool addRegAssignAndRewriteFast() override { return false; }
443
444 // No reg alloc
445 bool addRegAssignAndRewriteOptimized() override { return false; }
446
447 bool addIRTranslator() override;
448 void addPreLegalizeMachineIR() override;
449 bool addLegalizeMachineIR() override;
450 void addPreRegBankSelect() override;
451 bool addRegBankSelect() override;
452 bool addGlobalInstructionSelect() override;
453};
454} // end anonymous namespace
455
462
465 return TargetTransformInfo(std::make_unique<WebAssemblyTTIImpl>(this, F));
466}
467
470 return new WebAssemblyPassConfig(*this, PM);
471}
472
473FunctionPass *WebAssemblyPassConfig::createTargetRegisterAllocator(bool) {
474 return nullptr; // No reg alloc
475}
476
477//===----------------------------------------------------------------------===//
478// The following functions are called from lib/CodeGen/Passes.cpp to modify
479// the CodeGen pass sequence.
480//===----------------------------------------------------------------------===//
481
482void WebAssemblyPassConfig::addIRPasses() {
483 // Add signatures to prototype-less function declarations
485
486 // Lower .llvm.global_dtors into .llvm.global_ctors with __cxa_atexit calls.
488
489 // Fix function bitcasts, as WebAssembly requires caller and callee signatures
490 // to match.
492
493 // Optimize "returned" function attributes.
494 if (getOptLevel() != CodeGenOptLevel::None)
496
497 // If exception handling is not enabled and setjmp/longjmp handling is
498 // enabled, we lower invokes into calls and delete unreachable landingpad
499 // blocks. Lowering invokes when there is no EH support is done in
500 // TargetPassConfig::addPassesToHandleExceptions, but that runs after these IR
501 // passes and Emscripten SjLj handling expects all invokes to be lowered
502 // before.
503 if (!WasmEnableEmEH && !WasmEnableEH) {
504 addPass(createLowerInvokePass());
505 // The lower invoke pass may create unreachable code. Remove it in order not
506 // to process dead blocks in setjmp/longjmp handling.
508 }
509
510 // Handle exceptions and setjmp/longjmp if enabled. Unlike Wasm EH preparation
511 // done in WasmEHPrepare pass, Wasm SjLj preparation shares libraries and
512 // transformation algorithms with Emscripten SjLj, so we run
513 // LowerEmscriptenEHSjLj pass also when Wasm SjLj is enabled.
514 if (WasmEnableEmEH || WasmEnableEmSjLj || WasmEnableSjLj)
516
517 // Expand indirectbr instructions to switches.
519
521}
522
523void WebAssemblyPassConfig::addISelPrepare() {
524 // We need to move reference type allocas to WASM_ADDRESS_SPACE_VAR so that
525 // loads and stores are promoted to local.gets/local.sets.
527 // Lower atomics and TLS if necessary
528 addPass(new CoalesceFeaturesAndStripAtomics(&getWebAssemblyTargetMachine()));
529
530 // This is a no-op if atomics are not used in the module
532
534}
535
536bool WebAssemblyPassConfig::addInstSelector() {
538 addPass(
539 createWebAssemblyISelDag(getWebAssemblyTargetMachine(), getOptLevel()));
540 // Run the argument-move pass immediately after the ScheduleDAG scheduler
541 // so that we can fix up the ARGUMENT instructions before anything else
542 // sees them in the wrong place.
544 // Set the p2align operands. This information is present during ISel, however
545 // it's inconvenient to collect. Collect it now, and update the immediate
546 // operands.
548
549 // Eliminate range checks and add default targets to br_table instructions.
551
552 // unreachable is terminator, non-terminator instruction after it is not
553 // allowed.
555
556 return false;
557}
558
559void WebAssemblyPassConfig::addOptimizedRegAlloc() {
560 // Currently RegisterCoalesce degrades wasm debug info quality by a
561 // significant margin. As a quick fix, disable this for -O1, which is often
562 // used for debugging large applications. Disabling this increases code size
563 // of Emscripten core benchmarks by ~5%, which is acceptable for -O1, which is
564 // usually not used for production builds.
565 // TODO Investigate why RegisterCoalesce degrades debug info quality and fix
566 // it properly
567 if (getOptLevel() == CodeGenOptLevel::Less)
568 disablePass(&RegisterCoalescerID);
570}
571
572void WebAssemblyPassConfig::addPostRegAlloc() {
573 // TODO: The following CodeGen passes don't currently support code containing
574 // virtual registers. Consider removing their restrictions and re-enabling
575 // them.
576
577 // These functions all require the NoVRegs property.
578 disablePass(&MachineLateInstrsCleanupID);
579 disablePass(&MachineCopyPropagationID);
580 disablePass(&PostRAMachineSinkingID);
581 disablePass(&PostRASchedulerID);
582 disablePass(&FuncletLayoutID);
583 disablePass(&StackMapLivenessID);
584 disablePass(&PatchableFunctionID);
585 disablePass(&ShrinkWrapID);
586 disablePass(&RemoveLoadsIntoFakeUsesID);
587
588 // This pass hurts code size for wasm because it can generate irreducible
589 // control flow.
590 disablePass(&MachineBlockPlacementID);
591
593}
594
595void WebAssemblyPassConfig::addPreEmitPass() {
597
598 // Nullify DBG_VALUE_LISTs that we cannot handle.
600
601 // Remove any unreachable blocks that may be left floating around.
602 // Rare, but possible. Needed for WebAssemblyFixIrreducibleControlFlow.
604
605 // Eliminate multiple-entry loops.
607
608 // Do various transformations for exception handling.
609 // Every CFG-changing optimizations should come before this.
610 if (TM->Options.ExceptionModel == ExceptionHandling::Wasm)
612
613 // Now that we have a prologue and epilogue and all frame indices are
614 // rewritten, eliminate SP and FP. This allows them to be stackified,
615 // colored, and numbered with the rest of the registers.
617
618 // Preparations and optimizations related to register stackification.
619 if (getOptLevel() != CodeGenOptLevel::None) {
620 // Depend on LiveIntervals and perform some optimizations on it.
622
623 // Prepare memory intrinsic calls for register stackifying.
625 }
626
627 // Mark registers as representing wasm's value stack. This is a key
628 // code-compression technique in WebAssembly. We run this pass (and
629 // MemIntrinsicResults above) very late, so that it sees as much code as
630 // possible, including code emitted by PEI and expanded by late tail
631 // duplication.
632 addPass(createWebAssemblyRegStackify(getOptLevel()));
633
634 if (getOptLevel() != CodeGenOptLevel::None) {
635 // Run the register coloring pass to reduce the total number of registers.
636 // This runs after stackification so that it doesn't consider registers
637 // that become stackified.
639 }
640
641 // Sort the blocks of the CFG into topological order, a prerequisite for
642 // BLOCK and LOOP markers.
643 addPass(createWebAssemblyCFGSort());
644
645 // Insert BLOCK and LOOP markers.
647
648 // Insert explicit local.get and local.set operators.
651
652 // Lower br_unless into br_if.
654
655 // Perform the very last peephole optimizations on the code.
656 if (getOptLevel() != CodeGenOptLevel::None)
657 addPass(createWebAssemblyPeephole());
658
659 // Create a mapping from LLVM CodeGen virtual registers to wasm registers.
661
662 // Fix debug_values whose defs have been stackified.
665
666 // Collect information to prepare for MC lowering / asm printing.
668}
669
670bool WebAssemblyPassConfig::addPreISel() {
673 return false;
674}
675
676bool WebAssemblyPassConfig::addIRTranslator() {
677 addPass(new IRTranslator());
678 return false;
679}
680
681void WebAssemblyPassConfig::addPreLegalizeMachineIR() {
682 if (getOptLevel() != CodeGenOptLevel::None) {
684 }
685}
686bool WebAssemblyPassConfig::addLegalizeMachineIR() {
687 addPass(new Legalizer());
688 return false;
689}
690
691void WebAssemblyPassConfig::addPreRegBankSelect() {
692 if (getOptLevel() != CodeGenOptLevel::None) {
694 }
695}
696
697bool WebAssemblyPassConfig::addRegBankSelect() {
698 addPass(new RegBankSelect());
699 return false;
700}
701
702bool WebAssemblyPassConfig::addGlobalInstructionSelect() {
703 addPass(new InstructionSelect(getOptLevel()));
704
705 // We insert only if ISelDAG won't insert these at a later point.
706 if (isGlobalISelAbortEnabled()) {
711 }
712
713 return false;
714}
715
720
726
729 SMDiagnostic &Error, SMRange &SourceRange) const {
730 const auto &YamlMFI = static_cast<const yaml::WebAssemblyFunctionInfo &>(MFI);
731 MachineFunction &MF = PFS.MF;
732 MF.getInfo<WebAssemblyFunctionInfo>()->initializeBaseYamlFields(MF, YamlMFI);
733 return false;
734}
static Reloc::Model getEffectiveRelocModel()
static GCRegistry::Add< OcamlGC > B("ocaml", "ocaml 3.10-compatible GC")
#define LLVM_ABI
Definition Compiler.h:213
#define LLVM_EXTERNAL_VISIBILITY
Definition Compiler.h:132
DXIL Legalizer
This file declares the IRTranslator pass.
#define F(x, y, z)
Definition MD5.cpp:54
#define I(x, y, z)
Definition MD5.cpp:57
Machine Check Debug Module
#define T
uint64_t IntrinsicInst * II
FunctionAnalysisManager FAM
This file describes the interface of the MachineFunctionPass responsible for assigning the generic vi...
const GCNTargetMachine & getTM(const GCNSubtarget *STI)
static TableGen::Emitter::Opt Y("gen-skeleton-entry", EmitSkeleton, "Generate example skeleton entry")
static TableGen::Emitter::OptClass< SkeletonEmitter > X("gen-skeleton-class", "Generate example skeleton class")
Target-Independent Code Generator Pass Configuration Options pass.
This file defines the interfaces that WebAssembly uses to lower LLVM code into a selection DAG.
This file provides WebAssembly-specific target descriptions.
This file declares WebAssembly-specific per-machine-function information.
This file registers the WebAssembly target.
LLVM_ABI LLVM_EXTERNAL_VISIBILITY void LLVMInitializeWebAssemblyTarget()
static void basicCheckForEHAndSjLj(TargetMachine *TM)
static cl::opt< bool > WasmDisableExplicitLocals("wasm-disable-explicit-locals", cl::Hidden, cl::desc("WebAssembly: output implicit locals in" " instruction output for test purposes only."), cl::init(false))
This file declares the WebAssembly-specific subclass of TargetMachine.
This file declares the WebAssembly-specific subclass of TargetLoweringObjectFile.
This file a TargetTransformInfoImplBase conforming object specific to the WebAssembly target machine.
This file contains the declaration of the WebAssembly-specific utility functions.
This file contains the entry points for global functions defined in the LLVM WebAssembly back-end.
Functions, function parameters, and return types can have attributes to indicate how they should be t...
Definition Attributes.h:105
LLVM_ABI StringRef getValueAsString() const
Return the attribute's value as a string.
bool isValid() const
Return true if the attribute is any kind of attribute.
Definition Attributes.h:261
CodeGenTargetMachineImpl(const Target &T, StringRef DataLayoutString, const Triple &TT, StringRef CPU, StringRef FS, const TargetOptions &Options, Reloc::Model RM, CodeModel::Model CM, CodeGenOptLevel OL)
Lightweight error class with error context and mandatory checking.
Definition Error.h:159
Container class for subtarget features.
FunctionPass class - This class is used to implement most global optimizations.
Definition Pass.h:314
This pass is responsible for selecting generic machine instructions to target-specific instructions.
PreservedAnalyses run(Function &F, FunctionAnalysisManager &)
Ty * getInfo()
getInfo - Keep track of various per-function pieces of information for backends that would like to do...
ModulePass class - This class is used to implement unstructured interprocedural optimizations and ana...
Definition Pass.h:255
A Module instance is used to store all the information related to an LLVM module.
Definition Module.h:67
static LLVM_ABI PassRegistry * getPassRegistry()
getPassRegistry - Access the global registry object, which is automatically initialized at applicatio...
This pass implements the reg bank selector pass used in the GlobalISel pipeline.
Instances of this class encapsulate one diagnostic report, allowing printing to a raw_ostream as a ca...
Definition SourceMgr.h:297
Represents a range in source code.
Definition SMLoc.h:47
StringRef - Represent a constant reference to a string, i.e.
Definition StringRef.h:55
std::string str() const
str - Get the contents as an std::string.
Definition StringRef.h:222
Primary interface to the complete machine description for the target machine.
Triple TargetTriple
Triple string, CPU name, and target feature strings the TargetMachine instance is created with.
StringRef getTargetFeatureString() const
StringRef getTargetCPU() const
std::unique_ptr< const MCSubtargetInfo > STI
TargetOptions Options
void setTargetFeatureString(StringRef FS)
void resetTargetOptions(const Function &F) const
Reset the target options based on the function's attributes.
unsigned FunctionSections
Emit functions into separate sections.
unsigned NoTrapAfterNoreturn
Do not emit a trap instruction for 'unreachable' IR instructions behind noreturn calls,...
unsigned DataSections
Emit data into separate sections.
unsigned TrapUnreachable
Emit target-specific trap instruction for 'unreachable' IR instructions.
ExceptionHandling ExceptionModel
What exception model to use.
Target-Independent Code Generator Pass Configuration Options.
virtual void addPostRegAlloc()
This method may be implemented by targets that want to run passes after register allocation pass pipe...
virtual bool addInstSelector()
addInstSelector - This method should install an instruction selector pass, which converts from LLVM c...
virtual bool addPreISel()
Methods with trivial inline returns are convenient points in the common codegen pass pipeline where t...
virtual void addOptimizedRegAlloc()
addOptimizedRegAlloc - Add passes related to register allocation.
virtual void addPreEmitPass()
This pass may be implemented by targets that want to run passes immediately before machine code is em...
virtual void addIRPasses()
Add common target configurable passes that perform LLVM IR to IR transforms following machine indepen...
virtual void addISelPrepare()
Add common passes that perform LLVM IR to IR transforms in preparation for instruction selection.
TargetSubtargetInfo - Generic base class for all target subtargets.
This pass provides access to the codegen interfaces that are needed for IR-level transformations.
Target - Wrapper for Target specific information.
Triple - Helper class for working with autoconf configuration names.
Definition Triple.h:47
This class is derived from MachineFunctionInfo and contains private WebAssembly-specific information ...
yaml::MachineFunctionInfo * createDefaultFuncInfoYAML() const override
Allocate and return a default initialized instance of the YAML representation for the MachineFunction...
bool parseMachineFunctionInfo(const yaml::MachineFunctionInfo &, PerFunctionMIParsingState &PFS, SMDiagnostic &Error, SMRange &SourceRange) const override
Parse out the target's MachineFunctionInfo from the YAML reprsentation.
WebAssemblyTargetMachine(const Target &T, const Triple &TT, StringRef CPU, StringRef FS, const TargetOptions &Options, std::optional< Reloc::Model > RM, std::optional< CodeModel::Model > CM, CodeGenOptLevel OL, bool JIT)
Create an WebAssembly architecture model.
TargetPassConfig * createPassConfig(PassManagerBase &PM) override
Create a pass configuration object to be used by addPassToEmitX methods for generating a pipeline of ...
const WebAssemblySubtarget * getSubtargetImpl() const
MachineFunctionInfo * createMachineFunctionInfo(BumpPtrAllocator &Allocator, const Function &F, const TargetSubtargetInfo *STI) const override
Create the target's instance of MachineFunctionInfo.
TargetTransformInfo getTargetTransformInfo(const Function &F) const override
Get a TargetTransformInfo implementation for the target.
yaml::MachineFunctionInfo * convertFuncInfoToYAML(const MachineFunction &MF) const override
Allocate and initialize an instance of the YAML representation of the MachineFunctionInfo.
PassManagerBase - An abstract interface to allow code to add passes to a pass manager without having ...
unsigned ID
LLVM IR allows to use arbitrary numbers as calling convention identifiers.
Definition CallingConv.h:24
cl::opt< bool > WasmUseLegacyEH
cl::opt< bool > WasmEnableEH
cl::opt< bool > WasmEnableSjLj
cl::opt< bool > WasmEnableEmEH
cl::opt< bool > WasmEnableEmSjLj
initializer< Ty > init(const Ty &Val)
@ WASM_FEATURE_PREFIX_USED
Definition Wasm.h:189
@ WASM_FEATURE_PREFIX_DISALLOWED
Definition Wasm.h:190
This is an optimization pass for GlobalISel generic memory operations.
Definition Types.h:26
LLVM_ABI ModulePass * createLowerGlobalDtorsLegacyPass()
void initializeOptimizeReturnedPass(PassRegistry &)
LLVM_ABI FunctionPass * createIndirectBrExpandPass()
void initializeWebAssemblyLowerBrUnlessPass(PassRegistry &)
FunctionPass * createWebAssemblyLowerRefTypesIntPtrConv()
FunctionPass * createWebAssemblyRegNumbering()
ModulePass * createWebAssemblyAddMissingPrototypes()
LLVM_ABI char & RegisterCoalescerID
RegisterCoalescer - This pass merges live ranges to eliminate copies.
FunctionPass * createWebAssemblyLateEHPrepare()
const SubtargetFeatureKV WebAssemblyFeatureKV[WebAssembly::NumSubtargetFeatures]
decltype(auto) dyn_cast(const From &Val)
dyn_cast<X> - Return the argument parameter cast to the specified type.
Definition Casting.h:643
void initializeWebAssemblyPostLegalizerCombinerPass(PassRegistry &)
void initializeWebAssemblyLateEHPreparePass(PassRegistry &)
@ None
No exception support.
Definition CodeGen.h:54
@ Wasm
WebAssembly Exception Handling.
Definition CodeGen.h:59
FunctionPass * createWebAssemblyFixBrTableDefaults()
void initializeWebAssemblyAddMissingPrototypesPass(PassRegistry &)
iterator_range< early_inc_iterator_impl< detail::IterOfRange< RangeT > > > make_early_inc_range(RangeT &&Range)
Make a range that does early increment to allow mutation of the underlying range without disrupting i...
Definition STLExtras.h:634
LLVM_ABI char & PatchableFunctionID
This pass implements the "patchable-function" attribute.
void initializeWebAssemblyExceptionInfoPass(PassRegistry &)
LLVM_ABI char & PostRASchedulerID
PostRAScheduler - This pass performs post register allocation scheduling.
LLVM_ABI char & RemoveLoadsIntoFakeUsesID
RemoveLoadsIntoFakeUses pass.
void initializeWebAssemblyRegNumberingPass(PassRegistry &)
void initializeWebAssemblyLowerRefTypesIntPtrConvPass(PassRegistry &)
void initializeWebAssemblyDAGToDAGISelLegacyPass(PassRegistry &)
FunctionPass * createWebAssemblyRegStackify(CodeGenOptLevel OptLevel)
FunctionPass * createWebAssemblyReplacePhysRegs()
void initializeWebAssemblyRegColoringPass(PassRegistry &)
static Reloc::Model getEffectiveRelocModel(std::optional< Reloc::Model > RM)
CodeModel::Model getEffectiveCodeModel(std::optional< CodeModel::Model > CM, CodeModel::Model Default)
Helper method for getting the code model, returning Default if CM does not have a value.
FunctionPass * createWebAssemblyMemIntrinsicResults()
LLVM_ABI char & ShrinkWrapID
ShrinkWrap pass. Look for the best place to insert save and restore.
LLVM_ABI char & MachineLateInstrsCleanupID
MachineLateInstrsCleanup - This pass removes redundant identical instructions after register allocati...
FunctionPass * createWebAssemblyDebugFixup()
LLVM_ABI char & UnreachableMachineBlockElimID
UnreachableMachineBlockElimination - This pass removes unreachable machine basic blocks.
LLVM_ABI FunctionPass * createLowerInvokePass()
Target & getTheWebAssemblyTarget32()
LLVM_ABI void report_fatal_error(Error Err, bool gen_crash_diag=true)
Definition Error.cpp:163
void initializeWebAssemblyNullifyDebugValueListsPass(PassRegistry &)
LLVM_ABI char & StackMapLivenessID
StackMapLiveness - This pass analyses the register live-out set of stackmap/patchpoint intrinsics and...
LLVM_ABI void initializeLowerGlobalDtorsLegacyPassPass(PassRegistry &)
void initializeWebAssemblyFixIrreducibleControlFlowPass(PassRegistry &)
FunctionPass * createWebAssemblyISelDag(WebAssemblyTargetMachine &TM, CodeGenOptLevel OptLevel)
This pass converts a legalized DAG into a WebAssembly-specific DAG, ready for instruction scheduling.
LLVM_ABI char & FuncletLayoutID
This pass lays out funclets contiguously.
void initializeWebAssemblyRegStackifyPass(PassRegistry &)
FunctionPass * createWebAssemblyCFGStackify()
FunctionPass * createWebAssemblyOptimizeLiveIntervals()
LLVM_ABI char & PostRAMachineSinkingID
This pass perform post-ra machine sink for COPY instructions.
CodeGenOptLevel
Code generation optimization level.
Definition CodeGen.h:82
FunctionPass * createWebAssemblyOptimizeReturned()
FunctionPass * createWebAssemblyRefTypeMem2Local()
FunctionPass * createWebAssemblyCleanCodeAfterTrap()
void initializeWebAssemblyOptimizeLiveIntervalsPass(PassRegistry &)
FunctionPass * createWebAssemblySetP2AlignOperands()
ModulePass * createWebAssemblyLowerEmscriptenEHSjLj()
void initializeWebAssemblyLowerEmscriptenEHSjLjPass(PassRegistry &)
LLVM_ABI void initializeGlobalISel(PassRegistry &)
Initialize all passes linked into the GlobalISel library.
void initializeWebAssemblyPreLegalizerCombinerPass(PassRegistry &)
FunctionPass * createWebAssemblyArgumentMove()
FunctionPass * createWebAssemblyExplicitLocals()
Target & getTheWebAssemblyTarget64()
void initializeWebAssemblyMemIntrinsicResultsPass(PassRegistry &)
void initializeWebAssemblyMCLowerPrePassPass(PassRegistry &)
void initializeWebAssemblyExplicitLocalsPass(PassRegistry &)
FunctionPass * createWebAssemblyPreLegalizerCombiner()
FunctionPass * createWebAssemblyFixIrreducibleControlFlow()
ModulePass * createWebAssemblyFixFunctionBitcasts()
FunctionPass * createWebAssemblyLowerBrUnless()
void initializeFixFunctionBitcastsPass(PassRegistry &)
FunctionPass * createWebAssemblyRegColoring()
void initializeWebAssemblyPeepholePass(PassRegistry &)
ModulePass * createWebAssemblyMCLowerPrePass()
void initializeWebAssemblyRefTypeMem2LocalPass(PassRegistry &)
LLVM_ABI char & MachineBlockPlacementID
MachineBlockPlacement - This pass places basic blocks based on branch probabilities.
AnalysisManager< Function > FunctionAnalysisManager
Convenience typedef for the Function analysis manager.
LLVM_ABI FunctionPass * createAtomicExpandLegacyPass()
AtomicExpandPass - At IR level this pass replace atomic instructions with __atomic_* library calls,...
FunctionPass * createWebAssemblyCFGSort()
BumpPtrAllocatorImpl<> BumpPtrAllocator
The standard BumpPtrAllocator which just uses the default template parameters.
Definition Allocator.h:383
void initializeWebAssemblyCFGSortPass(PassRegistry &)
void initializeWebAssemblyFixBrTableDefaultsPass(PassRegistry &)
FunctionPass * createWebAssemblyPostLegalizerCombiner()
FunctionPass * createWebAssemblyNullifyDebugValueLists()
void initializeWebAssemblyAsmPrinterPass(PassRegistry &)
void initializeWebAssemblyCFGStackifyPass(PassRegistry &)
void initializeWebAssemblySetP2AlignOperandsPass(PassRegistry &)
void initializeWebAssemblyDebugFixupPass(PassRegistry &)
LLVM_ABI char & MachineCopyPropagationID
MachineCopyPropagation - This pass performs copy propagation on machine instructions.
void initializeWebAssemblyArgumentMovePass(PassRegistry &)
LLVM_ABI FunctionPass * createUnreachableBlockEliminationPass()
createUnreachableBlockEliminationPass - The LLVM code generator does not work well with unreachable b...
FunctionPass * createWebAssemblyPeephole()
void initializeWebAssemblyReplacePhysRegsPass(PassRegistry &)
MachineFunctionInfo - This class can be derived from and used by targets to hold private target-speci...
static FuncInfoTy * create(BumpPtrAllocator &Allocator, const Function &F, const SubtargetTy *STI)
Factory function: default behavior is to call new using the supplied allocator.
RegisterTargetMachine - Helper template for registering a target machine implementation,...
Targets should override this in a way that mirrors the implementation of llvm::MachineFunctionInfo.