1 //===--- ExecuteCompilerInvocation.cpp ------------------------------------===//
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 file holds ExecuteCompilerInvocation(). It is split into its own file to
11 // minimize the impact of pulling in essentially everything else in Clang.
13 //===----------------------------------------------------------------------===//
15 #include "clang/FrontendTool/Utils.h"
16 #include "clang/ARCMigrate/ARCMTActions.h"
17 #include "clang/CodeGen/CodeGenAction.h"
18 #include "clang/Driver/OptTable.h"
19 #include "clang/Driver/Option.h"
20 #include "clang/Driver/Options.h"
21 #include "clang/Frontend/CompilerInstance.h"
22 #include "clang/Frontend/CompilerInvocation.h"
23 #include "clang/Frontend/FrontendActions.h"
24 #include "clang/Frontend/FrontendDiagnostic.h"
25 #include "clang/Frontend/FrontendPluginRegistry.h"
26 #include "clang/Rewrite/Frontend/FrontendActions.h"
27 #include "clang/StaticAnalyzer/Frontend/FrontendActions.h"
28 #include "llvm/Support/DynamicLibrary.h"
29 #include "llvm/Support/ErrorHandling.h"
30 using namespace clang;
32 static FrontendAction *CreateFrontendBaseAction(CompilerInstance &CI) {
33 using namespace clang::frontend;
34 StringRef Action("unknown");
36 switch (CI.getFrontendOpts().ProgramAction) {
37 case ASTDeclList: return new ASTDeclListAction();
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 #ifdef CLANG_ENABLE_REWRITER
47 case EmitHTML: return new HTMLPrintAction();
49 case EmitHTML: Action = "EmitHTML"; break;
51 case EmitLLVM: return new EmitLLVMAction();
52 case EmitLLVMOnly: return new EmitLLVMOnlyAction();
53 case EmitCodeGenOnly: return new EmitCodeGenOnlyAction();
54 case EmitObj: return new EmitObjAction();
55 #ifdef CLANG_ENABLE_REWRITER
56 case FixIt: return new FixItAction();
58 case FixIt: Action = "FixIt"; break;
60 case GenerateModule: return new GenerateModuleAction;
61 case GeneratePCH: return new GeneratePCHAction;
62 case GeneratePTH: return new GeneratePTHAction();
63 case InitOnly: return new InitOnlyAction();
64 case ParseSyntaxOnly: return new SyntaxOnlyAction();
65 case ModuleFileInfo: return new DumpModuleInfoAction();
68 for (FrontendPluginRegistry::iterator it =
69 FrontendPluginRegistry::begin(), ie = FrontendPluginRegistry::end();
71 if (it->getName() == CI.getFrontendOpts().ActionName) {
72 OwningPtr<PluginASTAction> P(it->instantiate());
73 if (!P->ParseArgs(CI, CI.getFrontendOpts().PluginArgs))
79 CI.getDiagnostics().Report(diag::err_fe_invalid_plugin_name)
80 << CI.getFrontendOpts().ActionName;
84 case PrintDeclContext: return new DeclContextPrintAction();
85 case PrintPreamble: return new PrintPreambleAction();
86 case PrintPreprocessedInput: {
87 if (CI.getPreprocessorOutputOpts().RewriteIncludes) {
88 #ifdef CLANG_ENABLE_REWRITER
89 return new RewriteIncludesAction();
91 Action = "RewriteIncludesAction";
95 return new PrintPreprocessedAction();
98 #ifdef CLANG_ENABLE_REWRITER
99 case RewriteMacros: return new RewriteMacrosAction();
100 case RewriteObjC: return new RewriteObjCAction();
101 case RewriteTest: return new RewriteTestAction();
103 case RewriteMacros: Action = "RewriteMacros"; break;
104 case RewriteObjC: Action = "RewriteObjC"; break;
105 case RewriteTest: Action = "RewriteTest"; break;
107 #ifdef CLANG_ENABLE_ARCMT
108 case MigrateSource: return new arcmt::MigrateSourceAction();
110 case MigrateSource: Action = "MigrateSource"; break;
112 #ifdef CLANG_ENABLE_STATIC_ANALYZER
113 case RunAnalysis: return new ento::AnalysisAction();
115 case RunAnalysis: Action = "RunAnalysis"; break;
117 case RunPreprocessorOnly: return new PreprocessOnlyAction();
120 #if !defined(CLANG_ENABLE_ARCMT) || !defined(CLANG_ENABLE_STATIC_ANALYZER) \
121 || !defined(CLANG_ENABLE_REWRITER)
122 CI.getDiagnostics().Report(diag::err_fe_action_not_available) << Action;
125 llvm_unreachable("Invalid program action!");
129 static FrontendAction *CreateFrontendAction(CompilerInstance &CI) {
130 // Create the underlying action.
131 FrontendAction *Act = CreateFrontendBaseAction(CI);
135 const FrontendOptions &FEOpts = CI.getFrontendOpts();
137 #ifdef CLANG_ENABLE_REWRITER
138 if (FEOpts.FixAndRecompile) {
139 Act = new FixItRecompile(Act);
143 #ifdef CLANG_ENABLE_ARCMT
144 // Potentially wrap the base FE action in an ARC Migrate Tool action.
145 switch (FEOpts.ARCMTAction) {
146 case FrontendOptions::ARCMT_None:
148 case FrontendOptions::ARCMT_Check:
149 Act = new arcmt::CheckAction(Act);
151 case FrontendOptions::ARCMT_Modify:
152 Act = new arcmt::ModifyAction(Act);
154 case FrontendOptions::ARCMT_Migrate:
155 Act = new arcmt::MigrateAction(Act,
157 FEOpts.ARCMTMigrateReportOut,
158 FEOpts.ARCMTMigrateEmitARCErrors);
162 if (FEOpts.ObjCMTAction != FrontendOptions::ObjCMT_None) {
163 Act = new arcmt::ObjCMigrateAction(Act, FEOpts.MTMigrateDir,
164 FEOpts.ObjCMTAction & ~FrontendOptions::ObjCMT_Literals,
165 FEOpts.ObjCMTAction & ~FrontendOptions::ObjCMT_Subscripting);
169 // If there are any AST files to merge, create a frontend action
170 // adaptor to perform the merge.
171 if (!FEOpts.ASTMergeFiles.empty())
172 Act = new ASTMergeAction(Act, FEOpts.ASTMergeFiles);
177 bool clang::ExecuteCompilerInvocation(CompilerInstance *Clang) {
179 if (Clang->getFrontendOpts().ShowHelp) {
180 OwningPtr<driver::OptTable> Opts(driver::createDriverOptTable());
181 Opts->PrintHelp(llvm::outs(), "clang -cc1",
182 "LLVM 'Clang' Compiler: http://clang.llvm.org",
183 /*Include=*/driver::options::CC1Option,
190 // FIXME: Use a better -version message?
191 if (Clang->getFrontendOpts().ShowVersion) {
192 llvm::cl::PrintVersionMessage();
196 // Load any requested plugins.
198 e = Clang->getFrontendOpts().Plugins.size(); i != e; ++i) {
199 const std::string &Path = Clang->getFrontendOpts().Plugins[i];
201 if (llvm::sys::DynamicLibrary::LoadLibraryPermanently(Path.c_str(), &Error))
202 Clang->getDiagnostics().Report(diag::err_fe_unable_to_load_plugin)
208 // FIXME: Remove this, one day.
209 // This should happen AFTER plugins have been loaded!
210 if (!Clang->getFrontendOpts().LLVMArgs.empty()) {
211 unsigned NumArgs = Clang->getFrontendOpts().LLVMArgs.size();
212 const char **Args = new const char*[NumArgs + 2];
213 Args[0] = "clang (LLVM option parsing)";
214 for (unsigned i = 0; i != NumArgs; ++i)
215 Args[i + 1] = Clang->getFrontendOpts().LLVMArgs[i].c_str();
216 Args[NumArgs + 1] = 0;
217 llvm::cl::ParseCommandLineOptions(NumArgs + 1, Args);
220 #ifdef CLANG_ENABLE_STATIC_ANALYZER
221 // Honor -analyzer-checker-help.
222 // This should happen AFTER plugins have been loaded!
223 if (Clang->getAnalyzerOpts()->ShowCheckerHelp) {
224 ento::printCheckerHelp(llvm::outs(), Clang->getFrontendOpts().Plugins);
229 // If there were errors in processing arguments, don't do anything else.
230 if (Clang->getDiagnostics().hasErrorOccurred())
232 // Create and execute the frontend action.
233 OwningPtr<FrontendAction> Act(CreateFrontendAction(*Clang));
236 bool Success = Clang->ExecuteAction(*Act);
237 if (Clang->getFrontendOpts().DisableFree)