//===- Driver.cpp ---------------------------------------------------------===// // // The LLVM Linker // // This file is distributed under the University of Illinois Open Source // License. See LICENSE.TXT for details. // //===----------------------------------------------------------------------===// #include "Driver.h" #include "Config.h" #include "Error.h" #include "InputFiles.h" #include "SymbolTable.h" #include "Target.h" #include "Writer.h" #include "llvm/ADT/STLExtras.h" #include "llvm/ADT/StringExtras.h" #include "llvm/Support/raw_ostream.h" #include using namespace llvm; using namespace llvm::ELF; using namespace llvm::object; using namespace lld; using namespace lld::elf2; Configuration *lld::elf2::Config; LinkerDriver *lld::elf2::Driver; void lld::elf2::link(ArrayRef Args) { Configuration C; LinkerDriver D; Config = &C; Driver = &D; Driver->main(Args.slice(1)); } static std::pair parseEmulation(StringRef S) { if (S == "elf32btsmip") return {ELF32BEKind, EM_MIPS}; if (S == "elf32ltsmip") return {ELF32LEKind, EM_MIPS}; if (S == "elf32ppc") return {ELF32BEKind, EM_PPC}; if (S == "elf64ppc") return {ELF64BEKind, EM_PPC64}; if (S == "elf_i386") return {ELF32LEKind, EM_386}; if (S == "elf_x86_64") return {ELF64LEKind, EM_X86_64}; if (S == "aarch64linux") return {ELF64LEKind, EM_AARCH64}; if (S == "i386pe" || S == "i386pep" || S == "thumb2pe") error("Windows targets are not supported on the ELF frontend: " + S); error("Unknown emulation: " + S); } // Opens and parses a file. Path has to be resolved already. // Newly created memory buffers are owned by this driver. void LinkerDriver::addFile(StringRef Path) { using namespace llvm::sys::fs; if (Config->Verbose) llvm::outs() << Path << "\n"; auto MBOrErr = MemoryBuffer::getFile(Path); error(MBOrErr, "cannot open " + Path); std::unique_ptr &MB = *MBOrErr; MemoryBufferRef MBRef = MB->getMemBufferRef(); OwningMBs.push_back(std::move(MB)); // take MB ownership switch (identify_magic(MBRef.getBuffer())) { case file_magic::unknown: readLinkerScript(&Alloc, MBRef); return; case file_magic::archive: if (WholeArchive) { auto File = make_unique(MBRef); for (MemoryBufferRef &MB : File->getMembers()) Files.push_back(createELFFile(MB)); OwningArchives.emplace_back(std::move(File)); return; } Files.push_back(make_unique(MBRef)); return; case file_magic::elf_shared_object: Files.push_back(createELFFile(MBRef)); return; default: Files.push_back(createELFFile(MBRef)); } } static StringRef getString(opt::InputArgList &Args, unsigned Key, StringRef Default = "") { if (auto *Arg = Args.getLastArg(Key)) return Arg->getValue(); return Default; } static bool hasZOption(opt::InputArgList &Args, StringRef Key) { for (auto *Arg : Args.filtered(OPT_z)) if (Key == Arg->getValue()) return true; return false; } void LinkerDriver::main(ArrayRef ArgsArr) { initSymbols(); opt::InputArgList Args = parseArgs(&Alloc, ArgsArr); createFiles(Args); // Traditional linkers can generate re-linkable object files instead // of executables or DSOs. We don't support that since the feature // does not seem to provide more value than the static archiver. if (Args.hasArg(OPT_relocatable)) error("-r option is not supported. Use 'ar' command instead."); switch (Config->EKind) { case ELF32LEKind: link(Args); return; case ELF32BEKind: link(Args); return; case ELF64LEKind: link(Args); return; case ELF64BEKind: link(Args); return; default: error("-m or at least a .o file required"); } } void LinkerDriver::createFiles(opt::InputArgList &Args) { for (auto *Arg : Args.filtered(OPT_L)) Config->SearchPaths.push_back(Arg->getValue()); std::vector RPaths; for (auto *Arg : Args.filtered(OPT_rpath)) RPaths.push_back(Arg->getValue()); if (!RPaths.empty()) Config->RPath = llvm::join(RPaths.begin(), RPaths.end(), ":"); if (auto *Arg = Args.getLastArg(OPT_m)) { StringRef S = Arg->getValue(); std::pair P = parseEmulation(S); Config->EKind = P.first; Config->EMachine = P.second; Config->Emulation = S; } Config->AllowMultipleDefinition = Args.hasArg(OPT_allow_multiple_definition); Config->Bsymbolic = Args.hasArg(OPT_Bsymbolic); Config->DiscardAll = Args.hasArg(OPT_discard_all); Config->DiscardLocals = Args.hasArg(OPT_discard_locals); Config->DiscardNone = Args.hasArg(OPT_discard_none); Config->EnableNewDtags = !Args.hasArg(OPT_disable_new_dtags); Config->ExportDynamic = Args.hasArg(OPT_export_dynamic); Config->GcSections = Args.hasArg(OPT_gc_sections); Config->NoInhibitExec = Args.hasArg(OPT_noinhibit_exec); Config->NoUndefined = Args.hasArg(OPT_no_undefined); Config->PrintGcSections = Args.hasArg(OPT_print_gc_sections); Config->Shared = Args.hasArg(OPT_shared); Config->StripAll = Args.hasArg(OPT_strip_all); Config->Verbose = Args.hasArg(OPT_verbose); Config->DynamicLinker = getString(Args, OPT_dynamic_linker); Config->Entry = getString(Args, OPT_entry); Config->Fini = getString(Args, OPT_fini, "_fini"); Config->Init = getString(Args, OPT_init, "_init"); Config->OutputFile = getString(Args, OPT_o); Config->SoName = getString(Args, OPT_soname); Config->Sysroot = getString(Args, OPT_sysroot); Config->ZExecStack = hasZOption(Args, "execstack"); Config->ZNodelete = hasZOption(Args, "nodelete"); Config->ZNow = hasZOption(Args, "now"); Config->ZOrigin = hasZOption(Args, "origin"); Config->ZRelro = !hasZOption(Args, "norelro"); if (auto *Arg = Args.getLastArg(OPT_O)) { StringRef Val = Arg->getValue(); if (Val.getAsInteger(10, Config->Optimize)) error("Invalid optimization level"); } if (auto *Arg = Args.getLastArg(OPT_hash_style)) { StringRef S = Arg->getValue(); if (S == "gnu") { Config->GnuHash = true; Config->SysvHash = false; } else if (S == "both") { Config->GnuHash = true; } else if (S != "sysv") error("Unknown hash style: " + S); } for (auto *Arg : Args.filtered(OPT_undefined)) Config->Undefined.push_back(Arg->getValue()); for (auto *Arg : Args) { switch (Arg->getOption().getID()) { case OPT_l: addFile(searchLibrary(Arg->getValue())); break; case OPT_INPUT: case OPT_script: addFile(Arg->getValue()); break; case OPT_as_needed: Config->AsNeeded = true; break; case OPT_no_as_needed: Config->AsNeeded = false; break; case OPT_Bstatic: Config->Static = true; break; case OPT_Bdynamic: Config->Static = false; break; case OPT_whole_archive: WholeArchive = true; break; case OPT_no_whole_archive: WholeArchive = false; break; } } if (Files.empty()) error("no input files."); if (Config->GnuHash && Config->EMachine == EM_MIPS) error("The .gnu.hash section is not compatible with the MIPS target."); } template void LinkerDriver::link(opt::InputArgList &Args) { SymbolTable Symtab; Target.reset(createTarget()); if (!Config->Shared) { // Add entry symbol. if (Config->Entry.empty()) Config->Entry = (Config->EMachine == EM_MIPS) ? "__start" : "_start"; // In the assembly for 32 bit x86 the _GLOBAL_OFFSET_TABLE_ symbol // is magical and is used to produce a R_386_GOTPC relocation. // The R_386_GOTPC relocation value doesn't actually depend on the // symbol value, so it could use an index of STN_UNDEF which, according // to the spec, means the symbol value is 0. // Unfortunately both gas and MC keep the _GLOBAL_OFFSET_TABLE_ symbol in // the object file. // The situation is even stranger on x86_64 where the assembly doesn't // need the magical symbol, but gas still puts _GLOBAL_OFFSET_TABLE_ as // an undefined symbol in the .o files. // Given that the symbol is effectively unused, we just create a dummy // hidden one to avoid the undefined symbol error. Symtab.addIgnored("_GLOBAL_OFFSET_TABLE_"); } if (!Config->Entry.empty()) { // Set either EntryAddr (if S is a number) or EntrySym (otherwise). StringRef S = Config->Entry; if (S.getAsInteger(0, Config->EntryAddr)) Config->EntrySym = Symtab.addUndefined(S); } if (Config->EMachine == EM_MIPS) { // On MIPS O32 ABI, _gp_disp is a magic symbol designates offset between // start of function and gp pointer into GOT. Config->MipsGpDisp = Symtab.addIgnored("_gp_disp"); // Define _gp for MIPS. st_value of _gp symbol will be updated by Writer // so that it points to an absolute address which is relative to GOT. // See "Global Data Symbols" in Chapter 6 in the following document: // ftp://www.linux-mips.org/pub/linux/mips/doc/ABI/mipsabi.pdf Symtab.addAbsolute("_gp", ElfSym::MipsGp); } for (std::unique_ptr &F : Files) Symtab.addFile(std::move(F)); for (StringRef S : Config->Undefined) Symtab.addUndefinedOpt(S); if (Config->OutputFile.empty()) Config->OutputFile = "a.out"; // Write the result to the file. Symtab.scanShlibUndefined(); if (Config->GcSections) markLive(&Symtab); writeResult(&Symtab); }