19658d1474
## Purpose This patch is one in a series of code-mods that annotate LLVM’s public interface for export. This patch annotates the `llvm/Target` library. These annotations currently have no meaningful impact on the LLVM build; however, they are a prerequisite to support an LLVM Windows DLL (shared library) build. ## Background This effort is tracked in #109483. Additional context is provided in [this discourse](https://discourse.llvm.org/t/psa-annotating-llvm-public-interface/85307), and documentation for `LLVM_ABI` and related annotations is found in the LLVM repo [here](https://github.com/llvm/llvm-project/blob/main/llvm/docs/InterfaceExportAnnotations.rst). A sub-set of these changes were generated automatically using the [Interface Definition Scanner (IDS)](https://github.com/compnerd/ids) tool, followed formatting with `git clang-format`. The bulk of this change is manual additions of `LLVM_ABI` to `LLVMInitializeX` functions defined in .cpp files under llvm/lib/Target. Adding `LLVM_ABI` to the function implementation is required here because they do not `#include "llvm/Support/TargetSelect.h"`, which contains the declarations for this functions and was already updated with `LLVM_ABI` in a previous patch. I considered patching these files with `#include "llvm/Support/TargetSelect.h"` instead, but since TargetSelect.h is a large file with a bunch of preprocessor x-macro stuff in it I was concerned it would unnecessarily impact compile times. In addition, a number of unit tests under llvm/unittests/Target required additional dependencies to make them build correctly against the LLVM DLL on Windows using MSVC. ## Validation Local builds and tests to validate cross-platform compatibility. This included llvm, clang, and lldb on the following configurations: - Windows with MSVC - Windows with Clang - Linux with GCC - Linux with Clang - Darwin with Clang
162 lines
6.2 KiB
C++
162 lines
6.2 KiB
C++
//===-- WebAssemblyMCTargetDesc.cpp - WebAssembly Target Descriptions -----===//
|
|
//
|
|
// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
|
|
// See https://llvm.org/LICENSE.txt for license information.
|
|
// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
|
|
//
|
|
//===----------------------------------------------------------------------===//
|
|
///
|
|
/// \file
|
|
/// This file provides WebAssembly-specific target descriptions.
|
|
///
|
|
//===----------------------------------------------------------------------===//
|
|
|
|
#include "MCTargetDesc/WebAssemblyMCTargetDesc.h"
|
|
#include "MCTargetDesc/WebAssemblyInstPrinter.h"
|
|
#include "MCTargetDesc/WebAssemblyMCAsmInfo.h"
|
|
#include "MCTargetDesc/WebAssemblyTargetStreamer.h"
|
|
#include "TargetInfo/WebAssemblyTargetInfo.h"
|
|
#include "llvm/MC/MCInstrInfo.h"
|
|
#include "llvm/MC/MCRegisterInfo.h"
|
|
#include "llvm/MC/MCSubtargetInfo.h"
|
|
#include "llvm/MC/TargetRegistry.h"
|
|
#include "llvm/Support/Compiler.h"
|
|
#include "llvm/Support/ErrorHandling.h"
|
|
using namespace llvm;
|
|
|
|
#define DEBUG_TYPE "wasm-mc-target-desc"
|
|
|
|
#define GET_INSTRINFO_MC_DESC
|
|
#define ENABLE_INSTR_PREDICATE_VERIFIER
|
|
#include "WebAssemblyGenInstrInfo.inc"
|
|
|
|
#define GET_SUBTARGETINFO_MC_DESC
|
|
#include "WebAssemblyGenSubtargetInfo.inc"
|
|
|
|
#define GET_REGINFO_MC_DESC
|
|
#include "WebAssemblyGenRegisterInfo.inc"
|
|
|
|
// Exception handling & setjmp-longjmp handling related options.
|
|
|
|
// Emscripten's asm.js-style exception handling
|
|
cl::opt<bool> WebAssembly::WasmEnableEmEH(
|
|
"enable-emscripten-cxx-exceptions",
|
|
cl::desc("WebAssembly Emscripten-style exception handling"),
|
|
cl::init(false));
|
|
// Emscripten's asm.js-style setjmp/longjmp handling
|
|
cl::opt<bool> WebAssembly::WasmEnableEmSjLj(
|
|
"enable-emscripten-sjlj",
|
|
cl::desc("WebAssembly Emscripten-style setjmp/longjmp handling"),
|
|
cl::init(false));
|
|
// Exception handling using wasm EH instructions
|
|
cl::opt<bool>
|
|
WebAssembly::WasmEnableEH("wasm-enable-eh",
|
|
cl::desc("WebAssembly exception handling"));
|
|
// setjmp/longjmp handling using wasm EH instrutions
|
|
cl::opt<bool> WebAssembly::WasmEnableSjLj(
|
|
"wasm-enable-sjlj", cl::desc("WebAssembly setjmp/longjmp handling"));
|
|
// If true, use the legacy Wasm EH proposal:
|
|
// https://github.com/WebAssembly/exception-handling/blob/main/proposals/exception-handling/legacy/Exceptions.md
|
|
// And if false, use the standardized Wasm EH proposal:
|
|
// https://github.com/WebAssembly/exception-handling/blob/main/proposals/exception-handling/Exceptions.md
|
|
// Currently set to true by default because not all major web browsers turn on
|
|
// the new standard proposal by default, but will later change to false.
|
|
cl::opt<bool> WebAssembly::WasmUseLegacyEH(
|
|
"wasm-use-legacy-eh", cl::desc("WebAssembly exception handling (legacy)"),
|
|
cl::init(true));
|
|
|
|
static MCAsmInfo *createMCAsmInfo(const MCRegisterInfo & /*MRI*/,
|
|
const Triple &TT,
|
|
const MCTargetOptions &Options) {
|
|
return new WebAssemblyMCAsmInfo(TT, Options);
|
|
}
|
|
|
|
static MCInstrInfo *createMCInstrInfo() {
|
|
auto *X = new MCInstrInfo();
|
|
InitWebAssemblyMCInstrInfo(X);
|
|
return X;
|
|
}
|
|
|
|
static MCRegisterInfo *createMCRegisterInfo(const Triple & /*T*/) {
|
|
auto *X = new MCRegisterInfo();
|
|
InitWebAssemblyMCRegisterInfo(X, 0);
|
|
return X;
|
|
}
|
|
|
|
static MCInstPrinter *createMCInstPrinter(const Triple & /*T*/,
|
|
unsigned SyntaxVariant,
|
|
const MCAsmInfo &MAI,
|
|
const MCInstrInfo &MII,
|
|
const MCRegisterInfo &MRI) {
|
|
assert(SyntaxVariant == 0 && "WebAssembly only has one syntax variant");
|
|
return new WebAssemblyInstPrinter(MAI, MII, MRI);
|
|
}
|
|
|
|
static MCCodeEmitter *createCodeEmitter(const MCInstrInfo &MCII,
|
|
MCContext &Ctx) {
|
|
return createWebAssemblyMCCodeEmitter(MCII, Ctx);
|
|
}
|
|
|
|
static MCAsmBackend *createAsmBackend(const Target & /*T*/,
|
|
const MCSubtargetInfo &STI,
|
|
const MCRegisterInfo & /*MRI*/,
|
|
const MCTargetOptions & /*Options*/) {
|
|
return createWebAssemblyAsmBackend(STI.getTargetTriple());
|
|
}
|
|
|
|
static MCSubtargetInfo *createMCSubtargetInfo(const Triple &TT, StringRef CPU,
|
|
StringRef FS) {
|
|
return createWebAssemblyMCSubtargetInfoImpl(TT, CPU, /*TuneCPU*/ CPU, FS);
|
|
}
|
|
|
|
static MCTargetStreamer *
|
|
createObjectTargetStreamer(MCStreamer &S, const MCSubtargetInfo &STI) {
|
|
return new WebAssemblyTargetWasmStreamer(S);
|
|
}
|
|
|
|
static MCTargetStreamer *
|
|
createAsmTargetStreamer(MCStreamer &S, formatted_raw_ostream &OS,
|
|
MCInstPrinter * /*InstPrint*/) {
|
|
return new WebAssemblyTargetAsmStreamer(S, OS);
|
|
}
|
|
|
|
static MCTargetStreamer *createNullTargetStreamer(MCStreamer &S) {
|
|
return new WebAssemblyTargetNullStreamer(S);
|
|
}
|
|
|
|
// Force static initialization.
|
|
extern "C" LLVM_ABI LLVM_EXTERNAL_VISIBILITY void
|
|
LLVMInitializeWebAssemblyTargetMC() {
|
|
for (Target *T :
|
|
{&getTheWebAssemblyTarget32(), &getTheWebAssemblyTarget64()}) {
|
|
// Register the MC asm info.
|
|
RegisterMCAsmInfoFn X(*T, createMCAsmInfo);
|
|
|
|
// Register the MC instruction info.
|
|
TargetRegistry::RegisterMCInstrInfo(*T, createMCInstrInfo);
|
|
|
|
// Register the MC register info.
|
|
TargetRegistry::RegisterMCRegInfo(*T, createMCRegisterInfo);
|
|
|
|
// Register the MCInstPrinter.
|
|
TargetRegistry::RegisterMCInstPrinter(*T, createMCInstPrinter);
|
|
|
|
// Register the MC code emitter.
|
|
TargetRegistry::RegisterMCCodeEmitter(*T, createCodeEmitter);
|
|
|
|
// Register the ASM Backend.
|
|
TargetRegistry::RegisterMCAsmBackend(*T, createAsmBackend);
|
|
|
|
// Register the MC subtarget info.
|
|
TargetRegistry::RegisterMCSubtargetInfo(*T, createMCSubtargetInfo);
|
|
|
|
// Register the object target streamer.
|
|
TargetRegistry::RegisterObjectTargetStreamer(*T,
|
|
createObjectTargetStreamer);
|
|
// Register the asm target streamer.
|
|
TargetRegistry::RegisterAsmTargetStreamer(*T, createAsmTargetStreamer);
|
|
// Register the null target streamer.
|
|
TargetRegistry::RegisterNullTargetStreamer(*T, createNullTargetStreamer);
|
|
}
|
|
}
|