1 //===-- driver.cpp - Clang GCC-Compatible Driver --------------------------===//
3 // The LLVM Compiler Infrastructure
5 // This file is distributed under the University of Illinois Open Source
6 // License. See LICENSE.TXT for details.
8 //===----------------------------------------------------------------------===//
10 // This is the entry point to the clang driver; it is a thin wrapper
11 // for functionality in the Driver clang library.
13 //===----------------------------------------------------------------------===//
15 #include "clang/Basic/CharInfo.h"
16 #include "clang/Basic/DiagnosticOptions.h"
17 #include "clang/Driver/Compilation.h"
18 #include "clang/Driver/Driver.h"
19 #include "clang/Driver/DriverDiagnostic.h"
20 #include "clang/Driver/Options.h"
21 #include "clang/Frontend/CompilerInvocation.h"
22 #include "clang/Frontend/TextDiagnosticPrinter.h"
23 #include "clang/Frontend/Utils.h"
24 #include "llvm/ADT/ArrayRef.h"
25 #include "llvm/ADT/OwningPtr.h"
26 #include "llvm/ADT/SmallString.h"
27 #include "llvm/ADT/SmallVector.h"
28 #include "llvm/ADT/STLExtras.h"
29 #include "llvm/Option/ArgList.h"
30 #include "llvm/Option/OptTable.h"
31 #include "llvm/Option/Option.h"
32 #include "llvm/Support/CommandLine.h"
33 #include "llvm/Support/ErrorHandling.h"
34 #include "llvm/Support/FileSystem.h"
35 #include "llvm/Support/Host.h"
36 #include "llvm/Support/ManagedStatic.h"
37 #include "llvm/Support/MemoryBuffer.h"
38 #include "llvm/Support/Path.h"
39 #include "llvm/Support/PrettyStackTrace.h"
40 #include "llvm/Support/Process.h"
41 #include "llvm/Support/Program.h"
42 #include "llvm/Support/Regex.h"
43 #include "llvm/Support/Signals.h"
44 #include "llvm/Support/TargetRegistry.h"
45 #include "llvm/Support/TargetSelect.h"
46 #include "llvm/Support/Timer.h"
47 #include "llvm/Support/raw_ostream.h"
48 #include "llvm/Support/system_error.h"
49 using namespace clang;
50 using namespace clang::driver;
51 using namespace llvm::opt;
53 std::string GetExecutablePath(const char *Argv0, bool CanonicalPrefixes) {
54 if (!CanonicalPrefixes)
57 // This just needs to be some symbol in the binary; C++ doesn't
58 // allow taking the address of ::main however.
59 void *P = (void*) (intptr_t) GetExecutablePath;
60 return llvm::sys::fs::getMainExecutable(Argv0, P);
63 static const char *SaveStringInSet(std::set<std::string> &SavedStrings,
65 return SavedStrings.insert(S).first->c_str();
68 /// ApplyQAOverride - Apply a list of edits to the input argument lists.
70 /// The input string is a space separate list of edits to perform,
71 /// they are applied in order to the input argument lists. Edits
72 /// should be one of the following forms:
74 /// '#': Silence information about the changes to the command line arguments.
76 /// '^': Add FOO as a new argument at the beginning of the command line.
78 /// '+': Add FOO as a new argument at the end of the command line.
80 /// 's/XXX/YYY/': Substitute the regular expression XXX with YYY in the command
83 /// 'xOPTION': Removes all instances of the literal argument OPTION.
85 /// 'XOPTION': Removes all instances of the literal argument OPTION,
86 /// and the following argument.
88 /// 'Ox': Removes all flags matching 'O' or 'O[sz0-9]' and adds 'Ox'
89 /// at the end of the command line.
91 /// \param OS - The stream to write edit information to.
92 /// \param Args - The vector of command line arguments.
93 /// \param Edit - The override command to perform.
94 /// \param SavedStrings - Set to use for storing string representations.
95 static void ApplyOneQAOverride(raw_ostream &OS,
96 SmallVectorImpl<const char*> &Args,
98 std::set<std::string> &SavedStrings) {
99 // This does not need to be efficient.
101 if (Edit[0] == '^') {
103 SaveStringInSet(SavedStrings, Edit.substr(1));
104 OS << "### Adding argument " << Str << " at beginning\n";
105 Args.insert(Args.begin() + 1, Str);
106 } else if (Edit[0] == '+') {
108 SaveStringInSet(SavedStrings, Edit.substr(1));
109 OS << "### Adding argument " << Str << " at end\n";
111 } else if (Edit[0] == 's' && Edit[1] == '/' && Edit.endswith("/") &&
112 Edit.slice(2, Edit.size()-1).find('/') != StringRef::npos) {
113 StringRef MatchPattern = Edit.substr(2).split('/').first;
114 StringRef ReplPattern = Edit.substr(2).split('/').second;
115 ReplPattern = ReplPattern.slice(0, ReplPattern.size()-1);
117 for (unsigned i = 1, e = Args.size(); i != e; ++i) {
118 std::string Repl = llvm::Regex(MatchPattern).sub(ReplPattern, Args[i]);
120 if (Repl != Args[i]) {
121 OS << "### Replacing '" << Args[i] << "' with '" << Repl << "'\n";
122 Args[i] = SaveStringInSet(SavedStrings, Repl);
125 } else if (Edit[0] == 'x' || Edit[0] == 'X') {
126 std::string Option = Edit.substr(1, std::string::npos);
127 for (unsigned i = 1; i < Args.size();) {
128 if (Option == Args[i]) {
129 OS << "### Deleting argument " << Args[i] << '\n';
130 Args.erase(Args.begin() + i);
131 if (Edit[0] == 'X') {
132 if (i < Args.size()) {
133 OS << "### Deleting argument " << Args[i] << '\n';
134 Args.erase(Args.begin() + i);
136 OS << "### Invalid X edit, end of command line!\n";
141 } else if (Edit[0] == 'O') {
142 for (unsigned i = 1; i < Args.size();) {
143 const char *A = Args[i];
144 if (A[0] == '-' && A[1] == 'O' &&
146 (A[3] == '\0' && (A[2] == 's' || A[2] == 'z' ||
147 ('0' <= A[2] && A[2] <= '9'))))) {
148 OS << "### Deleting argument " << Args[i] << '\n';
149 Args.erase(Args.begin() + i);
153 OS << "### Adding argument " << Edit << " at end\n";
154 Args.push_back(SaveStringInSet(SavedStrings, '-' + Edit.str()));
156 OS << "### Unrecognized edit: " << Edit << "\n";
160 /// ApplyQAOverride - Apply a comma separate list of edits to the
161 /// input argument lists. See ApplyOneQAOverride.
162 static void ApplyQAOverride(SmallVectorImpl<const char*> &Args,
163 const char *OverrideStr,
164 std::set<std::string> &SavedStrings) {
165 raw_ostream *OS = &llvm::errs();
167 if (OverrideStr[0] == '#') {
172 *OS << "### QA_OVERRIDE_GCC3_OPTIONS: " << OverrideStr << "\n";
174 // This does not need to be efficient.
176 const char *S = OverrideStr;
178 const char *End = ::strchr(S, ' ');
182 ApplyOneQAOverride(*OS, Args, std::string(S, End), SavedStrings);
189 extern int cc1_main(const char **ArgBegin, const char **ArgEnd,
190 const char *Argv0, void *MainAddr);
191 extern int cc1as_main(const char **ArgBegin, const char **ArgEnd,
192 const char *Argv0, void *MainAddr);
194 static void ParseProgName(SmallVectorImpl<const char *> &ArgVector,
195 std::set<std::string> &SavedStrings,
198 // Try to infer frontend type and default target from the program name.
200 // suffixes[] contains the list of known driver suffixes.
201 // Suffixes are compared against the program name in order.
202 // If there is a match, the frontend type is updated as necessary (CPP/C++).
203 // If there is no match, a second round is done after stripping the last
204 // hyphen and everything following it. This allows using something like
207 // If there is a match in either the first or second round,
208 // the function tries to identify a target as prefix. E.g.
209 // "x86_64-linux-clang" as interpreted as suffix "clang" with
210 // target prefix "x86_64-linux". If such a target prefix is found,
211 // is gets added via -target as implicit first argument.
212 static const struct {
214 const char *ModeFlag;
217 { "clang++", "--driver-mode=g++" },
218 { "clang-CC", "--driver-mode=g++" },
219 { "clang-c++", "--driver-mode=g++" },
221 { "clang-cpp", "--driver-mode=cpp" },
222 { "clang-g++", "--driver-mode=g++" },
224 { "clang-cl", "--driver-mode=cl" },
225 { "CC", "--driver-mode=g++" },
227 { "cpp", "--driver-mode=cpp" },
228 { "cl" , "--driver-mode=cl" },
229 { "++", "--driver-mode=g++" },
231 std::string ProgName(llvm::sys::path::stem(ArgVector[0]));
233 std::transform(ProgName.begin(), ProgName.end(), ProgName.begin(),
236 StringRef ProgNameRef(ProgName);
239 for (int Components = 2; Components; --Components) {
240 bool FoundMatch = false;
243 for (i = 0; i < sizeof(suffixes) / sizeof(suffixes[0]); ++i) {
244 if (ProgNameRef.endswith(suffixes[i].Suffix)) {
246 SmallVectorImpl<const char *>::iterator it = ArgVector.begin();
247 if (it != ArgVector.end())
249 if (suffixes[i].ModeFlag)
250 ArgVector.insert(it, suffixes[i].ModeFlag);
256 StringRef::size_type LastComponent = ProgNameRef.rfind('-',
257 ProgNameRef.size() - strlen(suffixes[i].Suffix));
258 if (LastComponent != StringRef::npos)
259 Prefix = ProgNameRef.slice(0, LastComponent);
263 StringRef::size_type LastComponent = ProgNameRef.rfind('-');
264 if (LastComponent == StringRef::npos)
266 ProgNameRef = ProgNameRef.slice(0, LastComponent);
272 std::string IgnoredError;
273 if (llvm::TargetRegistry::lookupTarget(Prefix, IgnoredError)) {
274 SmallVectorImpl<const char *>::iterator it = ArgVector.begin();
275 if (it != ArgVector.end())
277 const char* Strings[] =
278 { SaveStringInSet(SavedStrings, std::string("-target")),
279 SaveStringInSet(SavedStrings, Prefix) };
280 ArgVector.insert(it, Strings, Strings + llvm::array_lengthof(Strings));
285 class StringSetSaver : public llvm::cl::StringSaver {
287 StringSetSaver(std::set<std::string> &Storage) : Storage(Storage) {}
288 const char *SaveString(const char *Str) LLVM_OVERRIDE {
289 return SaveStringInSet(Storage, Str);
292 std::set<std::string> &Storage;
296 int main(int argc_, const char **argv_) {
297 llvm::sys::PrintStackTraceOnErrorSignal();
298 llvm::PrettyStackTraceProgram X(argc_, argv_);
300 SmallVector<const char *, 256> argv;
301 llvm::SpecificBumpPtrAllocator<char> ArgAllocator;
302 llvm::error_code EC = llvm::sys::Process::GetArgumentVector(
303 argv, llvm::ArrayRef<const char *>(argv_, argc_), ArgAllocator);
305 llvm::errs() << "error: couldn't get arguments: " << EC.message() << '\n';
309 std::set<std::string> SavedStrings;
310 StringSetSaver Saver(SavedStrings);
311 llvm::cl::ExpandResponseFiles(Saver, llvm::cl::TokenizeGNUCommandLine, argv);
313 // Handle -cc1 integrated tools.
314 if (argv.size() > 1 && StringRef(argv[1]).startswith("-cc1")) {
315 StringRef Tool = argv[1] + 4;
318 return cc1_main(argv.data()+2, argv.data()+argv.size(), argv[0],
319 (void*) (intptr_t) GetExecutablePath);
321 return cc1as_main(argv.data()+2, argv.data()+argv.size(), argv[0],
322 (void*) (intptr_t) GetExecutablePath);
324 // Reject unknown tools.
325 llvm::errs() << "error: unknown integrated tool '" << Tool << "'\n";
329 bool CanonicalPrefixes = true;
330 for (int i = 1, size = argv.size(); i < size; ++i) {
331 if (StringRef(argv[i]) == "-no-canonical-prefixes") {
332 CanonicalPrefixes = false;
337 // Handle QA_OVERRIDE_GCC3_OPTIONS and CCC_ADD_ARGS, used for editing a
338 // command line behind the scenes.
339 if (const char *OverrideStr = ::getenv("QA_OVERRIDE_GCC3_OPTIONS")) {
340 // FIXME: Driver shouldn't take extra initial argument.
341 ApplyQAOverride(argv, OverrideStr, SavedStrings);
344 std::string Path = GetExecutablePath(argv[0], CanonicalPrefixes);
346 IntrusiveRefCntPtr<DiagnosticOptions> DiagOpts = new DiagnosticOptions;
348 OwningPtr<OptTable> Opts(createDriverOptTable());
349 unsigned MissingArgIndex, MissingArgCount;
350 OwningPtr<InputArgList> Args(Opts->ParseArgs(argv.begin()+1, argv.end(),
353 // We ignore MissingArgCount and the return value of ParseDiagnosticArgs.
354 // Any errors that would be diagnosed here will also be diagnosed later,
355 // when the DiagnosticsEngine actually exists.
356 (void) ParseDiagnosticArgs(*DiagOpts, *Args);
358 // Now we can create the DiagnosticsEngine with a properly-filled-out
359 // DiagnosticOptions instance.
360 TextDiagnosticPrinter *DiagClient
361 = new TextDiagnosticPrinter(llvm::errs(), &*DiagOpts);
363 // If the clang binary happens to be named cl.exe for compatibility reasons,
364 // use clang-cl.exe as the prefix to avoid confusion between clang and MSVC.
365 StringRef ExeBasename(llvm::sys::path::filename(Path));
366 if (ExeBasename.equals_lower("cl.exe"))
367 ExeBasename = "clang-cl.exe";
368 DiagClient->setPrefix(ExeBasename);
370 IntrusiveRefCntPtr<DiagnosticIDs> DiagID(new DiagnosticIDs());
372 DiagnosticsEngine Diags(DiagID, &*DiagOpts, DiagClient);
373 ProcessWarningOptions(Diags, *DiagOpts, /*ReportDiags=*/false);
375 Driver TheDriver(Path, llvm::sys::getDefaultTargetTriple(), "a.out", Diags);
377 // Attempt to find the original path used to invoke the driver, to determine
378 // the installed path. We do this manually, because we want to support that
379 // path being a symlink.
381 SmallString<128> InstalledPath(argv[0]);
383 // Do a PATH lookup, if there are no directory components.
384 if (llvm::sys::path::filename(InstalledPath) == InstalledPath) {
385 std::string Tmp = llvm::sys::FindProgramByName(
386 llvm::sys::path::filename(InstalledPath.str()));
390 llvm::sys::fs::make_absolute(InstalledPath);
391 InstalledPath = llvm::sys::path::parent_path(InstalledPath);
393 if (!llvm::sys::fs::exists(InstalledPath.str(), exists) && exists)
394 TheDriver.setInstalledDir(InstalledPath);
397 llvm::InitializeAllTargets();
398 ParseProgName(argv, SavedStrings, TheDriver);
400 // Handle CC_PRINT_OPTIONS and CC_PRINT_OPTIONS_FILE.
401 TheDriver.CCPrintOptions = !!::getenv("CC_PRINT_OPTIONS");
402 if (TheDriver.CCPrintOptions)
403 TheDriver.CCPrintOptionsFilename = ::getenv("CC_PRINT_OPTIONS_FILE");
405 // Handle CC_PRINT_HEADERS and CC_PRINT_HEADERS_FILE.
406 TheDriver.CCPrintHeaders = !!::getenv("CC_PRINT_HEADERS");
407 if (TheDriver.CCPrintHeaders)
408 TheDriver.CCPrintHeadersFilename = ::getenv("CC_PRINT_HEADERS_FILE");
410 // Handle CC_LOG_DIAGNOSTICS and CC_LOG_DIAGNOSTICS_FILE.
411 TheDriver.CCLogDiagnostics = !!::getenv("CC_LOG_DIAGNOSTICS");
412 if (TheDriver.CCLogDiagnostics)
413 TheDriver.CCLogDiagnosticsFilename = ::getenv("CC_LOG_DIAGNOSTICS_FILE");
415 OwningPtr<Compilation> C(TheDriver.BuildCompilation(argv));
417 SmallVector<std::pair<int, const Command *>, 4> FailingCommands;
419 Res = TheDriver.ExecuteCompilation(*C, FailingCommands);
421 // Force a crash to test the diagnostics.
422 if (::getenv("FORCE_CLANG_DIAGNOSTICS_CRASH")) {
423 Diags.Report(diag::err_drv_force_crash) << "FORCE_CLANG_DIAGNOSTICS_CRASH";
424 const Command *FailingCommand = 0;
425 FailingCommands.push_back(std::make_pair(-1, FailingCommand));
428 for (SmallVectorImpl< std::pair<int, const Command *> >::iterator it =
429 FailingCommands.begin(), ie = FailingCommands.end(); it != ie; ++it) {
430 int CommandRes = it->first;
431 const Command *FailingCommand = it->second;
435 // If result status is < 0, then the driver command signalled an error.
436 // If result status is 70, then the driver command reported a fatal error.
437 // In these cases, generate additional diagnostic information if possible.
438 if (CommandRes < 0 || CommandRes == 70) {
439 TheDriver.generateCompilationDiagnostics(*C, FailingCommand);
444 // If any timers were active but haven't been destroyed yet, print their
445 // results now. This happens in -disable-free mode.
446 llvm::TimerGroup::printAll(llvm::errs());
448 llvm::llvm_shutdown();
451 // Exit status should not be negative on Win32, unless abnormal termination.
452 // Once abnormal termiation was caught, negative status should not be
458 // If we have multiple failing commands, we return the result of the first