Multivalue feature of WebAssembly has been standardized for several years now. I think it makes sense to be able to enable it in the feature section by default for our clang/llvm-produced binaries so that the multivalue feature can be used as necessary when necessary within our toolchain and also when running other optimizers (e.g. wasm-opt) after the LLVM code generation. But some WebAssembly toolchains, such as Emscripten, do not provide both mulvalue-returning and not-multivalue-returning versions of libraries. Also allowing the uses of multivalue in the features section does not necessarily mean we generate them whenever we can to the fullest, which is a different code generation / optimization option. So this makes the lowering of multivalue returns conditional on the use of 'experimental-mv' target ABI. This ABI is turned off by default and turned on by passing `-Xclang -target-abi -Xclang experimental-mv` to `clang`, or `-target-abi experimental-mv` to `clang -cc1` or `llc`. But the purpose of this PR is not tying the multivalue lowering to this specific 'experimental-mv'. 'experimental-mv' is just one multivalue ABI we currently have, and it is still experimental, meaning it is not very well optimized or tuned for performance. (e.g. it does not have the limitation of the max number of multivalue-lowered values, which can be detrimental to performance.) We may change the name of this ABI, or improve it, or add a new multivalue ABI in the future. Also I heard that WASI is planning to add their multivalue ABI soon. So the plan is, whenever any one of multivalue ABIs is enabled, we enable the lowering of multivalue returns in the backend. We currently have only 'experimental-mv' in the repo so we only check for that in this PR. Related past discussions: #82714 https://github.com/WebAssembly/tool-conventions/pull/223#issuecomment-2008298652
194 lines
6.7 KiB
C++
194 lines
6.7 KiB
C++
//===-- WebAssemblyUtilities.cpp - WebAssembly Utility Functions ----------===//
|
|
//
|
|
// 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 implements several utility functions for WebAssembly.
|
|
///
|
|
//===----------------------------------------------------------------------===//
|
|
|
|
#include "WebAssemblyUtilities.h"
|
|
#include "WebAssemblyMachineFunctionInfo.h"
|
|
#include "WebAssemblyTargetMachine.h"
|
|
#include "llvm/CodeGen/MachineInstr.h"
|
|
#include "llvm/CodeGen/MachineLoopInfo.h"
|
|
#include "llvm/IR/Function.h"
|
|
#include "llvm/MC/MCContext.h"
|
|
using namespace llvm;
|
|
|
|
// Function names in libc++abi and libunwind
|
|
const char *const WebAssembly::CxaBeginCatchFn = "__cxa_begin_catch";
|
|
const char *const WebAssembly::CxaRethrowFn = "__cxa_rethrow";
|
|
const char *const WebAssembly::StdTerminateFn = "_ZSt9terminatev";
|
|
const char *const WebAssembly::PersonalityWrapperFn =
|
|
"_Unwind_Wasm_CallPersonality";
|
|
|
|
/// Test whether MI is a child of some other node in an expression tree.
|
|
bool WebAssembly::isChild(const MachineInstr &MI,
|
|
const WebAssemblyFunctionInfo &MFI) {
|
|
if (MI.getNumOperands() == 0)
|
|
return false;
|
|
const MachineOperand &MO = MI.getOperand(0);
|
|
if (!MO.isReg() || MO.isImplicit() || !MO.isDef())
|
|
return false;
|
|
Register Reg = MO.getReg();
|
|
return Reg.isVirtual() && MFI.isVRegStackified(Reg);
|
|
}
|
|
|
|
bool WebAssembly::mayThrow(const MachineInstr &MI) {
|
|
switch (MI.getOpcode()) {
|
|
case WebAssembly::THROW:
|
|
case WebAssembly::THROW_S:
|
|
case WebAssembly::RETHROW:
|
|
case WebAssembly::RETHROW_S:
|
|
return true;
|
|
}
|
|
if (isCallIndirect(MI.getOpcode()))
|
|
return true;
|
|
if (!MI.isCall())
|
|
return false;
|
|
|
|
const MachineOperand &MO = getCalleeOp(MI);
|
|
assert(MO.isGlobal() || MO.isSymbol());
|
|
|
|
if (MO.isSymbol()) {
|
|
// Some intrinsics are lowered to calls to external symbols, which are then
|
|
// lowered to calls to library functions. Most of libcalls don't throw, but
|
|
// we only list some of them here now.
|
|
// TODO Consider adding 'nounwind' info in TargetLowering::CallLoweringInfo
|
|
// instead for more accurate info.
|
|
const char *Name = MO.getSymbolName();
|
|
if (strcmp(Name, "memcpy") == 0 || strcmp(Name, "memmove") == 0 ||
|
|
strcmp(Name, "memset") == 0)
|
|
return false;
|
|
return true;
|
|
}
|
|
|
|
const auto *F = dyn_cast<Function>(MO.getGlobal());
|
|
if (!F)
|
|
return true;
|
|
if (F->doesNotThrow())
|
|
return false;
|
|
// These functions never throw
|
|
if (F->getName() == CxaBeginCatchFn || F->getName() == PersonalityWrapperFn ||
|
|
F->getName() == StdTerminateFn)
|
|
return false;
|
|
|
|
// TODO Can we exclude call instructions that are marked as 'nounwind' in the
|
|
// original LLVm IR? (Even when the callee may throw)
|
|
return true;
|
|
}
|
|
|
|
const MachineOperand &WebAssembly::getCalleeOp(const MachineInstr &MI) {
|
|
switch (MI.getOpcode()) {
|
|
case WebAssembly::CALL:
|
|
case WebAssembly::CALL_S:
|
|
case WebAssembly::RET_CALL:
|
|
case WebAssembly::RET_CALL_S:
|
|
return MI.getOperand(MI.getNumExplicitDefs());
|
|
case WebAssembly::CALL_INDIRECT:
|
|
case WebAssembly::CALL_INDIRECT_S:
|
|
case WebAssembly::RET_CALL_INDIRECT:
|
|
case WebAssembly::RET_CALL_INDIRECT_S:
|
|
return MI.getOperand(MI.getNumExplicitOperands() - 1);
|
|
default:
|
|
llvm_unreachable("Not a call instruction");
|
|
}
|
|
}
|
|
|
|
MCSymbolWasm *WebAssembly::getOrCreateFunctionTableSymbol(
|
|
MCContext &Ctx, const WebAssemblySubtarget *Subtarget) {
|
|
StringRef Name = "__indirect_function_table";
|
|
MCSymbolWasm *Sym = cast_or_null<MCSymbolWasm>(Ctx.lookupSymbol(Name));
|
|
if (Sym) {
|
|
if (!Sym->isFunctionTable())
|
|
Ctx.reportError(SMLoc(), "symbol is not a wasm funcref table");
|
|
} else {
|
|
Sym = cast<MCSymbolWasm>(Ctx.getOrCreateSymbol(Name));
|
|
Sym->setFunctionTable();
|
|
// The default function table is synthesized by the linker.
|
|
Sym->setUndefined();
|
|
}
|
|
// MVP object files can't have symtab entries for tables.
|
|
if (!(Subtarget && Subtarget->hasReferenceTypes()))
|
|
Sym->setOmitFromLinkingSection();
|
|
return Sym;
|
|
}
|
|
|
|
MCSymbolWasm *WebAssembly::getOrCreateFuncrefCallTableSymbol(
|
|
MCContext &Ctx, const WebAssemblySubtarget *Subtarget) {
|
|
StringRef Name = "__funcref_call_table";
|
|
MCSymbolWasm *Sym = cast_or_null<MCSymbolWasm>(Ctx.lookupSymbol(Name));
|
|
if (Sym) {
|
|
if (!Sym->isFunctionTable())
|
|
Ctx.reportError(SMLoc(), "symbol is not a wasm funcref table");
|
|
} else {
|
|
Sym = cast<MCSymbolWasm>(Ctx.getOrCreateSymbol(Name));
|
|
|
|
// Setting Weak ensure only one table is left after linking when multiple
|
|
// modules define the table.
|
|
Sym->setWeak(true);
|
|
|
|
wasm::WasmLimits Limits = {0, 1, 1};
|
|
wasm::WasmTableType TableType = {wasm::ValType::FUNCREF, Limits};
|
|
Sym->setType(wasm::WASM_SYMBOL_TYPE_TABLE);
|
|
Sym->setTableType(TableType);
|
|
}
|
|
// MVP object files can't have symtab entries for tables.
|
|
if (!(Subtarget && Subtarget->hasReferenceTypes()))
|
|
Sym->setOmitFromLinkingSection();
|
|
return Sym;
|
|
}
|
|
|
|
// Find a catch instruction from an EH pad.
|
|
MachineInstr *WebAssembly::findCatch(MachineBasicBlock *EHPad) {
|
|
assert(EHPad->isEHPad());
|
|
auto Pos = EHPad->begin();
|
|
// Skip any label or debug instructions. Also skip 'end' marker instructions
|
|
// that may exist after marker placement in CFGStackify.
|
|
while (Pos != EHPad->end() &&
|
|
(Pos->isLabel() || Pos->isDebugInstr() || isMarker(Pos->getOpcode())))
|
|
Pos++;
|
|
if (Pos != EHPad->end() && WebAssembly::isCatch(Pos->getOpcode()))
|
|
return &*Pos;
|
|
return nullptr;
|
|
}
|
|
|
|
unsigned WebAssembly::getCopyOpcodeForRegClass(const TargetRegisterClass *RC) {
|
|
assert(RC != nullptr);
|
|
switch (RC->getID()) {
|
|
case WebAssembly::I32RegClassID:
|
|
return WebAssembly::COPY_I32;
|
|
case WebAssembly::I64RegClassID:
|
|
return WebAssembly::COPY_I64;
|
|
case WebAssembly::F32RegClassID:
|
|
return WebAssembly::COPY_F32;
|
|
case WebAssembly::F64RegClassID:
|
|
return WebAssembly::COPY_F64;
|
|
case WebAssembly::V128RegClassID:
|
|
return WebAssembly::COPY_V128;
|
|
case WebAssembly::FUNCREFRegClassID:
|
|
return WebAssembly::COPY_FUNCREF;
|
|
case WebAssembly::EXTERNREFRegClassID:
|
|
return WebAssembly::COPY_EXTERNREF;
|
|
default:
|
|
llvm_unreachable("Unexpected register class");
|
|
}
|
|
}
|
|
|
|
bool WebAssembly::canLowerMultivalueReturn(
|
|
const WebAssemblySubtarget *Subtarget) {
|
|
const auto &TM = static_cast<const WebAssemblyTargetMachine &>(
|
|
Subtarget->getTargetLowering()->getTargetMachine());
|
|
return Subtarget->hasMultivalue() && TM.usesMultivalueABI();
|
|
}
|
|
|
|
bool WebAssembly::canLowerReturn(size_t ResultSize,
|
|
const WebAssemblySubtarget *Subtarget) {
|
|
return ResultSize <= 1 || canLowerMultivalueReturn(Subtarget);
|
|
}
|