1//===--- ExecuteCompilerInvocation.cpp ------------------------------------===//
2//
3// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
4// See https://llvm.org/LICENSE.txt for license information.
5// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
6//
7//===----------------------------------------------------------------------===//
8//
9// This file holds ExecuteCompilerInvocation(). It is split into its own file to
10// minimize the impact of pulling in essentially everything else in Clang.
11//
12//===----------------------------------------------------------------------===//
13
14#include "clang/ARCMigrate/ARCMTActions.h"
15#include "clang/CodeGen/CodeGenAction.h"
16#include "clang/Config/config.h"
17#include "clang/Driver/Options.h"
18#include "clang/ExtractAPI/FrontendActions.h"
19#include "clang/Frontend/CompilerInstance.h"
20#include "clang/Frontend/CompilerInvocation.h"
21#include "clang/Frontend/FrontendActions.h"
22#include "clang/Frontend/FrontendDiagnostic.h"
23#include "clang/Frontend/FrontendPluginRegistry.h"
24#include "clang/Frontend/Utils.h"
25#include "clang/FrontendTool/Utils.h"
26#include "clang/Rewrite/Frontend/FrontendActions.h"
27#include "clang/StaticAnalyzer/Frontend/AnalyzerHelpFlags.h"
28#include "clang/StaticAnalyzer/Frontend/FrontendActions.h"
29#include "llvm/Option/OptTable.h"
30#include "llvm/Option/Option.h"
31#include "llvm/Support/BuryPointer.h"
32#include "llvm/Support/DynamicLibrary.h"
33#include "llvm/Support/ErrorHandling.h"
34using namespace clang;
35using namespace llvm::opt;
36
37namespace clang {
38
39static std::unique_ptr<FrontendAction>
40CreateFrontendBaseAction(CompilerInstance &CI) {
41 using namespace clang::frontend;
42 StringRef Action("unknown");
43 (void)Action;
44
45 switch (CI.getFrontendOpts().ProgramAction) {
46 case ASTDeclList: return std::make_unique<ASTDeclListAction>();
47 case ASTDump: return std::make_unique<ASTDumpAction>();
48 case ASTPrint: return std::make_unique<ASTPrintAction>();
49 case ASTView: return std::make_unique<ASTViewAction>();
50 case DumpCompilerOptions:
51 return std::make_unique<DumpCompilerOptionsAction>();
52 case DumpRawTokens: return std::make_unique<DumpRawTokensAction>();
53 case DumpTokens: return std::make_unique<DumpTokensAction>();
54 case EmitAssembly: return std::make_unique<EmitAssemblyAction>();
55 case EmitBC: return std::make_unique<EmitBCAction>();
56 case EmitHTML: return std::make_unique<HTMLPrintAction>();
57 case EmitLLVM: return std::make_unique<EmitLLVMAction>();
58 case EmitLLVMOnly: return std::make_unique<EmitLLVMOnlyAction>();
59 case EmitCodeGenOnly: return std::make_unique<EmitCodeGenOnlyAction>();
60 case EmitObj: return std::make_unique<EmitObjAction>();
61 case ExtractAPI:
62 return std::make_unique<ExtractAPIAction>();
63 case FixIt: return std::make_unique<FixItAction>();
64 case GenerateModule:
65 return std::make_unique<GenerateModuleFromModuleMapAction>();
66 case GenerateModuleInterface:
67 return std::make_unique<GenerateModuleInterfaceAction>();
68 case GenerateHeaderUnit:
69 return std::make_unique<GenerateHeaderUnitAction>();
70 case GeneratePCH: return std::make_unique<GeneratePCHAction>();
71 case GenerateInterfaceStubs:
72 return std::make_unique<GenerateInterfaceStubsAction>();
73 case InitOnly: return std::make_unique<InitOnlyAction>();
74 case InstallAPI:
75 return std::make_unique<InstallAPIAction>();
76 case ParseSyntaxOnly: return std::make_unique<SyntaxOnlyAction>();
77 case ModuleFileInfo: return std::make_unique<DumpModuleInfoAction>();
78 case VerifyPCH: return std::make_unique<VerifyPCHAction>();
79 case TemplightDump: return std::make_unique<TemplightDumpAction>();
80
81 case PluginAction: {
82 for (const FrontendPluginRegistry::entry &Plugin :
83 FrontendPluginRegistry::entries()) {
84 if (Plugin.getName() == CI.getFrontendOpts().ActionName) {
85 std::unique_ptr<PluginASTAction> P(Plugin.instantiate());
86 if ((P->getActionType() != PluginASTAction::ReplaceAction &&
87 P->getActionType() != PluginASTAction::CmdlineAfterMainAction) ||
88 !P->ParseArgs(
89 CI,
90 arg: CI.getFrontendOpts().PluginArgs[std::string(Plugin.getName())]))
91 return nullptr;
92 return std::move(P);
93 }
94 }
95
96 CI.getDiagnostics().Report(diag::err_fe_invalid_plugin_name)
97 << CI.getFrontendOpts().ActionName;
98 return nullptr;
99 }
100
101 case PrintPreamble: return std::make_unique<PrintPreambleAction>();
102 case PrintPreprocessedInput: {
103 if (CI.getPreprocessorOutputOpts().RewriteIncludes ||
104 CI.getPreprocessorOutputOpts().RewriteImports)
105 return std::make_unique<RewriteIncludesAction>();
106 return std::make_unique<PrintPreprocessedAction>();
107 }
108
109 case RewriteMacros: return std::make_unique<RewriteMacrosAction>();
110 case RewriteTest: return std::make_unique<RewriteTestAction>();
111#if CLANG_ENABLE_OBJC_REWRITER
112 case RewriteObjC: return std::make_unique<RewriteObjCAction>();
113#else
114 case RewriteObjC: Action = "RewriteObjC"; break;
115#endif
116#if CLANG_ENABLE_ARCMT
117 case MigrateSource:
118 return std::make_unique<arcmt::MigrateSourceAction>();
119#else
120 case MigrateSource: Action = "MigrateSource"; break;
121#endif
122#if CLANG_ENABLE_STATIC_ANALYZER
123 case RunAnalysis: return std::make_unique<ento::AnalysisAction>();
124#else
125 case RunAnalysis: Action = "RunAnalysis"; break;
126#endif
127 case RunPreprocessorOnly: return std::make_unique<PreprocessOnlyAction>();
128 case PrintDependencyDirectivesSourceMinimizerOutput:
129 return std::make_unique<PrintDependencyDirectivesSourceMinimizerAction>();
130 }
131
132#if !CLANG_ENABLE_ARCMT || !CLANG_ENABLE_STATIC_ANALYZER \
133 || !CLANG_ENABLE_OBJC_REWRITER
134 CI.getDiagnostics().Report(diag::err_fe_action_not_available) << Action;
135 return 0;
136#else
137 llvm_unreachable("Invalid program action!");
138#endif
139}
140
141std::unique_ptr<FrontendAction>
142CreateFrontendAction(CompilerInstance &CI) {
143 // Create the underlying action.
144 std::unique_ptr<FrontendAction> Act = CreateFrontendBaseAction(CI);
145 if (!Act)
146 return nullptr;
147
148 const FrontendOptions &FEOpts = CI.getFrontendOpts();
149
150 if (FEOpts.FixAndRecompile) {
151 Act = std::make_unique<FixItRecompile>(args: std::move(Act));
152 }
153
154#if CLANG_ENABLE_ARCMT
155 if (CI.getFrontendOpts().ProgramAction != frontend::MigrateSource &&
156 CI.getFrontendOpts().ProgramAction != frontend::GeneratePCH) {
157 // Potentially wrap the base FE action in an ARC Migrate Tool action.
158 switch (FEOpts.ARCMTAction) {
159 case FrontendOptions::ARCMT_None:
160 break;
161 case FrontendOptions::ARCMT_Check:
162 Act = std::make_unique<arcmt::CheckAction>(args: std::move(Act));
163 break;
164 case FrontendOptions::ARCMT_Modify:
165 Act = std::make_unique<arcmt::ModifyAction>(args: std::move(Act));
166 break;
167 case FrontendOptions::ARCMT_Migrate:
168 Act = std::make_unique<arcmt::MigrateAction>(args: std::move(Act),
169 args: FEOpts.MTMigrateDir,
170 args: FEOpts.ARCMTMigrateReportOut,
171 args: FEOpts.ARCMTMigrateEmitARCErrors);
172 break;
173 }
174
175 if (FEOpts.ObjCMTAction != FrontendOptions::ObjCMT_None) {
176 Act = std::make_unique<arcmt::ObjCMigrateAction>(args: std::move(Act),
177 args: FEOpts.MTMigrateDir,
178 args: FEOpts.ObjCMTAction);
179 }
180 }
181#endif
182
183 // Wrap the base FE action in an extract api action to generate
184 // symbol graph as a biproduct of compilation ( enabled with
185 // --emit-symbol-graph option )
186 if (!FEOpts.SymbolGraphOutputDir.empty()) {
187 CI.getCodeGenOpts().ClearASTBeforeBackend = false;
188 Act = std::make_unique<WrappingExtractAPIAction>(args: std::move(Act));
189 }
190
191 // If there are any AST files to merge, create a frontend action
192 // adaptor to perform the merge.
193 if (!FEOpts.ASTMergeFiles.empty())
194 Act = std::make_unique<ASTMergeAction>(args: std::move(Act),
195 args: FEOpts.ASTMergeFiles);
196
197 return Act;
198}
199
200bool ExecuteCompilerInvocation(CompilerInstance *Clang) {
201 // Honor -help.
202 if (Clang->getFrontendOpts().ShowHelp) {
203 driver::getDriverOptTable().printHelp(
204 OS&: llvm::outs(), Usage: "clang -cc1 [options] file...",
205 Title: "LLVM 'Clang' Compiler: http://clang.llvm.org",
206 /*ShowHidden=*/false, /*ShowAllAliases=*/false,
207 VisibilityMask: llvm::opt::Visibility(driver::options::CC1Option));
208 return true;
209 }
210
211 // Honor -version.
212 //
213 // FIXME: Use a better -version message?
214 if (Clang->getFrontendOpts().ShowVersion) {
215 llvm::cl::PrintVersionMessage();
216 return true;
217 }
218
219 Clang->LoadRequestedPlugins();
220
221 // Honor -mllvm.
222 //
223 // FIXME: Remove this, one day.
224 // This should happen AFTER plugins have been loaded!
225 if (!Clang->getFrontendOpts().LLVMArgs.empty()) {
226 unsigned NumArgs = Clang->getFrontendOpts().LLVMArgs.size();
227 auto Args = std::make_unique<const char*[]>(num: NumArgs + 2);
228 Args[0] = "clang (LLVM option parsing)";
229 for (unsigned i = 0; i != NumArgs; ++i)
230 Args[i + 1] = Clang->getFrontendOpts().LLVMArgs[i].c_str();
231 Args[NumArgs + 1] = nullptr;
232 llvm::cl::ParseCommandLineOptions(argc: NumArgs + 1, argv: Args.get());
233 }
234
235#if CLANG_ENABLE_STATIC_ANALYZER
236 // These should happen AFTER plugins have been loaded!
237
238 AnalyzerOptions &AnOpts = Clang->getAnalyzerOpts();
239
240 // Honor -analyzer-checker-help and -analyzer-checker-help-hidden.
241 if (AnOpts.ShowCheckerHelp || AnOpts.ShowCheckerHelpAlpha ||
242 AnOpts.ShowCheckerHelpDeveloper) {
243 ento::printCheckerHelp(OS&: llvm::outs(), CI&: *Clang);
244 return true;
245 }
246
247 // Honor -analyzer-checker-option-help.
248 if (AnOpts.ShowCheckerOptionList || AnOpts.ShowCheckerOptionAlphaList ||
249 AnOpts.ShowCheckerOptionDeveloperList) {
250 ento::printCheckerConfigList(OS&: llvm::outs(), CI&: *Clang);
251 return true;
252 }
253
254 // Honor -analyzer-list-enabled-checkers.
255 if (AnOpts.ShowEnabledCheckerList) {
256 ento::printEnabledCheckerList(OS&: llvm::outs(), CI&: *Clang);
257 return true;
258 }
259
260 // Honor -analyzer-config-help.
261 if (AnOpts.ShowConfigOptionsList) {
262 ento::printAnalyzerConfigList(OS&: llvm::outs());
263 return true;
264 }
265#endif
266
267 // If there were errors in processing arguments, don't do anything else.
268 if (Clang->getDiagnostics().hasErrorOccurred())
269 return false;
270 // Create and execute the frontend action.
271 std::unique_ptr<FrontendAction> Act(CreateFrontendAction(CI&: *Clang));
272 if (!Act)
273 return false;
274 bool Success = Clang->ExecuteAction(Act&: *Act);
275 if (Clang->getFrontendOpts().DisableFree)
276 llvm::BuryPointer(Ptr: std::move(Act));
277 return Success;
278}
279
280} // namespace clang
281

source code of clang/lib/FrontendTool/ExecuteCompilerInvocation.cpp