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
55 "wasm-disable-fix-irreducible-control-flow-pass", cl::Hidden,
56 cl::desc("webassembly: disables the fix "
57 " irreducible control flow optimization pass"),
58 cl::init(false));
59
60// Exception handling & setjmp-longjmp handling related options.
61
62// Emscripten's asm.js-style exception handling
64 "enable-emscripten-cxx-exceptions",
65 cl::desc("WebAssembly Emscripten-style exception handling"),
66 cl::init(false));
67// Emscripten's asm.js-style setjmp/longjmp handling
69 "enable-emscripten-sjlj",
70 cl::desc("WebAssembly Emscripten-style setjmp/longjmp handling"),
71 cl::init(false));
72// Exception handling using wasm EH instructions
74 WebAssembly::WasmEnableEH("wasm-enable-eh",
75 cl::desc("WebAssembly exception handling"));
76// setjmp/longjmp handling using wasm EH instrutions
78 "wasm-enable-sjlj", cl::desc("WebAssembly setjmp/longjmp handling"));
79// If true, use the legacy Wasm EH proposal:
80// https://github.com/WebAssembly/exception-handling/blob/main/proposals/exception-handling/legacy/Exceptions.md
81// And if false, use the standardized Wasm EH proposal:
82// https://github.com/WebAssembly/exception-handling/blob/main/proposals/exception-handling/Exceptions.md
83// Currently set to true by default because not all major web browsers turn on
84// the new standard proposal by default, but will later change to false.
86 "wasm-use-legacy-eh", cl::desc("WebAssembly exception handling (legacy)"),
87 cl::init(true));
88
91 // Register the target.
96
97 // Register backend passes
131}
132
133//===----------------------------------------------------------------------===//
134// WebAssembly Lowering public interface.
135//===----------------------------------------------------------------------===//
136
137static Reloc::Model getEffectiveRelocModel(std::optional<Reloc::Model> RM) {
138 // Default to static relocation model. This should always be more optimial
139 // than PIC since the static linker can determine all global addresses and
140 // assume direct function calls.
141 return RM.value_or(Reloc::Static);
142}
143
148
150
151 // You can't enable two modes of EH at the same time
152 if (WasmEnableEmEH && WasmEnableEH)
154 "-enable-emscripten-cxx-exceptions not allowed with -wasm-enable-eh");
155 // You can't enable two modes of SjLj at the same time
156 if (WasmEnableEmSjLj && WasmEnableSjLj)
158 "-enable-emscripten-sjlj not allowed with -wasm-enable-sjlj");
159 // You can't mix Emscripten EH with Wasm SjLj.
160 if (WasmEnableEmEH && WasmEnableSjLj)
162 "-enable-emscripten-cxx-exceptions not allowed with -wasm-enable-sjlj");
163
165 // FIXME: These flags should be removed in favor of directly using the
166 // generically configured ExceptionsType
169 }
170
171 // Basic Correctness checking related to -exception-model
174 report_fatal_error("-exception-model should be either 'none' or 'wasm'");
175 if (WasmEnableEmEH && TM->Options.ExceptionModel == ExceptionHandling::Wasm)
176 report_fatal_error("-exception-model=wasm not allowed with "
177 "-enable-emscripten-cxx-exceptions");
178 if (WasmEnableEH && TM->Options.ExceptionModel != ExceptionHandling::Wasm)
180 "-wasm-enable-eh only allowed with -exception-model=wasm");
181 if (WasmEnableSjLj && TM->Options.ExceptionModel != ExceptionHandling::Wasm)
183 "-wasm-enable-sjlj only allowed with -exception-model=wasm");
184 if ((!WasmEnableEH && !WasmEnableSjLj) &&
187 "-exception-model=wasm only allowed with at least one of "
188 "-wasm-enable-eh or -wasm-enable-sjlj");
189
190 // Currently it is allowed to mix Wasm EH with Emscripten SjLj as an interim
191 // measure, but some code will error out at compile time in this combination.
192 // See WebAssemblyLowerEmscriptenEHSjLj pass for details.
193}
194
195/// Create an WebAssembly architecture model.
196///
198 const Target &T, const Triple &TT, StringRef CPU, StringRef FS,
199 const TargetOptions &Options, std::optional<Reloc::Model> RM,
200 std::optional<CodeModel::Model> CM, CodeGenOptLevel OL, bool JIT)
201 : CodeGenTargetMachineImpl(T, TT.computeDataLayout(), TT, CPU, FS, Options,
203 getEffectiveCodeModel(CM, CodeModel::Large), OL),
204 TLOF(new WebAssemblyTargetObjectFile()),
205 UsesMultivalueABI(Options.MCOptions.getABIName() == "experimental-mv") {
206 // WebAssembly type-checks instructions, but a noreturn function with a return
207 // type that doesn't match the context will cause a check failure. So we lower
208 // LLVM 'unreachable' to ISD::TRAP and then lower that to WebAssembly's
209 // 'unreachable' instructions which is meant for that case. Formerly, we also
210 // needed to add checks to SP failure emission in the instruction selection
211 // backends, but this has since been tied to TrapUnreachable and is no longer
212 // necessary.
213 this->Options.TrapUnreachable = true;
214 this->Options.NoTrapAfterNoreturn = false;
215
216 // WebAssembly treats each function as an independent unit. Force
217 // -ffunction-sections, effectively, so that we can emit them independently.
218 this->Options.FunctionSections = true;
219 this->Options.DataSections = true;
220 this->Options.UniqueSectionNames = true;
221
223 initAsmInfo();
224 // Note that we don't use setRequiresStructuredCFG(true). It disables
225 // optimizations than we're ok with, and want, such as critical edge
226 // splitting and tail merging.
227}
228
230
235
238 std::string FS) const {
239 auto &I = SubtargetMap[CPU + FS];
240 if (!I) {
241 I = std::make_unique<WebAssemblySubtarget>(TargetTriple, CPU, FS, *this);
242 }
243 return I.get();
244}
245
248 Attribute CPUAttr = F.getFnAttribute("target-cpu");
249 Attribute FSAttr = F.getFnAttribute("target-features");
250
251 std::string CPU =
252 CPUAttr.isValid() ? CPUAttr.getValueAsString().str() : TargetCPU;
253 std::string FS =
254 FSAttr.isValid() ? FSAttr.getValueAsString().str() : TargetFS;
255
256 // This needs to be done before we create a new subtarget since any
257 // creation will depend on the TM and the code generation flags on the
258 // function that reside in TargetOptions.
260
261 return getSubtargetImpl(CPU, FS);
262}
263
264namespace {
265
266class CoalesceFeaturesAndStripAtomics final : public ModulePass {
267 // Take the union of all features used in the module and use it for each
268 // function individually, since having multiple feature sets in one module
269 // currently does not make sense for WebAssembly. If atomics are not enabled,
270 // also strip atomic operations and thread local storage.
271 static char ID;
273
274public:
275 CoalesceFeaturesAndStripAtomics(WebAssemblyTargetMachine *WasmTM)
276 : ModulePass(ID), WasmTM(WasmTM) {}
277
278 bool runOnModule(Module &M) override {
279 FeatureBitset Features = coalesceFeatures(M);
280
281 std::string FeatureStr = getFeatureString(Features);
282 WasmTM->setTargetFeatureString(FeatureStr);
283 for (auto &F : M)
284 replaceFeatures(F, FeatureStr);
285
286 bool StrippedAtomics = false;
287 bool StrippedTLS = false;
288
289 if (!Features[WebAssembly::FeatureAtomics]) {
290 StrippedAtomics = stripAtomics(M);
291 StrippedTLS = stripThreadLocals(M);
292 } else if (!Features[WebAssembly::FeatureBulkMemory]) {
293 StrippedTLS |= stripThreadLocals(M);
294 }
295
296 if (StrippedAtomics && !StrippedTLS)
297 stripThreadLocals(M);
298 else if (StrippedTLS && !StrippedAtomics)
299 stripAtomics(M);
300
301 recordFeatures(M, Features, StrippedAtomics || StrippedTLS);
302
303 // Conservatively assume we have made some change
304 return true;
305 }
306
307private:
308 FeatureBitset coalesceFeatures(const Module &M) {
309 // Union the features of all defined functions. Start with an empty set, so
310 // that if a feature is disabled in every function, we'll compute it as
311 // disabled. If any function lacks a target-features attribute, it'll
312 // default to the target CPU from the `TargetMachine`.
313 FeatureBitset Features;
314 bool AnyDefinedFuncs = false;
315 for (auto &F : M) {
316 if (F.isDeclaration())
317 continue;
318
319 Features |= WasmTM->getSubtargetImpl(F)->getFeatureBits();
320 AnyDefinedFuncs = true;
321 }
322
323 // If we have no defined functions, use the target CPU from the
324 // `TargetMachine`.
325 if (!AnyDefinedFuncs) {
326 Features =
327 WasmTM
328 ->getSubtargetImpl(std::string(WasmTM->getTargetCPU()),
329 std::string(WasmTM->getTargetFeatureString()))
330 ->getFeatureBits();
331 }
332
333 return Features;
334 }
335
336 static std::string getFeatureString(const FeatureBitset &Features) {
337 std::string Ret;
338 for (const SubtargetFeatureKV &KV : WebAssemblyFeatureKV) {
339 if (Features[KV.Value])
340 Ret += (StringRef("+") + KV.Key + ",").str();
341 else
342 Ret += (StringRef("-") + KV.Key + ",").str();
343 }
344 // remove trailing ','
345 Ret.pop_back();
346 return Ret;
347 }
348
349 void replaceFeatures(Function &F, const std::string &Features) {
350 F.removeFnAttr("target-features");
351 F.removeFnAttr("target-cpu");
352 F.addFnAttr("target-features", Features);
353 }
354
355 bool stripAtomics(Module &M) {
356 // Detect whether any atomics will be lowered, since there is no way to tell
357 // whether the LowerAtomic pass lowers e.g. stores.
358 bool Stripped = false;
359 for (auto &F : M) {
360 for (auto &B : F) {
361 for (auto &I : B) {
362 if (I.isAtomic()) {
363 Stripped = true;
364 goto done;
365 }
366 }
367 }
368 }
369
370 done:
371 if (!Stripped)
372 return false;
373
374 LowerAtomicPass Lowerer;
376 for (auto &F : M)
377 Lowerer.run(F, FAM);
378
379 return true;
380 }
381
382 bool stripThreadLocals(Module &M) {
383 bool Stripped = false;
384 for (auto &GV : M.globals()) {
385 if (GV.isThreadLocal()) {
386 // replace `@llvm.threadlocal.address.pX(GV)` with `GV`.
387 for (Use &U : make_early_inc_range(GV.uses())) {
388 if (IntrinsicInst *II = dyn_cast<IntrinsicInst>(U.getUser())) {
389 if (II->getIntrinsicID() == Intrinsic::threadlocal_address &&
390 II->getArgOperand(0) == &GV) {
391 II->replaceAllUsesWith(&GV);
392 II->eraseFromParent();
393 }
394 }
395 }
396
397 Stripped = true;
398 GV.setThreadLocal(false);
399 }
400 }
401 return Stripped;
402 }
403
404 void recordFeatures(Module &M, const FeatureBitset &Features, bool Stripped) {
405 for (const SubtargetFeatureKV &KV : WebAssemblyFeatureKV) {
406 if (Features[KV.Value]) {
407 // Mark features as used
408 std::string MDKey = (StringRef("wasm-feature-") + KV.Key).str();
409 M.addModuleFlag(Module::ModFlagBehavior::Error, MDKey,
411 }
412 }
413 // Code compiled without atomics or bulk-memory may have had its atomics or
414 // thread-local data lowered to nonatomic operations or non-thread-local
415 // data. In that case, we mark the pseudo-feature "shared-mem" as disallowed
416 // to tell the linker that it would be unsafe to allow this code ot be used
417 // in a module with shared memory.
418 if (Stripped) {
419 M.addModuleFlag(Module::ModFlagBehavior::Error, "wasm-feature-shared-mem",
421 }
422 }
423};
424char CoalesceFeaturesAndStripAtomics::ID = 0;
425
426/// WebAssembly Code Generator Pass Configuration Options.
427class WebAssemblyPassConfig final : public TargetPassConfig {
428public:
429 WebAssemblyPassConfig(WebAssemblyTargetMachine &TM, PassManagerBase &PM)
430 : TargetPassConfig(TM, PM) {}
431
432 WebAssemblyTargetMachine &getWebAssemblyTargetMachine() const {
434 }
435
436 FunctionPass *createTargetRegisterAllocator(bool) override;
437
438 void addIRPasses() override;
439 void addISelPrepare() override;
440 bool addInstSelector() override;
441 void addOptimizedRegAlloc() override;
442 void addPostRegAlloc() override;
443 bool addGCPasses() override { return false; }
444 void addPreEmitPass() override;
445 bool addPreISel() override;
446
447 // No reg alloc
448 bool addRegAssignAndRewriteFast() override { return false; }
449
450 // No reg alloc
451 bool addRegAssignAndRewriteOptimized() override { return false; }
452
453 bool addIRTranslator() override;
454 void addPreLegalizeMachineIR() override;
455 bool addLegalizeMachineIR() override;
456 void addPreRegBankSelect() override;
457 bool addRegBankSelect() override;
458 bool addGlobalInstructionSelect() override;
459};
460} // end anonymous namespace
461
468
471 return TargetTransformInfo(std::make_unique<WebAssemblyTTIImpl>(this, F));
472}
473
476 return new WebAssemblyPassConfig(*this, PM);
477}
478
479FunctionPass *WebAssemblyPassConfig::createTargetRegisterAllocator(bool) {
480 return nullptr; // No reg alloc
481}
482
483//===----------------------------------------------------------------------===//
484// The following functions are called from lib/CodeGen/Passes.cpp to modify
485// the CodeGen pass sequence.
486//===----------------------------------------------------------------------===//
487
488void WebAssemblyPassConfig::addIRPasses() {
489 // Add signatures to prototype-less function declarations
491
492 // Lower .llvm.global_dtors into .llvm.global_ctors with __cxa_atexit calls.
494
495 // Fix function bitcasts, as WebAssembly requires caller and callee signatures
496 // to match.
498
499 // Optimize "returned" function attributes.
500 if (getOptLevel() != CodeGenOptLevel::None)
502
503 // If exception handling is not enabled and setjmp/longjmp handling is
504 // enabled, we lower invokes into calls and delete unreachable landingpad
505 // blocks. Lowering invokes when there is no EH support is done in
506 // TargetPassConfig::addPassesToHandleExceptions, but that runs after these IR
507 // passes and Emscripten SjLj handling expects all invokes to be lowered
508 // before.
509 if (!WasmEnableEmEH && !WasmEnableEH) {
510 addPass(createLowerInvokePass());
511 // The lower invoke pass may create unreachable code. Remove it in order not
512 // to process dead blocks in setjmp/longjmp handling.
514 }
515
516 // Handle exceptions and setjmp/longjmp if enabled. Unlike Wasm EH preparation
517 // done in WasmEHPrepare pass, Wasm SjLj preparation shares libraries and
518 // transformation algorithms with Emscripten SjLj, so we run
519 // LowerEmscriptenEHSjLj pass also when Wasm SjLj is enabled.
520 if (WasmEnableEmEH || WasmEnableEmSjLj || WasmEnableSjLj)
522
523 // Expand indirectbr instructions to switches.
525
527}
528
529void WebAssemblyPassConfig::addISelPrepare() {
530 // We need to move reference type allocas to WASM_ADDRESS_SPACE_VAR so that
531 // loads and stores are promoted to local.gets/local.sets.
533 // Lower atomics and TLS if necessary
534 addPass(new CoalesceFeaturesAndStripAtomics(&getWebAssemblyTargetMachine()));
535
536 // This is a no-op if atomics are not used in the module
538
540}
541
542bool WebAssemblyPassConfig::addInstSelector() {
544 addPass(
545 createWebAssemblyISelDag(getWebAssemblyTargetMachine(), getOptLevel()));
546 // Run the argument-move pass immediately after the ScheduleDAG scheduler
547 // so that we can fix up the ARGUMENT instructions before anything else
548 // sees them in the wrong place.
550 // Set the p2align operands. This information is present during ISel, however
551 // it's inconvenient to collect. Collect it now, and update the immediate
552 // operands.
554
555 // Eliminate range checks and add default targets to br_table instructions.
557
558 // unreachable is terminator, non-terminator instruction after it is not
559 // allowed.
561
562 return false;
563}
564
565void WebAssemblyPassConfig::addOptimizedRegAlloc() {
566 // Currently RegisterCoalesce degrades wasm debug info quality by a
567 // significant margin. As a quick fix, disable this for -O1, which is often
568 // used for debugging large applications. Disabling this increases code size
569 // of Emscripten core benchmarks by ~5%, which is acceptable for -O1, which is
570 // usually not used for production builds.
571 // TODO Investigate why RegisterCoalesce degrades debug info quality and fix
572 // it properly
573 if (getOptLevel() == CodeGenOptLevel::Less)
574 disablePass(&RegisterCoalescerID);
576}
577
578void WebAssemblyPassConfig::addPostRegAlloc() {
579 // TODO: The following CodeGen passes don't currently support code containing
580 // virtual registers. Consider removing their restrictions and re-enabling
581 // them.
582
583 // These functions all require the NoVRegs property.
584 disablePass(&MachineLateInstrsCleanupID);
585 disablePass(&MachineCopyPropagationID);
586 disablePass(&PostRAMachineSinkingID);
587 disablePass(&PostRASchedulerID);
588 disablePass(&FuncletLayoutID);
589 disablePass(&StackMapLivenessID);
590 disablePass(&PatchableFunctionID);
591 disablePass(&ShrinkWrapID);
592 disablePass(&RemoveLoadsIntoFakeUsesID);
593
594 // This pass hurts code size for wasm because it can generate irreducible
595 // control flow.
596 disablePass(&MachineBlockPlacementID);
597
599}
600
601void WebAssemblyPassConfig::addPreEmitPass() {
603
604 // Nullify DBG_VALUE_LISTs that we cannot handle.
606
607 // Eliminate multiple-entry loops.
610
611 // Do various transformations for exception handling.
612 // Every CFG-changing optimizations should come before this.
613 if (TM->Options.ExceptionModel == ExceptionHandling::Wasm)
615
616 // Now that we have a prologue and epilogue and all frame indices are
617 // rewritten, eliminate SP and FP. This allows them to be stackified,
618 // colored, and numbered with the rest of the registers.
620
621 // Preparations and optimizations related to register stackification.
622 if (getOptLevel() != CodeGenOptLevel::None) {
623 // Depend on LiveIntervals and perform some optimizations on it.
625
626 // Prepare memory intrinsic calls for register stackifying.
628 }
629
630 // Mark registers as representing wasm's value stack. This is a key
631 // code-compression technique in WebAssembly. We run this pass (and
632 // MemIntrinsicResults above) very late, so that it sees as much code as
633 // possible, including code emitted by PEI and expanded by late tail
634 // duplication.
635 addPass(createWebAssemblyRegStackify(getOptLevel()));
636
637 if (getOptLevel() != CodeGenOptLevel::None) {
638 // Run the register coloring pass to reduce the total number of registers.
639 // This runs after stackification so that it doesn't consider registers
640 // that become stackified.
642 }
643
644 // Sort the blocks of the CFG into topological order, a prerequisite for
645 // BLOCK and LOOP markers.
646 addPass(createWebAssemblyCFGSort());
647
648 // Insert BLOCK and LOOP markers.
650
651 // Insert explicit local.get and local.set operators.
654
655 // Lower br_unless into br_if.
657
658 // Perform the very last peephole optimizations on the code.
659 if (getOptLevel() != CodeGenOptLevel::None)
660 addPass(createWebAssemblyPeephole());
661
662 // Create a mapping from LLVM CodeGen virtual registers to wasm registers.
664
665 // Fix debug_values whose defs have been stackified.
668
669 // Collect information to prepare for MC lowering / asm printing.
671}
672
673bool WebAssemblyPassConfig::addPreISel() {
676 return false;
677}
678
679bool WebAssemblyPassConfig::addIRTranslator() {
680 addPass(new IRTranslator());
681 return false;
682}
683
684void WebAssemblyPassConfig::addPreLegalizeMachineIR() {
685 if (getOptLevel() != CodeGenOptLevel::None) {
687 }
688}
689bool WebAssemblyPassConfig::addLegalizeMachineIR() {
690 addPass(new Legalizer());
691 return false;
692}
693
694void WebAssemblyPassConfig::addPreRegBankSelect() {
695 if (getOptLevel() != CodeGenOptLevel::None) {
697 }
698}
699
700bool WebAssemblyPassConfig::addRegBankSelect() {
701 addPass(new RegBankSelect());
702 return false;
703}
704
705bool WebAssemblyPassConfig::addGlobalInstructionSelect() {
706 addPass(new InstructionSelect(getOptLevel()));
707
708 // We insert only if ISelDAG won't insert these at a later point.
709 if (isGlobalISelAbortEnabled()) {
714 }
715
716 return false;
717}
718
723
729
732 SMDiagnostic &Error, SMRange &SourceRange) const {
733 const auto &YamlMFI = static_cast<const yaml::WebAssemblyFunctionInfo &>(MFI);
734 MachineFunction &MF = PFS.MF;
735 MF.getInfo<WebAssemblyFunctionInfo>()->initializeBaseYamlFields(MF, YamlMFI);
736 return false;
737}
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))
static cl::opt< bool > WasmDisableFixIrreducibleControlFlowPass("wasm-disable-fix-irreducible-control-flow-pass", cl::Hidden, cl::desc("webassembly: disables the fix " " irreducible control flow optimization pass"), 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:180
@ WASM_FEATURE_PREFIX_DISALLOWED
Definition Wasm.h:181
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 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.