//===- DlltoolDriver.cpp - dlltool.exe-compatible driver ------------------===// // // 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 // //===----------------------------------------------------------------------===// // // Defines an interface to a dlltool.exe-compatible driver. // //===----------------------------------------------------------------------===// #include "llvm/ToolDrivers/llvm-dlltool/DlltoolDriver.h" #include "llvm/ADT/StringSwitch.h" #include "llvm/Object/COFF.h" #include "llvm/Object/COFFImportFile.h" #include "llvm/Object/COFFModuleDefinition.h" #include "llvm/Option/Arg.h" #include "llvm/Option/ArgList.h" #include "llvm/Option/OptTable.h" #include "llvm/Option/Option.h" #include "llvm/Support/Path.h" #include "llvm/TargetParser/Host.h" #include #include using namespace llvm; using namespace llvm::object; using namespace llvm::COFF; namespace { enum { OPT_INVALID = 0, #define OPTION(...) LLVM_MAKE_OPT_ID(__VA_ARGS__), #include "Options.inc" #undef OPTION }; #define PREFIX(NAME, VALUE) \ static constexpr StringLiteral NAME##_init[] = VALUE; \ static constexpr ArrayRef NAME(NAME##_init, \ std::size(NAME##_init) - 1); #include "Options.inc" #undef PREFIX using namespace llvm::opt; static constexpr opt::OptTable::Info InfoTable[] = { #define OPTION(...) LLVM_CONSTRUCT_OPT_INFO(__VA_ARGS__), #include "Options.inc" #undef OPTION }; class DllOptTable : public opt::GenericOptTable { public: DllOptTable() : opt::GenericOptTable(InfoTable, false) {} }; // Opens a file. Path has to be resolved already. std::unique_ptr openFile(const Twine &Path) { ErrorOr> MB = MemoryBuffer::getFile(Path); if (std::error_code EC = MB.getError()) { llvm::errs() << "cannot open file " << Path << ": " << EC.message() << "\n"; return nullptr; } return std::move(*MB); } MachineTypes getEmulation(StringRef S) { return StringSwitch(S) .Case("i386", IMAGE_FILE_MACHINE_I386) .Case("i386:x86-64", IMAGE_FILE_MACHINE_AMD64) .Case("arm", IMAGE_FILE_MACHINE_ARMNT) .Case("arm64", IMAGE_FILE_MACHINE_ARM64) .Case("arm64ec", IMAGE_FILE_MACHINE_ARM64EC) .Default(IMAGE_FILE_MACHINE_UNKNOWN); } MachineTypes getMachine(Triple T) { switch (T.getArch()) { case Triple::x86: return COFF::IMAGE_FILE_MACHINE_I386; case Triple::x86_64: return COFF::IMAGE_FILE_MACHINE_AMD64; case Triple::arm: return COFF::IMAGE_FILE_MACHINE_ARMNT; case Triple::aarch64: return T.isWindowsArm64EC() ? COFF::IMAGE_FILE_MACHINE_ARM64EC : COFF::IMAGE_FILE_MACHINE_ARM64; default: return COFF::IMAGE_FILE_MACHINE_UNKNOWN; } } MachineTypes getDefaultMachine() { return getMachine(Triple(sys::getDefaultTargetTriple())); } std::optional getPrefix(StringRef Argv0) { StringRef ProgName = llvm::sys::path::stem(Argv0); // x86_64-w64-mingw32-dlltool -> x86_64-w64-mingw32 // llvm-dlltool -> None // aarch64-w64-mingw32-llvm-dlltool-10.exe -> aarch64-w64-mingw32 ProgName = ProgName.rtrim("0123456789.-"); if (!ProgName.consume_back_insensitive("dlltool")) return std::nullopt; ProgName.consume_back_insensitive("llvm-"); ProgName.consume_back_insensitive("-"); return ProgName.str(); } bool parseModuleDefinition(StringRef DefFileName, MachineTypes Machine, bool AddUnderscores, std::vector &Exports, std::string &OutputFile) { std::unique_ptr MB = openFile(DefFileName); if (!MB) return false; if (!MB->getBufferSize()) { llvm::errs() << "definition file empty\n"; return false; } Expected Def = parseCOFFModuleDefinition( *MB, Machine, /*MingwDef=*/true, AddUnderscores); if (!Def) { llvm::errs() << "error parsing definition\n" << errorToErrorCode(Def.takeError()).message() << "\n"; return false; } if (OutputFile.empty()) OutputFile = std::move(Def->OutputFile); // If ExtName is set (if the "ExtName = Name" syntax was used), overwrite // Name with ExtName and clear ExtName. When only creating an import // library and not linking, the internal name is irrelevant. This avoids // cases where writeImportLibrary tries to transplant decoration from // symbol decoration onto ExtName. for (COFFShortExport &E : Def->Exports) { if (!E.ExtName.empty()) { E.Name = E.ExtName; E.ExtName.clear(); } } Exports = std::move(Def->Exports); return true; } } // namespace int llvm::dlltoolDriverMain(llvm::ArrayRef ArgsArr) { DllOptTable Table; unsigned MissingIndex; unsigned MissingCount; llvm::opt::InputArgList Args = Table.ParseArgs(ArgsArr.slice(1), MissingIndex, MissingCount); if (MissingCount) { llvm::errs() << Args.getArgString(MissingIndex) << ": missing argument\n"; return 1; } // Handle when no input or output is specified if (Args.hasArgNoClaim(OPT_INPUT) || (!Args.hasArgNoClaim(OPT_d) && !Args.hasArgNoClaim(OPT_l))) { Table.printHelp(outs(), "llvm-dlltool [options] file...", "llvm-dlltool", false); llvm::outs() << "\nTARGETS: i386, i386:x86-64, arm, arm64, arm64ec\n"; return 1; } for (auto *Arg : Args.filtered(OPT_UNKNOWN)) llvm::errs() << "ignoring unknown argument: " << Arg->getAsString(Args) << "\n"; if (!Args.hasArg(OPT_d)) { llvm::errs() << "no definition file specified\n"; return 1; } COFF::MachineTypes Machine = getDefaultMachine(); if (std::optional Prefix = getPrefix(ArgsArr[0])) { Triple T(*Prefix); if (T.getArch() != Triple::UnknownArch) Machine = getMachine(T); } if (auto *Arg = Args.getLastArg(OPT_m)) Machine = getEmulation(Arg->getValue()); if (Machine == IMAGE_FILE_MACHINE_UNKNOWN) { llvm::errs() << "unknown target\n"; return 1; } bool AddUnderscores = !Args.hasArg(OPT_no_leading_underscore); std::string OutputFile; if (auto *Arg = Args.getLastArg(OPT_D)) OutputFile = Arg->getValue(); std::vector Exports, NativeExports; if (Args.hasArg(OPT_N)) { if (!isArm64EC(Machine)) { llvm::errs() << "native .def file is supported only on arm64ec target\n"; return 1; } if (!parseModuleDefinition(Args.getLastArg(OPT_N)->getValue(), IMAGE_FILE_MACHINE_ARM64, AddUnderscores, NativeExports, OutputFile)) return 1; } if (!parseModuleDefinition(Args.getLastArg(OPT_d)->getValue(), Machine, AddUnderscores, Exports, OutputFile)) return 1; if (OutputFile.empty()) { llvm::errs() << "no DLL name specified\n"; return 1; } if (Machine == IMAGE_FILE_MACHINE_I386 && Args.hasArg(OPT_k)) { for (COFFShortExport &E : Exports) { if (!E.ImportName.empty() || (!E.Name.empty() && E.Name[0] == '?')) continue; E.SymbolName = E.Name; // Trim off the trailing decoration. Symbols will always have a // starting prefix here (either _ for cdecl/stdcall, @ for fastcall // or ? for C++ functions). Vectorcall functions won't have any // fixed prefix, but the function base name will still be at least // one char. E.Name = E.Name.substr(0, E.Name.find('@', 1)); // By making sure E.SymbolName != E.Name for decorated symbols, // writeImportLibrary writes these symbols with the type // IMPORT_NAME_UNDECORATE. } } std::string Path = std::string(Args.getLastArgValue(OPT_l)); if (!Path.empty() && writeImportLibrary(OutputFile, Path, Exports, Machine, /*MinGW=*/true, NativeExports)) return 1; return 0; }