//===--- Job.cpp - Command to Execute -------------------------------------===// // // The LLVM Compiler Infrastructure // // This file is distributed under the University of Illinois Open Source // License. See LICENSE.TXT for details. // //===----------------------------------------------------------------------===// #include "clang/Driver/Job.h" #include "InputInfo.h" #include "clang/Driver/Driver.h" #include "clang/Driver/DriverDiagnostic.h" #include "clang/Driver/Tool.h" #include "clang/Driver/ToolChain.h" #include "llvm/ADT/ArrayRef.h" #include "llvm/ADT/STLExtras.h" #include "llvm/ADT/SmallString.h" #include "llvm/ADT/StringRef.h" #include "llvm/ADT/StringSet.h" #include "llvm/ADT/StringSwitch.h" #include "llvm/Support/FileSystem.h" #include "llvm/Support/Path.h" #include "llvm/Support/Program.h" #include "llvm/Support/raw_ostream.h" #include using namespace clang::driver; using llvm::raw_ostream; using llvm::StringRef; using llvm::ArrayRef; Command::Command(const Action &Source, const Tool &Creator, const char *Executable, const ArgStringList &Arguments, ArrayRef Inputs) : Source(Source), Creator(Creator), Executable(Executable), Arguments(Arguments), ResponseFile(nullptr) { for (const auto &II : Inputs) if (II.isFilename()) InputFilenames.push_back(II.getFilename()); } /// @brief Check if the compiler flag in question should be skipped when /// emitting a reproducer. Also track how many arguments it has and if the /// option is some kind of include path. static bool skipArgs(const char *Flag, bool HaveCrashVFS, int &SkipNum, bool &IsInclude) { SkipNum = 2; // These flags are all of the form -Flag and are treated as two // arguments. Therefore, we need to skip the flag and the next argument. bool ShouldSkip = llvm::StringSwitch(Flag) .Cases("-MF", "-MT", "-MQ", "-serialize-diagnostic-file", true) .Cases("-o", "-dependency-file", true) .Cases("-fdebug-compilation-dir", "-diagnostic-log-file", true) .Cases("-dwarf-debug-flags", "-ivfsoverlay", true) .Default(false); if (ShouldSkip) return true; // Some include flags shouldn't be skipped if we have a crash VFS IsInclude = llvm::StringSwitch(Flag) .Cases("-include", "-header-include-file", true) .Cases("-idirafter", "-internal-isystem", "-iwithprefix", true) .Cases("-internal-externc-isystem", "-iprefix", true) .Cases("-iwithprefixbefore", "-isystem", "-iquote", true) .Cases("-isysroot", "-I", "-F", "-resource-dir", true) .Cases("-iframework", "-include-pch", true) .Default(false); if (IsInclude) return HaveCrashVFS ? false : true; // The remaining flags are treated as a single argument. // These flags are all of the form -Flag and have no second argument. ShouldSkip = llvm::StringSwitch(Flag) .Cases("-M", "-MM", "-MG", "-MP", "-MD", true) .Case("-MMD", true) .Default(false); // Match found. SkipNum = 1; if (ShouldSkip) return true; // These flags are treated as a single argument (e.g., -F). StringRef FlagRef(Flag); IsInclude = FlagRef.startswith("-F") || FlagRef.startswith("-I"); if (IsInclude) return HaveCrashVFS ? false : true; if (FlagRef.startswith("-fmodules-cache-path=")) return true; SkipNum = 0; return false; } void Command::printArg(raw_ostream &OS, StringRef Arg, bool Quote) { const bool Escape = Arg.find_first_of("\"\\$") != StringRef::npos; if (!Quote && !Escape) { OS << Arg; return; } // Quote and escape. This isn't really complete, but good enough. OS << '"'; for (const char c : Arg) { if (c == '"' || c == '\\' || c == '$') OS << '\\'; OS << c; } OS << '"'; } void Command::writeResponseFile(raw_ostream &OS) const { // In a file list, we only write the set of inputs to the response file if (Creator.getResponseFilesSupport() == Tool::RF_FileList) { for (const char *Arg : InputFileList) { OS << Arg << '\n'; } return; } // In regular response files, we send all arguments to the response file. // Wrapping all arguments in double quotes ensures that both Unix tools and // Windows tools understand the response file. for (const char *Arg : Arguments) { OS << '"'; for (; *Arg != '\0'; Arg++) { if (*Arg == '\"' || *Arg == '\\') { OS << '\\'; } OS << *Arg; } OS << "\" "; } } void Command::buildArgvForResponseFile( llvm::SmallVectorImpl &Out) const { // When not a file list, all arguments are sent to the response file. // This leaves us to set the argv to a single parameter, requesting the tool // to read the response file. if (Creator.getResponseFilesSupport() != Tool::RF_FileList) { Out.push_back(Executable); Out.push_back(ResponseFileFlag.c_str()); return; } llvm::StringSet<> Inputs; for (const char *InputName : InputFileList) Inputs.insert(InputName); Out.push_back(Executable); // In a file list, build args vector ignoring parameters that will go in the // response file (elements of the InputFileList vector) bool FirstInput = true; for (const char *Arg : Arguments) { if (Inputs.count(Arg) == 0) { Out.push_back(Arg); } else if (FirstInput) { FirstInput = false; Out.push_back(Creator.getResponseFileFlag()); Out.push_back(ResponseFile); } } } /// @brief Rewrite relative include-like flag paths to absolute ones. static void rewriteIncludes(const llvm::ArrayRef &Args, size_t Idx, size_t NumArgs, llvm::SmallVectorImpl> &IncFlags) { using namespace llvm; using namespace sys; auto getAbsPath = [](StringRef InInc, SmallVectorImpl &OutInc) -> bool { if (path::is_absolute(InInc)) // Nothing to do here... return false; std::error_code EC = fs::current_path(OutInc); if (EC) return false; path::append(OutInc, InInc); return true; }; SmallString<128> NewInc; if (NumArgs == 1) { StringRef FlagRef(Args[Idx + NumArgs - 1]); assert((FlagRef.startswith("-F") || FlagRef.startswith("-I")) && "Expecting -I or -F"); StringRef Inc = FlagRef.slice(2, StringRef::npos); if (getAbsPath(Inc, NewInc)) { SmallString<128> NewArg(FlagRef.slice(0, 2)); NewArg += NewInc; IncFlags.push_back(std::move(NewArg)); } return; } assert(NumArgs == 2 && "Not expecting more than two arguments"); StringRef Inc(Args[Idx + NumArgs - 1]); if (!getAbsPath(Inc, NewInc)) return; IncFlags.push_back(SmallString<128>(Args[Idx])); IncFlags.push_back(std::move(NewInc)); } void Command::Print(raw_ostream &OS, const char *Terminator, bool Quote, CrashReportInfo *CrashInfo) const { // Always quote the exe. OS << ' '; printArg(OS, Executable, /*Quote=*/true); llvm::ArrayRef Args = Arguments; llvm::SmallVector ArgsRespFile; if (ResponseFile != nullptr) { buildArgvForResponseFile(ArgsRespFile); Args = ArrayRef(ArgsRespFile).slice(1); // no executable name } bool HaveCrashVFS = CrashInfo && !CrashInfo->VFSPath.empty(); for (size_t i = 0, e = Args.size(); i < e; ++i) { const char *const Arg = Args[i]; if (CrashInfo) { int NumArgs = 0; bool IsInclude = false; if (skipArgs(Arg, HaveCrashVFS, NumArgs, IsInclude)) { i += NumArgs - 1; continue; } // Relative includes need to be expanded to absolute paths. if (HaveCrashVFS && IsInclude) { SmallVector, 2> NewIncFlags; rewriteIncludes(Args, i, NumArgs, NewIncFlags); if (!NewIncFlags.empty()) { for (auto &F : NewIncFlags) { OS << ' '; printArg(OS, F.c_str(), Quote); } i += NumArgs - 1; continue; } } auto Found = std::find_if(InputFilenames.begin(), InputFilenames.end(), [&Arg](StringRef IF) { return IF == Arg; }); if (Found != InputFilenames.end() && (i == 0 || StringRef(Args[i - 1]) != "-main-file-name")) { // Replace the input file name with the crashinfo's file name. OS << ' '; StringRef ShortName = llvm::sys::path::filename(CrashInfo->Filename); printArg(OS, ShortName.str(), Quote); continue; } } OS << ' '; printArg(OS, Arg, Quote); } if (CrashInfo && HaveCrashVFS) { OS << ' '; printArg(OS, "-ivfsoverlay", Quote); OS << ' '; printArg(OS, CrashInfo->VFSPath.str(), Quote); // The leftover modules from the crash are stored in // .cache/vfs/modules // Leave it untouched for pcm inspection and provide a clean/empty dir // path to contain the future generated module cache: // .cache/vfs/repro-modules SmallString<128> RelModCacheDir = llvm::sys::path::parent_path( llvm::sys::path::parent_path(CrashInfo->VFSPath)); llvm::sys::path::append(RelModCacheDir, "repro-modules"); std::string ModCachePath = "-fmodules-cache-path="; ModCachePath.append(RelModCacheDir.c_str()); OS << ' '; printArg(OS, ModCachePath, Quote); } if (ResponseFile != nullptr) { OS << "\n Arguments passed via response file:\n"; writeResponseFile(OS); // Avoiding duplicated newline terminator, since FileLists are // newline-separated. if (Creator.getResponseFilesSupport() != Tool::RF_FileList) OS << "\n"; OS << " (end of response file)"; } OS << Terminator; } void Command::setResponseFile(const char *FileName) { ResponseFile = FileName; ResponseFileFlag = Creator.getResponseFileFlag(); ResponseFileFlag += FileName; } void Command::setEnvironment(llvm::ArrayRef NewEnvironment) { Environment.reserve(NewEnvironment.size() + 1); Environment.assign(NewEnvironment.begin(), NewEnvironment.end()); Environment.push_back(nullptr); } int Command::Execute(const StringRef **Redirects, std::string *ErrMsg, bool *ExecutionFailed) const { SmallVector Argv; const char **Envp; if (Environment.empty()) { Envp = nullptr; } else { assert(Environment.back() == nullptr && "Environment vector should be null-terminated by now"); Envp = const_cast(Environment.data()); } if (ResponseFile == nullptr) { Argv.push_back(Executable); Argv.append(Arguments.begin(), Arguments.end()); Argv.push_back(nullptr); return llvm::sys::ExecuteAndWait( Executable, Argv.data(), Envp, Redirects, /*secondsToWait*/ 0, /*memoryLimit*/ 0, ErrMsg, ExecutionFailed); } // We need to put arguments in a response file (command is too large) // Open stream to store the response file contents std::string RespContents; llvm::raw_string_ostream SS(RespContents); // Write file contents and build the Argv vector writeResponseFile(SS); buildArgvForResponseFile(Argv); Argv.push_back(nullptr); SS.flush(); // Save the response file in the appropriate encoding if (std::error_code EC = writeFileWithEncoding( ResponseFile, RespContents, Creator.getResponseFileEncoding())) { if (ErrMsg) *ErrMsg = EC.message(); if (ExecutionFailed) *ExecutionFailed = true; return -1; } return llvm::sys::ExecuteAndWait(Executable, Argv.data(), Envp, Redirects, /*secondsToWait*/ 0, /*memoryLimit*/ 0, ErrMsg, ExecutionFailed); } FallbackCommand::FallbackCommand(const Action &Source_, const Tool &Creator_, const char *Executable_, const ArgStringList &Arguments_, ArrayRef Inputs, std::unique_ptr Fallback_) : Command(Source_, Creator_, Executable_, Arguments_, Inputs), Fallback(std::move(Fallback_)) {} void FallbackCommand::Print(raw_ostream &OS, const char *Terminator, bool Quote, CrashReportInfo *CrashInfo) const { Command::Print(OS, "", Quote, CrashInfo); OS << " ||"; Fallback->Print(OS, Terminator, Quote, CrashInfo); } static bool ShouldFallback(int ExitCode) { // FIXME: We really just want to fall back for internal errors, such // as when some symbol cannot be mangled, when we should be able to // parse something but can't, etc. return ExitCode != 0; } int FallbackCommand::Execute(const StringRef **Redirects, std::string *ErrMsg, bool *ExecutionFailed) const { int PrimaryStatus = Command::Execute(Redirects, ErrMsg, ExecutionFailed); if (!ShouldFallback(PrimaryStatus)) return PrimaryStatus; // Clear ExecutionFailed and ErrMsg before falling back. if (ErrMsg) ErrMsg->clear(); if (ExecutionFailed) *ExecutionFailed = false; const Driver &D = getCreator().getToolChain().getDriver(); D.Diag(diag::warn_drv_invoking_fallback) << Fallback->getExecutable(); int SecondaryStatus = Fallback->Execute(Redirects, ErrMsg, ExecutionFailed); return SecondaryStatus; } ForceSuccessCommand::ForceSuccessCommand(const Action &Source_, const Tool &Creator_, const char *Executable_, const ArgStringList &Arguments_, ArrayRef Inputs) : Command(Source_, Creator_, Executable_, Arguments_, Inputs) {} void ForceSuccessCommand::Print(raw_ostream &OS, const char *Terminator, bool Quote, CrashReportInfo *CrashInfo) const { Command::Print(OS, "", Quote, CrashInfo); OS << " || (exit 0)" << Terminator; } int ForceSuccessCommand::Execute(const StringRef **Redirects, std::string *ErrMsg, bool *ExecutionFailed) const { int Status = Command::Execute(Redirects, ErrMsg, ExecutionFailed); (void)Status; if (ExecutionFailed) *ExecutionFailed = false; return 0; } void JobList::Print(raw_ostream &OS, const char *Terminator, bool Quote, CrashReportInfo *CrashInfo) const { for (const auto &Job : *this) Job.Print(OS, Terminator, Quote, CrashInfo); } void JobList::clear() { Jobs.clear(); }