//===- lib/Driver/WinLinkDriver.cpp ---------------------------------------===// // // The LLVM Linker // // This file is distributed under the University of Illinois Open Source // License. See LICENSE.TXT for details. // //===----------------------------------------------------------------------===// /// /// \file /// /// Concrete instance of the Driver for Windows link.exe. /// //===----------------------------------------------------------------------===// #include #include #include "llvm/ADT/SmallString.h" #include "llvm/ADT/StringSwitch.h" #include "llvm/Option/Arg.h" #include "llvm/Option/Option.h" #include "llvm/Support/Path.h" #include "lld/Driver/Driver.h" #include "lld/ReaderWriter/PECOFFTargetInfo.h" namespace lld { namespace { // Create enum with OPT_xxx values for each option in WinLinkOptions.td enum WinLinkOpt { OPT_INVALID = 0, #define OPTION(PREFIX, NAME, ID, KIND, GROUP, ALIAS, FLAGS, PARAM, HELP, META) \ OPT_##ID, #include "WinLinkOptions.inc" LastOption #undef OPTION }; // Create prefix string literals used in WinLinkOptions.td #define PREFIX(NAME, VALUE) const char *const NAME[] = VALUE; #include "WinLinkOptions.inc" #undef PREFIX // Create table mapping all options defined in WinLinkOptions.td static const llvm::opt::OptTable::Info infoTable[] = { #define OPTION(PREFIX, NAME, ID, KIND, GROUP, ALIAS, FLAGS, PARAM, \ HELPTEXT, METAVAR) \ { PREFIX, NAME, HELPTEXT, METAVAR, OPT_##ID, llvm::opt::Option::KIND##Class, \ PARAM, FLAGS, OPT_##GROUP, OPT_##ALIAS }, #include "WinLinkOptions.inc" #undef OPTION }; // Create OptTable class for parsing actual command line arguments class WinLinkOptTable : public llvm::opt::OptTable { public: WinLinkOptTable() : OptTable(infoTable, llvm::array_lengthof(infoTable)){} }; // Returns the index of "--" or -1 if not found. int findDoubleDash(int argc, const char *argv[]) { for (int i = 0; i < argc; ++i) if (std::strcmp(argv[i], "--") == 0) return i; return -1; } // Displays error message if the given version does not match with // /^\d+$/. bool checkNumber(StringRef version, const char *errorMessage, raw_ostream &diagnostics) { if (version.str().find_first_not_of("0123456789") != std::string::npos || version.empty()) { diagnostics << "error: " << errorMessage << version << "\n"; return false; } return true; } // Parse an argument for -base, -stack or -heap. The expected string // is "[,]". bool parseMemoryOption(const StringRef &arg, raw_ostream &diagnostics, uint64_t &reserve, uint64_t &commit) { StringRef reserveStr, commitStr; llvm::tie(reserveStr, commitStr) = arg.split(','); if (!checkNumber(reserveStr, "invalid size: ", diagnostics)) return false; reserve = atoi(reserveStr.str().c_str()); if (!commitStr.empty()) { if (!checkNumber(commitStr, "invalid size: ", diagnostics)) return false; commit = atoi(commitStr.str().c_str()); } return true; } // Parse -base command line option. The argument for the parameter is in the // form of "
[:]". bool parseBaseOption(PECOFFTargetInfo &info, const StringRef &arg, raw_ostream &diagnostics) { // Size should be set to SizeOfImage field in the COFF header, and if it's // smaller than the actual size, the linker should warn about that. Currently // we just ignore the value of size parameter. uint64_t addr, size; if (!parseMemoryOption(arg, diagnostics, addr, size)) return false; // It's an error if the base address is not multiple of 64K. if (addr & 0xffff) { diagnostics << "Base address have to be multiple of 64K, but got " << addr << "\n"; return false; } info.setBaseAddress(addr); return true; } // Parse -stack command line option bool parseStackOption(PECOFFTargetInfo &info, const StringRef &arg, raw_ostream &diagnostics) { uint64_t reserve; uint64_t commit = info.getStackCommit(); if (!parseMemoryOption(arg, diagnostics, reserve, commit)) return false; info.setStackReserve(reserve); info.setStackCommit(commit); return true; } // Parse -heap command line option. bool parseHeapOption(PECOFFTargetInfo &info, const StringRef &arg, raw_ostream &diagnostics) { uint64_t reserve; uint64_t commit = info.getHeapCommit(); if (!parseMemoryOption(arg, diagnostics, reserve, commit)) return false; info.setHeapReserve(reserve); info.setHeapCommit(commit); return true; } // Returns subsystem type for the given string. llvm::COFF::WindowsSubsystem stringToWinSubsystem(StringRef str) { std::string arg(str.lower()); return llvm::StringSwitch(arg) .Case("windows", llvm::COFF::IMAGE_SUBSYSTEM_WINDOWS_GUI) .Case("console", llvm::COFF::IMAGE_SUBSYSTEM_WINDOWS_CUI) .Default(llvm::COFF::IMAGE_SUBSYSTEM_UNKNOWN); } bool parseMinOSVersion(PECOFFTargetInfo &info, const StringRef &osVersion, raw_ostream &diagnostics) { StringRef majorVersion, minorVersion; llvm::tie(majorVersion, minorVersion) = osVersion.split('.'); if (minorVersion.empty()) minorVersion = "0"; if (!checkNumber(majorVersion, "invalid OS major version: ", diagnostics)) return false; if (!checkNumber(minorVersion, "invalid OS minor version: ", diagnostics)) return false; PECOFFTargetInfo::OSVersion minOSVersion(atoi(majorVersion.str().c_str()), atoi(minorVersion.str().c_str())); info.setMinOSVersion(minOSVersion); return true; } // Parse -subsystem command line option. The form of -subsystem is // "subsystem_name[,majorOSVersion[.minorOSVersion]]". bool parseSubsystemOption(PECOFFTargetInfo &info, std::string arg, raw_ostream &diagnostics) { StringRef subsystemStr, osVersionStr; llvm::tie(subsystemStr, osVersionStr) = StringRef(arg).split(','); // Parse optional OS version if exists. if (!osVersionStr.empty()) if (!parseMinOSVersion(info, osVersionStr, diagnostics)) return false; // Parse subsystem name. llvm::COFF::WindowsSubsystem subsystem = stringToWinSubsystem(subsystemStr); if (subsystem == llvm::COFF::IMAGE_SUBSYSTEM_UNKNOWN) { diagnostics << "error: unknown subsystem name: " << subsystemStr << "\n"; return false; } info.setSubsystem(subsystem); return true; } // Replace a file extension with ".exe". If the given file has no // extension, just add ".exe". StringRef getDefaultOutputFileName(PECOFFTargetInfo &info, StringRef path) { SmallString<128> smallStr = path; llvm::sys::path::replace_extension(smallStr, ".exe"); return info.allocateString(smallStr.str()); } // Split the given string with spaces. std::vector splitArgList(std::string str) { std::stringstream stream(str); std::istream_iterator begin(stream); std::istream_iterator end; return std::vector(begin, end); } // Split the given string with the path separator. std::vector splitPathList(StringRef str) { std::vector ret; while (!str.empty()) { StringRef path; llvm::tie(path, str) = str.split(';'); ret.push_back(path); } return std::move(ret); } // Process "LINK" environment variable. If defined, the value of the variable // should be processed as command line arguments. std::vector processLinkEnv(PECOFFTargetInfo &info, int argc, const char **argv) { std::vector ret; // The first argument is the name of the command. This should stay at the head // of the argument list. assert(argc > 0); ret.push_back(argv[0]); // Add arguments specified by the LINK environment variable. if (char *envp = ::getenv("LINK")) for (std::string &arg : splitArgList(envp)) ret.push_back(info.allocateString(arg).data()); // Add the rest of arguments passed via the command line. for (int i = 1; i < argc; ++i) ret.push_back(argv[i]); ret.push_back(nullptr); return std::move(ret); } // Process "LIB" environment variable. The variable contains a list of search // paths separated by semicolons. void processLibEnv(PECOFFTargetInfo &info) { if (char *envp = ::getenv("LIB")) for (StringRef path : splitPathList(envp)) info.appendInputSearchPath(info.allocateString(path)); } } // namespace bool WinLinkDriver::linkPECOFF(int argc, const char *argv[], raw_ostream &diagnostics) { PECOFFTargetInfo info; std::vector newargv = processLinkEnv(info, argc, argv); processLibEnv(info); if (parse(newargv.size() - 1, &newargv[0], info, diagnostics)) return true; return link(info, diagnostics); } bool WinLinkDriver::parse(int argc, const char *argv[], PECOFFTargetInfo &info, raw_ostream &diagnostics) { // Arguments after "--" are interpreted as filenames even if they start with // a hyphen or a slash. This is not compatible with link.exe but useful for // us to test lld on Unix. int doubleDashPosition = findDoubleDash(argc, argv); int argEnd = (doubleDashPosition > 0) ? doubleDashPosition : argc; // Parse command line options using WinLinkOptions.td std::unique_ptr parsedArgs; WinLinkOptTable table; unsigned missingIndex; unsigned missingCount; parsedArgs.reset( table.ParseArgs(&argv[1], &argv[argEnd], missingIndex, missingCount)); if (missingCount) { diagnostics << "error: missing arg value for '" << parsedArgs->getArgString(missingIndex) << "' expected " << missingCount << " argument(s).\n"; return true; } // Handle -help if (parsedArgs->getLastArg(OPT_help)) { table.PrintHelp(llvm::outs(), argv[0], "LLVM Linker", false); return true; } // Show warning for unknown arguments for (auto it = parsedArgs->filtered_begin(OPT_UNKNOWN), ie = parsedArgs->filtered_end(); it != ie; ++it) { diagnostics << "warning: ignoring unknown argument: " << (*it)->getAsString(*parsedArgs) << "\n"; } // Copy -mllvm for (llvm::opt::arg_iterator it = parsedArgs->filtered_begin(OPT_mllvm), ie = parsedArgs->filtered_end(); it != ie; ++it) { info.appendLLVMOption((*it)->getValue()); } // Handle -base if (llvm::opt::Arg *arg = parsedArgs->getLastArg(OPT_base)) if (!parseBaseOption(info, arg->getValue(), diagnostics)) return true; // Handle -stack if (llvm::opt::Arg *arg = parsedArgs->getLastArg(OPT_stack)) if (!parseStackOption(info, arg->getValue(), diagnostics)) return true; // Handle -heap if (llvm::opt::Arg *arg = parsedArgs->getLastArg(OPT_heap)) if (!parseHeapOption(info, arg->getValue(), diagnostics)) return true; // Handle -subsystem if (llvm::opt::Arg *arg = parsedArgs->getLastArg(OPT_subsystem)) if (!parseSubsystemOption(info, arg->getValue(), diagnostics)) return true; // Handle -entry if (llvm::opt::Arg *arg = parsedArgs->getLastArg(OPT_entry)) info.setEntrySymbolName(arg->getValue()); // Handle -libpath for (llvm::opt::arg_iterator it = parsedArgs->filtered_begin(OPT_libpath), ie = parsedArgs->filtered_end(); it != ie; ++it) { info.appendInputSearchPath((*it)->getValue()); } // Handle -force if (parsedArgs->getLastArg(OPT_force)) info.setAllowRemainingUndefines(true); // Handle -nxcompat:no if (parsedArgs->getLastArg(OPT_no_nxcompat)) info.setNxCompat(false); // Handle -largeaddressaware if (parsedArgs->getLastArg(OPT_largeaddressaware)) info.setLargeAddressAware(true); // Handle -fixed if (parsedArgs->getLastArg(OPT_fixed)) info.setBaseRelocationEnabled(false); // Handle -tsaware:no if (parsedArgs->getLastArg(OPT_no_tsaware)) info.setTerminalServerAware(false); // Handle -out if (llvm::opt::Arg *outpath = parsedArgs->getLastArg(OPT_out)) info.setOutputPath(outpath->getValue()); // Handle -defaultlib std::vector defaultLibs; for (llvm::opt::arg_iterator it = parsedArgs->filtered_begin(OPT_defaultlib), ie = parsedArgs->filtered_end(); it != ie; ++it) { defaultLibs.push_back((*it)->getValue()); } // Add input files std::vector inputPaths; for (llvm::opt::arg_iterator it = parsedArgs->filtered_begin(OPT_INPUT), ie = parsedArgs->filtered_end(); it != ie; ++it) { inputPaths.push_back((*it)->getValue()); } // Arguments after "--" are also input files if (doubleDashPosition > 0) for (int i = doubleDashPosition + 1; i < argc; ++i) inputPaths.push_back(argv[i]); // Add input files specified via the command line. for (const StringRef path : inputPaths) info.appendInputFileOrLibrary(path); // Add the library files specified by -defaultlib option. The files // specified by the option should have lower precedence than the other files // added above, which is important for link.exe compatibility. for (const StringRef path : defaultLibs) info.appendLibraryFile(path); // If -out option was not specified, the default output file name is // constructed by replacing an extension of the first input file // with ".exe". if (info.outputPath().empty() && !inputPaths.empty()) info.setOutputPath(getDefaultOutputFileName(info, inputPaths[0])); // Validate the combination of options used. return info.validate(diagnostics); } } // namespace lld