//===- Relocations.cpp ----------------------------------------------------===// // // 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 // //===----------------------------------------------------------------------===// #include "Relocations.h" #include "InputChunks.h" #include "OutputSegment.h" #include "SymbolTable.h" #include "SyntheticSections.h" using namespace llvm; using namespace llvm::wasm; namespace lld { namespace wasm { static bool requiresGOTAccess(const Symbol *sym) { if (!config->isPic) return false; if (sym->isHidden() || sym->isLocal()) return false; // With `-Bsymbolic` (or when building an executable) as don't need to use // the GOT for symbols that are defined within the current module. if (sym->isDefined() && (!config->shared || config->bsymbolic)) return false; return true; } static bool allowUndefined(const Symbol* sym) { // Undefined functions and globals with explicit import name are allowed to be // undefined at link time. if (auto *f = dyn_cast(sym)) if (f->importName) return true; if (auto *g = dyn_cast(sym)) if (g->importName) return true; if (auto *g = dyn_cast(sym)) if (g->importName) return true; return config->allowUndefinedSymbols.count(sym->getName()) != 0; } static void reportUndefined(Symbol *sym) { if (!allowUndefined(sym)) { switch (config->unresolvedSymbols) { case UnresolvedPolicy::ReportError: error(toString(sym->getFile()) + ": undefined symbol: " + toString(*sym)); break; case UnresolvedPolicy::Warn: warn(toString(sym->getFile()) + ": undefined symbol: " + toString(*sym)); break; case UnresolvedPolicy::Ignore: if (auto *f = dyn_cast(sym)) { if (!f->stubFunction) { LLVM_DEBUG(dbgs() << "ignoring undefined symbol: " + toString(*sym) + "\n"); f->stubFunction = symtab->createUndefinedStub(*f->getSignature()); f->stubFunction->markLive(); // Mark the function itself as a stub which prevents it from being // assigned a table entry. f->isStub = true; } } break; case UnresolvedPolicy::ImportFuncs: break; } } } static void addGOTEntry(Symbol *sym) { if (requiresGOTAccess(sym)) out.importSec->addGOTEntry(sym); else out.globalSec->addInternalGOTEntry(sym); } void scanRelocations(InputChunk *chunk) { if (!chunk->live) return; ObjFile *file = chunk->file; ArrayRef types = file->getWasmObj()->types(); for (const WasmRelocation &reloc : chunk->getRelocations()) { if (reloc.Type == R_WASM_TYPE_INDEX_LEB) { // Mark target type as live file->typeMap[reloc.Index] = out.typeSec->registerType(types[reloc.Index]); file->typeIsUsed[reloc.Index] = true; continue; } // Other relocation types all have a corresponding symbol Symbol *sym = file->getSymbols()[reloc.Index]; switch (reloc.Type) { case R_WASM_TABLE_INDEX_I32: case R_WASM_TABLE_INDEX_I64: case R_WASM_TABLE_INDEX_SLEB: case R_WASM_TABLE_INDEX_SLEB64: case R_WASM_TABLE_INDEX_REL_SLEB: if (requiresGOTAccess(sym)) break; out.elemSec->addEntry(cast(sym)); break; case R_WASM_GLOBAL_INDEX_LEB: case R_WASM_GLOBAL_INDEX_I32: if (!isa(sym)) addGOTEntry(sym); break; case R_WASM_MEMORY_ADDR_TLS_SLEB: if (auto *D = dyn_cast(sym)) { if (D->segment->outputSeg->name != ".tdata") { error(toString(file) + ": relocation " + relocTypeToString(reloc.Type) + " cannot be used against `" + toString(*sym) + "` in non-TLS section: " + D->segment->outputSeg->name); } } break; } if (config->isPic) { switch (reloc.Type) { case R_WASM_TABLE_INDEX_SLEB: case R_WASM_TABLE_INDEX_SLEB64: case R_WASM_MEMORY_ADDR_SLEB: case R_WASM_MEMORY_ADDR_LEB: case R_WASM_MEMORY_ADDR_SLEB64: case R_WASM_MEMORY_ADDR_LEB64: // Certain relocation types can't be used when building PIC output, // since they would require absolute symbol addresses at link time. error(toString(file) + ": relocation " + relocTypeToString(reloc.Type) + " cannot be used against symbol " + toString(*sym) + "; recompile with -fPIC"); break; case R_WASM_TABLE_INDEX_I32: case R_WASM_TABLE_INDEX_I64: case R_WASM_MEMORY_ADDR_I32: case R_WASM_MEMORY_ADDR_I64: // These relocation types are only present in the data section and // will be converted into code by `generateRelocationCode`. This code // requires the symbols to have GOT entires. if (requiresGOTAccess(sym)) addGOTEntry(sym); break; } } else { // Report undefined symbols if (sym->isUndefined() && !config->relocatable && !sym->isWeak()) reportUndefined(sym); } } } } // namespace wasm } // namespace lld