xref: /llvm-project/clang/lib/FrontendTool/ExecuteCompilerInvocation.cpp (revision 2b20cb87f5b6b48ca8d32f99a0ef5472605afefd)
1 //===--- ExecuteCompilerInvocation.cpp ------------------------------------===//
2 //
3 //                     The LLVM Compiler Infrastructure
4 //
5 // This file is distributed under the University of Illinois Open Source
6 // License. See LICENSE.TXT for details.
7 //
8 //===----------------------------------------------------------------------===//
9 //
10 // This file holds ExecuteCompilerInvocation(). It is split into its own file to
11 // minimize the impact of pulling in essentially everything else in Clang.
12 //
13 //===----------------------------------------------------------------------===//
14 
15 #include "clang/FrontendTool/Utils.h"
16 #include "clang/StaticAnalyzer/Frontend/FrontendActions.h"
17 #include "clang/ARCMigrate/ARCMTActions.h"
18 #include "clang/CodeGen/CodeGenAction.h"
19 #include "clang/Driver/CC1Options.h"
20 #include "clang/Driver/OptTable.h"
21 #include "clang/Frontend/CompilerInvocation.h"
22 #include "clang/Frontend/CompilerInstance.h"
23 #include "clang/Frontend/FrontendActions.h"
24 #include "clang/Frontend/FrontendDiagnostic.h"
25 #include "clang/Frontend/FrontendPluginRegistry.h"
26 #include "clang/Rewrite/FrontendActions.h"
27 #include "llvm/Support/ErrorHandling.h"
28 #include "llvm/Support/DynamicLibrary.h"
29 using namespace clang;
30 
31 static FrontendAction *CreateFrontendBaseAction(CompilerInstance &CI) {
32   using namespace clang::frontend;
33 
34   switch (CI.getFrontendOpts().ProgramAction) {
35   default:
36     llvm_unreachable("Invalid program action!");
37 
38   case ASTDump:                return new ASTDumpAction();
39   case ASTDumpXML:             return new ASTDumpXMLAction();
40   case ASTPrint:               return new ASTPrintAction();
41   case ASTView:                return new ASTViewAction();
42   case DumpRawTokens:          return new DumpRawTokensAction();
43   case DumpTokens:             return new DumpTokensAction();
44   case EmitAssembly:           return new EmitAssemblyAction();
45   case EmitBC:                 return new EmitBCAction();
46   case EmitHTML:               return new HTMLPrintAction();
47   case EmitLLVM:               return new EmitLLVMAction();
48   case EmitLLVMOnly:           return new EmitLLVMOnlyAction();
49   case EmitCodeGenOnly:        return new EmitCodeGenOnlyAction();
50   case EmitObj:                return new EmitObjAction();
51   case FixIt:                  return new FixItAction();
52   case GenerateModule:         return new GeneratePCHAction(true);
53   case GenerateModuleFromMap:  return new GenerateModuleAction;
54   case GeneratePCH:            return new GeneratePCHAction(false);
55   case GeneratePTH:            return new GeneratePTHAction();
56   case InitOnly:               return new InitOnlyAction();
57   case ParseSyntaxOnly:        return new SyntaxOnlyAction();
58 
59   case PluginAction: {
60     for (FrontendPluginRegistry::iterator it =
61            FrontendPluginRegistry::begin(), ie = FrontendPluginRegistry::end();
62          it != ie; ++it) {
63       if (it->getName() == CI.getFrontendOpts().ActionName) {
64         llvm::OwningPtr<PluginASTAction> P(it->instantiate());
65         if (!P->ParseArgs(CI, CI.getFrontendOpts().PluginArgs))
66           return 0;
67         return P.take();
68       }
69     }
70 
71     CI.getDiagnostics().Report(diag::err_fe_invalid_plugin_name)
72       << CI.getFrontendOpts().ActionName;
73     return 0;
74   }
75 
76   case PrintDeclContext:       return new DeclContextPrintAction();
77   case PrintPreamble:          return new PrintPreambleAction();
78   case PrintPreprocessedInput: return new PrintPreprocessedAction();
79   case RewriteMacros:          return new RewriteMacrosAction();
80   case RewriteObjC:            return new RewriteObjCAction();
81   case RewriteTest:            return new RewriteTestAction();
82   case RunAnalysis:            return new ento::AnalysisAction();
83   case RunPreprocessorOnly:    return new PreprocessOnlyAction();
84   }
85 }
86 
87 static FrontendAction *CreateFrontendAction(CompilerInstance &CI) {
88   // Create the underlying action.
89   FrontendAction *Act = CreateFrontendBaseAction(CI);
90   if (!Act)
91     return 0;
92 
93   // Potentially wrap the base FE action in an ARC Migrate Tool action.
94   switch (CI.getFrontendOpts().ARCMTAction) {
95   case FrontendOptions::ARCMT_None:
96     break;
97   case FrontendOptions::ARCMT_Check:
98     Act = new arcmt::CheckAction(Act);
99     break;
100   case FrontendOptions::ARCMT_Modify:
101     Act = new arcmt::ModifyAction(Act);
102     break;
103   case FrontendOptions::ARCMT_Migrate:
104     Act = new arcmt::MigrateAction(Act,
105                                    CI.getFrontendOpts().ARCMTMigrateDir,
106                                    CI.getFrontendOpts().ARCMTMigrateReportOut,
107                                 CI.getFrontendOpts().ARCMTMigrateEmitARCErrors);
108     break;
109   }
110 
111   // If there are any AST files to merge, create a frontend action
112   // adaptor to perform the merge.
113   if (!CI.getFrontendOpts().ASTMergeFiles.empty())
114     Act = new ASTMergeAction(Act, &CI.getFrontendOpts().ASTMergeFiles[0],
115                              CI.getFrontendOpts().ASTMergeFiles.size());
116 
117   return Act;
118 }
119 
120 bool clang::ExecuteCompilerInvocation(CompilerInstance *Clang) {
121   // Honor -help.
122   if (Clang->getFrontendOpts().ShowHelp) {
123     llvm::OwningPtr<driver::OptTable> Opts(driver::createCC1OptTable());
124     Opts->PrintHelp(llvm::outs(), "clang -cc1",
125                     "LLVM 'Clang' Compiler: http://clang.llvm.org");
126     return 0;
127   }
128 
129   // Honor -version.
130   //
131   // FIXME: Use a better -version message?
132   if (Clang->getFrontendOpts().ShowVersion) {
133     llvm::cl::PrintVersionMessage();
134     return 0;
135   }
136 
137   // Load any requested plugins.
138   for (unsigned i = 0,
139          e = Clang->getFrontendOpts().Plugins.size(); i != e; ++i) {
140     const std::string &Path = Clang->getFrontendOpts().Plugins[i];
141     std::string Error;
142     if (llvm::sys::DynamicLibrary::LoadLibraryPermanently(Path.c_str(), &Error))
143       Clang->getDiagnostics().Report(diag::err_fe_unable_to_load_plugin)
144         << Path << Error;
145   }
146 
147   // Honor -mllvm.
148   //
149   // FIXME: Remove this, one day.
150   // This should happen AFTER plugins have been loaded!
151   if (!Clang->getFrontendOpts().LLVMArgs.empty()) {
152     unsigned NumArgs = Clang->getFrontendOpts().LLVMArgs.size();
153     const char **Args = new const char*[NumArgs + 2];
154     Args[0] = "clang (LLVM option parsing)";
155     for (unsigned i = 0; i != NumArgs; ++i)
156       Args[i + 1] = Clang->getFrontendOpts().LLVMArgs[i].c_str();
157     Args[NumArgs + 1] = 0;
158     llvm::cl::ParseCommandLineOptions(NumArgs + 1, const_cast<char **>(Args));
159   }
160 
161   // Honor -analyzer-checker-help.
162   // This should happen AFTER plugins have been loaded!
163   if (Clang->getAnalyzerOpts().ShowCheckerHelp) {
164     ento::printCheckerHelp(llvm::outs(), Clang->getFrontendOpts().Plugins);
165     return 0;
166   }
167 
168   // If there were errors in processing arguments, don't do anything else.
169   bool Success = false;
170   if (!Clang->getDiagnostics().hasErrorOccurred()) {
171     // Create and execute the frontend action.
172     llvm::OwningPtr<FrontendAction> Act(CreateFrontendAction(*Clang));
173     if (Act) {
174       Success = Clang->ExecuteAction(*Act);
175       if (Clang->getFrontendOpts().DisableFree)
176         Act.take();
177     }
178   }
179 
180   return Success;
181 }
182