blob: 7f9c3771f14babe6d2d034749a36008aa0bec994 [file] [log] [blame]
Daniel Dunbarcea0c702010-02-25 04:37:45 +00001//===--- CodeGenAction.cpp - LLVM Code Generation Frontend Action ---------===//
Daniel Dunbarc13935e2008-10-21 23:49:24 +00002//
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
Justin Lebarb080b632017-01-25 21:29:48 +000010#include "clang/CodeGen/CodeGenAction.h"
11#include "CodeGenModule.h"
Alex Lorenzee024992014-08-04 18:41:51 +000012#include "CoverageMappingGen.h"
Amjad Aboud546bc112017-02-09 22:07:24 +000013#include "MacroPPCallbacks.h"
Chris Lattner5bbb3c82009-03-29 16:50:03 +000014#include "clang/AST/ASTConsumer.h"
Daniel Dunbarb9bbd542009-11-15 06:48:46 +000015#include "clang/AST/ASTContext.h"
Hans Wennborga926d842014-05-23 20:37:38 +000016#include "clang/AST/DeclCXX.h"
Chandler Carruth0d9593d2015-01-14 11:29:14 +000017#include "clang/AST/DeclGroup.h"
Chandler Carruth3a022472012-12-04 09:13:33 +000018#include "clang/Basic/FileManager.h"
19#include "clang/Basic/SourceManager.h"
20#include "clang/Basic/TargetInfo.h"
Daniel Dunbarc1b17292010-06-15 17:48:49 +000021#include "clang/CodeGen/BackendUtil.h"
Daniel Dunbarb9bbd542009-11-15 06:48:46 +000022#include "clang/CodeGen/ModuleBuilder.h"
Daniel Dunbarcea0c702010-02-25 04:37:45 +000023#include "clang/Frontend/CompilerInstance.h"
Daniel Dunbaracadc552009-12-03 09:12:54 +000024#include "clang/Frontend/FrontendDiagnostic.h"
Chandler Carruth0d9593d2015-01-14 11:29:14 +000025#include "clang/Lex/Preprocessor.h"
Teresa Johnsonffc4e242016-11-11 05:35:12 +000026#include "llvm/Bitcode/BitcodeReader.h"
Adam Nemet7b796f82017-01-26 04:07:11 +000027#include "llvm/CodeGen/MachineOptimizationRemarkEmitter.h"
Diego Novillo829b1702014-04-16 16:54:24 +000028#include "llvm/IR/DebugInfo.h"
Quentin Colombet728c5542014-02-06 18:30:43 +000029#include "llvm/IR/DiagnosticInfo.h"
30#include "llvm/IR/DiagnosticPrinter.h"
Jonas Devlieghere5eb9c812017-03-13 18:08:11 +000031#include "llvm/IR/GlobalValue.h"
Chandler Carruthffd55512013-01-02 11:45:17 +000032#include "llvm/IR/LLVMContext.h"
33#include "llvm/IR/Module.h"
Chandler Carruthb45836a2013-03-26 02:25:54 +000034#include "llvm/IRReader/IRReader.h"
Chandler Carruth00fa3f72014-03-06 03:46:44 +000035#include "llvm/Linker/Linker.h"
Daniel Dunbar3e111522010-06-07 23:21:04 +000036#include "llvm/Pass.h"
Chris Lattner5ec32e72010-04-06 18:38:50 +000037#include "llvm/Support/MemoryBuffer.h"
38#include "llvm/Support/SourceMgr.h"
Chris Lattner263d64c2009-02-18 01:37:30 +000039#include "llvm/Support/Timer.h"
Hal Finkel8f96e822016-10-11 00:26:09 +000040#include "llvm/Support/ToolOutputFile.h"
41#include "llvm/Support/YAMLTraits.h"
Jonas Devlieghere5eb9c812017-03-13 18:08:11 +000042#include "llvm/Transforms/IPO/Internalize.h"
43
Ahmed Charlesdfca6f92014-03-09 11:36:40 +000044#include <memory>
Daniel Dunbarc13935e2008-10-21 23:49:24 +000045using namespace clang;
46using namespace llvm;
47
Nico Weber2992efa2011-01-25 20:34:14 +000048namespace clang {
Vivek Pandya1dee3be2017-09-15 20:09:55 +000049 class BackendConsumer;
50 class ClangDiagnosticHandler final : public DiagnosticHandler {
51 public:
52 ClangDiagnosticHandler(const CodeGenOptions &CGOpts, BackendConsumer *BCon)
53 : CodeGenOpts(CGOpts), BackendCon(BCon) {}
54
55 bool handleDiagnostics(const DiagnosticInfo &DI) override;
Adam Nemet5d2eb162017-09-19 17:59:40 +000056
57 bool isAnalysisRemarkEnabled(StringRef PassName) const override {
Vivek Pandya1dee3be2017-09-15 20:09:55 +000058 return (CodeGenOpts.OptimizationRemarkAnalysisPattern &&
59 CodeGenOpts.OptimizationRemarkAnalysisPattern->match(PassName));
60 }
Adam Nemet5d2eb162017-09-19 17:59:40 +000061 bool isMissedOptRemarkEnabled(StringRef PassName) const override {
Vivek Pandya1dee3be2017-09-15 20:09:55 +000062 return (CodeGenOpts.OptimizationRemarkMissedPattern &&
63 CodeGenOpts.OptimizationRemarkMissedPattern->match(PassName));
64 }
Adam Nemet5d2eb162017-09-19 17:59:40 +000065 bool isPassedOptRemarkEnabled(StringRef PassName) const override {
Vivek Pandya1dee3be2017-09-15 20:09:55 +000066 return (CodeGenOpts.OptimizationRemarkPattern &&
67 CodeGenOpts.OptimizationRemarkPattern->match(PassName));
68 }
Adam Nemet5d2eb162017-09-19 17:59:40 +000069
Adam Nemet3ac802a2017-09-19 23:00:59 +000070 bool isAnyRemarkEnabled() const override {
71 return (CodeGenOpts.OptimizationRemarkAnalysisPattern ||
72 CodeGenOpts.OptimizationRemarkMissedPattern ||
73 CodeGenOpts.OptimizationRemarkPattern);
74 }
75
Vivek Pandya1dee3be2017-09-15 20:09:55 +000076 private:
77 const CodeGenOptions &CodeGenOpts;
78 BackendConsumer *BackendCon;
79 };
80
Benjamin Kramer16634c22009-11-28 10:07:24 +000081 class BackendConsumer : public ASTConsumer {
Justin Lebarb080b632017-01-25 21:29:48 +000082 using LinkModule = CodeGenAction::LinkModule;
83
David Blaikie68e081d2011-12-20 02:48:34 +000084 virtual void anchor();
David Blaikie9c902b52011-09-25 23:23:43 +000085 DiagnosticsEngine &Diags;
Daniel Dunbarc13935e2008-10-21 23:49:24 +000086 BackendAction Action;
Saleem Abdulrasool888e2892017-01-05 16:02:32 +000087 const HeaderSearchOptions &HeaderSearchOpts;
Daniel Dunbarde182242009-11-30 08:39:32 +000088 const CodeGenOptions &CodeGenOpts;
Daniel Dunbarde182242009-11-30 08:39:32 +000089 const TargetOptions &TargetOpts;
Dan Gohmanfec0ff82011-07-05 22:02:36 +000090 const LangOptions &LangOpts;
Peter Collingbourne03f89072016-07-15 00:55:40 +000091 std::unique_ptr<raw_pwrite_stream> AsmOutStream;
Chris Lattnereae6cb62009-03-05 08:00:35 +000092 ASTContext *Context;
Daniel Dunbarb3a36cf2008-10-29 08:50:02 +000093
Chris Lattner263d64c2009-02-18 01:37:30 +000094 Timer LLVMIRGeneration;
Davide Italianob99fabd2016-07-21 06:28:48 +000095 unsigned LLVMIRGenerationRefCount;
Mike Stump11289f42009-09-09 15:08:12 +000096
Reid Kleckner15241ba2016-11-30 00:25:36 +000097 /// True if we've finished generating IR. This prevents us from generating
98 /// additional LLVM IR after emitting output in HandleTranslationUnit. This
99 /// can happen when Clang plugins trigger additional AST deserialization.
100 bool IRGenFinished = false;
101
Ahmed Charlesb8984322014-03-07 20:03:18 +0000102 std::unique_ptr<CodeGenerator> Gen;
Mike Stump11289f42009-09-09 15:08:12 +0000103
Justin Lebarb080b632017-01-25 21:29:48 +0000104 SmallVector<LinkModule, 4> LinkModules;
Daniel Dunbarc13935e2008-10-21 23:49:24 +0000105
Rafael Espindola8ce88a52015-12-14 23:17:07 +0000106 // This is here so that the diagnostic printer knows the module a diagnostic
107 // refers to.
108 llvm::Module *CurLinkModule = nullptr;
109
Mike Stump11289f42009-09-09 15:08:12 +0000110 public:
Justin Lebarb080b632017-01-25 21:29:48 +0000111 BackendConsumer(BackendAction Action, DiagnosticsEngine &Diags,
112 const HeaderSearchOptions &HeaderSearchOpts,
113 const PreprocessorOptions &PPOpts,
114 const CodeGenOptions &CodeGenOpts,
115 const TargetOptions &TargetOpts,
116 const LangOptions &LangOpts, bool TimePasses,
117 const std::string &InFile,
118 SmallVector<LinkModule, 4> LinkModules,
119 std::unique_ptr<raw_pwrite_stream> OS, LLVMContext &C,
120 CoverageSourceInfo *CoverageInfo = nullptr)
Saleem Abdulrasool888e2892017-01-05 16:02:32 +0000121 : Diags(Diags), Action(Action), HeaderSearchOpts(HeaderSearchOpts),
122 CodeGenOpts(CodeGenOpts), TargetOpts(TargetOpts), LangOpts(LangOpts),
Peter Collingbourne03f89072016-07-15 00:55:40 +0000123 AsmOutStream(std::move(OS)), Context(nullptr),
Matthias Braunae032b62016-11-18 19:43:25 +0000124 LLVMIRGeneration("irgen", "LLVM IR Generation Time"),
Davide Italianob99fabd2016-07-21 06:28:48 +0000125 LLVMIRGenerationRefCount(0),
Adrian Prantle74f5252015-06-30 02:26:03 +0000126 Gen(CreateLLVMCodeGen(Diags, InFile, HeaderSearchOpts, PPOpts,
Justin Lebarb080b632017-01-25 21:29:48 +0000127 CodeGenOpts, C, CoverageInfo)),
128 LinkModules(std::move(LinkModules)) {
Daniel Dunbar8e705052009-11-30 08:39:52 +0000129 llvm::TimePassesIsEnabled = TimePasses;
Chris Lattnerdeffa132009-02-18 01:23:44 +0000130 }
Serge Pavlov41c1f792016-02-18 16:42:09 +0000131 llvm::Module *getModule() const { return Gen->GetModule(); }
132 std::unique_ptr<llvm::Module> takeModule() {
133 return std::unique_ptr<llvm::Module>(Gen->ReleaseModule());
134 }
Daniel Dunbar400a6932010-02-25 04:37:50 +0000135
Amjad Aboud546bc112017-02-09 22:07:24 +0000136 CodeGenerator *getCodeGenerator() { return Gen.get(); }
137
Craig Topper4f12f102014-03-12 06:41:41 +0000138 void HandleCXXStaticMemberVarInstantiation(VarDecl *VD) override {
Rafael Espindoladf88f6f2012-03-08 15:51:03 +0000139 Gen->HandleCXXStaticMemberVarInstantiation(VD);
Rafael Espindola189fa742012-03-05 10:54:55 +0000140 }
141
Craig Topper4f12f102014-03-12 06:41:41 +0000142 void Initialize(ASTContext &Ctx) override {
Richard Smith293534b2015-08-18 20:39:29 +0000143 assert(!Context && "initialized multiple times");
144
Chris Lattner5cf49fe2009-03-28 02:18:25 +0000145 Context = &Ctx;
Mike Stump11289f42009-09-09 15:08:12 +0000146
Daniel Dunbar8e705052009-11-30 08:39:52 +0000147 if (llvm::TimePassesIsEnabled)
Chris Lattner263d64c2009-02-18 01:37:30 +0000148 LLVMIRGeneration.startTimer();
Mike Stump11289f42009-09-09 15:08:12 +0000149
Chris Lattner5cf49fe2009-03-28 02:18:25 +0000150 Gen->Initialize(Ctx);
Daniel Dunbarc13935e2008-10-21 23:49:24 +0000151
Daniel Dunbar8e705052009-11-30 08:39:52 +0000152 if (llvm::TimePassesIsEnabled)
Chris Lattner263d64c2009-02-18 01:37:30 +0000153 LLVMIRGeneration.stopTimer();
Daniel Dunbarc13935e2008-10-21 23:49:24 +0000154 }
Mike Stump11289f42009-09-09 15:08:12 +0000155
Craig Topper4f12f102014-03-12 06:41:41 +0000156 bool HandleTopLevelDecl(DeclGroupRef D) override {
Chris Lattner5bbb3c82009-03-29 16:50:03 +0000157 PrettyStackTraceDecl CrashInfo(*D.begin(), SourceLocation(),
Chris Lattnereae6cb62009-03-05 08:00:35 +0000158 Context->getSourceManager(),
159 "LLVM IR generation of declaration");
Mike Stump11289f42009-09-09 15:08:12 +0000160
Davide Italianob99fabd2016-07-21 06:28:48 +0000161 // Recurse.
162 if (llvm::TimePassesIsEnabled) {
163 LLVMIRGenerationRefCount += 1;
164 if (LLVMIRGenerationRefCount == 1)
165 LLVMIRGeneration.startTimer();
166 }
Chris Lattner5bbb3c82009-03-29 16:50:03 +0000167
Daniel Dunbarc13935e2008-10-21 23:49:24 +0000168 Gen->HandleTopLevelDecl(D);
Chris Lattner263d64c2009-02-18 01:37:30 +0000169
Davide Italianob99fabd2016-07-21 06:28:48 +0000170 if (llvm::TimePassesIsEnabled) {
171 LLVMIRGenerationRefCount -= 1;
172 if (LLVMIRGenerationRefCount == 0)
173 LLVMIRGeneration.stopTimer();
174 }
Argyrios Kyrtzidis841dd882011-11-18 00:26:59 +0000175
176 return true;
Daniel Dunbarc13935e2008-10-21 23:49:24 +0000177 }
Mike Stump11289f42009-09-09 15:08:12 +0000178
Stephan Bergmann17d7d142016-03-30 06:27:31 +0000179 void HandleInlineFunctionDefinition(FunctionDecl *D) override {
Hans Wennborga926d842014-05-23 20:37:38 +0000180 PrettyStackTraceDecl CrashInfo(D, SourceLocation(),
181 Context->getSourceManager(),
Stephan Bergmann17d7d142016-03-30 06:27:31 +0000182 "LLVM IR generation of inline function");
Hans Wennborga926d842014-05-23 20:37:38 +0000183 if (llvm::TimePassesIsEnabled)
184 LLVMIRGeneration.startTimer();
185
Stephan Bergmann17d7d142016-03-30 06:27:31 +0000186 Gen->HandleInlineFunctionDefinition(D);
Hans Wennborga926d842014-05-23 20:37:38 +0000187
188 if (llvm::TimePassesIsEnabled)
189 LLVMIRGeneration.stopTimer();
190 }
191
Reid Kleckner68c4bb52016-11-30 01:32:53 +0000192 void HandleInterestingDecl(DeclGroupRef D) override {
Reid Kleckner15241ba2016-11-30 00:25:36 +0000193 // Ignore interesting decls from the AST reader after IRGen is finished.
194 if (!IRGenFinished)
195 HandleTopLevelDecl(D);
196 }
197
Justin Lebarb080b632017-01-25 21:29:48 +0000198 // Links each entry in LinkModules into our module. Returns true on error.
199 bool LinkInModules() {
200 for (auto &LM : LinkModules) {
201 if (LM.PropagateAttrs)
202 for (Function &F : *LM.Module)
203 Gen->CGM().AddDefaultFnAttrs(F);
204
205 CurLinkModule = LM.Module.get();
Jonas Devlieghere5eb9c812017-03-13 18:08:11 +0000206
207 bool Err;
208 if (LM.Internalize) {
209 Err = Linker::linkModules(
210 *getModule(), std::move(LM.Module), LM.LinkFlags,
211 [](llvm::Module &M, const llvm::StringSet<> &GVS) {
Reid Kleckner987a2812017-03-13 22:33:07 +0000212 internalizeModule(M, [&GVS](const llvm::GlobalValue &GV) {
Jonas Devlieghere5eb9c812017-03-13 18:08:11 +0000213 return !GV.hasName() || (GVS.count(GV.getName()) == 0);
214 });
215 });
216 } else {
217 Err = Linker::linkModules(*getModule(), std::move(LM.Module),
218 LM.LinkFlags);
219 }
220
221 if (Err)
Justin Lebarb080b632017-01-25 21:29:48 +0000222 return true;
223 }
224 return false; // success
225 }
226
Craig Topper4f12f102014-03-12 06:41:41 +0000227 void HandleTranslationUnit(ASTContext &C) override {
Chris Lattnereae6cb62009-03-05 08:00:35 +0000228 {
Chris Lattnere46de752009-03-06 06:46:31 +0000229 PrettyStackTraceString CrashInfo("Per-file LLVM IR generation");
Davide Italianob99fabd2016-07-21 06:28:48 +0000230 if (llvm::TimePassesIsEnabled) {
231 LLVMIRGenerationRefCount += 1;
232 if (LLVMIRGenerationRefCount == 1)
233 LLVMIRGeneration.startTimer();
234 }
Chris Lattner263d64c2009-02-18 01:37:30 +0000235
Chris Lattnercf169832009-03-28 04:11:33 +0000236 Gen->HandleTranslationUnit(C);
Daniel Dunbara94d8732008-11-11 06:35:39 +0000237
Davide Italianob99fabd2016-07-21 06:28:48 +0000238 if (llvm::TimePassesIsEnabled) {
239 LLVMIRGenerationRefCount -= 1;
240 if (LLVMIRGenerationRefCount == 0)
241 LLVMIRGeneration.stopTimer();
242 }
Reid Kleckner15241ba2016-11-30 00:25:36 +0000243
244 IRGenFinished = true;
Chris Lattnereae6cb62009-03-05 08:00:35 +0000245 }
Chris Lattner263d64c2009-02-18 01:37:30 +0000246
Daniel Dunbarf976d1b2010-06-07 23:20:08 +0000247 // Silently ignore if we weren't initialized for some reason.
Serge Pavlov41c1f792016-02-18 16:42:09 +0000248 if (!getModule())
Daniel Dunbarf976d1b2010-06-07 23:20:08 +0000249 return;
Mike Stump11289f42009-09-09 15:08:12 +0000250
Daniel Dunbarf976d1b2010-06-07 23:20:08 +0000251 // Install an inline asm handler so that diagnostics get printed through
252 // our diagnostics hooks.
Serge Pavlov41c1f792016-02-18 16:42:09 +0000253 LLVMContext &Ctx = getModule()->getContext();
Chris Lattner068f2ab2010-11-17 08:13:04 +0000254 LLVMContext::InlineAsmDiagHandlerTy OldHandler =
255 Ctx.getInlineAsmDiagnosticHandler();
Daniel Dunbarf976d1b2010-06-07 23:20:08 +0000256 void *OldContext = Ctx.getInlineAsmDiagnosticContext();
Chris Lattner068f2ab2010-11-17 08:13:04 +0000257 Ctx.setInlineAsmDiagnosticHandler(InlineAsmDiagHandler, this);
Daniel Dunbarf976d1b2010-06-07 23:20:08 +0000258
Vivek Pandya1dee3be2017-09-15 20:09:55 +0000259 std::unique_ptr<DiagnosticHandler> OldDiagnosticHandler =
Quentin Colombet728c5542014-02-06 18:30:43 +0000260 Ctx.getDiagnosticHandler();
Vivek Pandya1dee3be2017-09-15 20:09:55 +0000261 Ctx.setDiagnosticHandler(llvm::make_unique<ClangDiagnosticHandler>(
262 CodeGenOpts, this));
Brian Gesiak9f59da82017-06-30 19:37:11 +0000263 Ctx.setDiagnosticsHotnessRequested(CodeGenOpts.DiagnosticsWithHotness);
Brian Gesiak562eab92017-07-01 05:45:26 +0000264 if (CodeGenOpts.DiagnosticsHotnessThreshold != 0)
265 Ctx.setDiagnosticsHotnessThreshold(
266 CodeGenOpts.DiagnosticsHotnessThreshold);
Quentin Colombet728c5542014-02-06 18:30:43 +0000267
Reid Kleckner3fc649c2017-09-23 01:03:17 +0000268 std::unique_ptr<llvm::ToolOutputFile> OptRecordFile;
Hal Finkel8f96e822016-10-11 00:26:09 +0000269 if (!CodeGenOpts.OptRecordFile.empty()) {
270 std::error_code EC;
Reid Kleckner3fc649c2017-09-23 01:03:17 +0000271 OptRecordFile = llvm::make_unique<llvm::ToolOutputFile>(
272 CodeGenOpts.OptRecordFile, EC, sys::fs::F_None);
Hal Finkel8f96e822016-10-11 00:26:09 +0000273 if (EC) {
274 Diags.Report(diag::err_cannot_open_file) <<
275 CodeGenOpts.OptRecordFile << EC.message();
276 return;
277 }
278
Mehdi Amini6f408362016-11-19 18:19:41 +0000279 Ctx.setDiagnosticsOutputFile(
280 llvm::make_unique<yaml::Output>(OptRecordFile->os()));
Hal Finkel8f96e822016-10-11 00:26:09 +0000281
282 if (CodeGenOpts.getProfileUse() != CodeGenOptions::ProfileNone)
Brian Gesiak9f59da82017-06-30 19:37:11 +0000283 Ctx.setDiagnosticsHotnessRequested(true);
Hal Finkel8f96e822016-10-11 00:26:09 +0000284 }
285
Justin Lebarb080b632017-01-25 21:29:48 +0000286 // Link each LinkModule into our module.
287 if (LinkInModules())
288 return;
Rafael Espindola8ce88a52015-12-14 23:17:07 +0000289
Steven Wu27fb5222016-05-11 16:26:03 +0000290 EmbedBitcode(getModule(), CodeGenOpts, llvm::MemoryBufferRef());
291
Saleem Abdulrasool888e2892017-01-05 16:02:32 +0000292 EmitBackendOutput(Diags, HeaderSearchOpts, CodeGenOpts, TargetOpts,
293 LangOpts, C.getTargetInfo().getDataLayout(),
Peter Collingbourne03f89072016-07-15 00:55:40 +0000294 getModule(), Action, std::move(AsmOutStream));
Rafael Espindola666a2ab2013-12-18 16:38:48 +0000295
Daniel Dunbarf976d1b2010-06-07 23:20:08 +0000296 Ctx.setInlineAsmDiagnosticHandler(OldHandler, OldContext);
Quentin Colombet728c5542014-02-06 18:30:43 +0000297
Vivek Pandya1dee3be2017-09-15 20:09:55 +0000298 Ctx.setDiagnosticHandler(std::move(OldDiagnosticHandler));
Hal Finkel8f96e822016-10-11 00:26:09 +0000299
300 if (OptRecordFile)
301 OptRecordFile->keep();
Daniel Dunbarc13935e2008-10-21 23:49:24 +0000302 }
Mike Stump11289f42009-09-09 15:08:12 +0000303
Craig Topper4f12f102014-03-12 06:41:41 +0000304 void HandleTagDeclDefinition(TagDecl *D) override {
Chris Lattnereae6cb62009-03-05 08:00:35 +0000305 PrettyStackTraceDecl CrashInfo(D, SourceLocation(),
306 Context->getSourceManager(),
307 "LLVM IR generation of declaration");
Daniel Dunbarc13935e2008-10-21 23:49:24 +0000308 Gen->HandleTagDeclDefinition(D);
309 }
Douglas Gregorbeecd582009-04-21 17:11:58 +0000310
Craig Topper4f12f102014-03-12 06:41:41 +0000311 void HandleTagDeclRequiredDefinition(const TagDecl *D) override {
David Blaikie48ad6dc2013-07-13 21:08:14 +0000312 Gen->HandleTagDeclRequiredDefinition(D);
313 }
314
Craig Topper4f12f102014-03-12 06:41:41 +0000315 void CompleteTentativeDefinition(VarDecl *D) override {
Douglas Gregorbeecd582009-04-21 17:11:58 +0000316 Gen->CompleteTentativeDefinition(D);
317 }
Daniel Dunbar50aa0a52010-04-29 16:29:09 +0000318
David Majnemer929025d2016-01-26 19:30:26 +0000319 void AssignInheritanceModel(CXXRecordDecl *RD) override {
320 Gen->AssignInheritanceModel(RD);
321 }
322
Nico Weberb6a5d052015-01-15 04:07:35 +0000323 void HandleVTable(CXXRecordDecl *RD) override {
324 Gen->HandleVTable(RD);
Douglas Gregor88d292c2010-05-13 16:44:06 +0000325 }
326
Chris Lattner5ec32e72010-04-06 18:38:50 +0000327 static void InlineAsmDiagHandler(const llvm::SMDiagnostic &SM,void *Context,
328 unsigned LocCookie) {
329 SourceLocation Loc = SourceLocation::getFromRawEncoding(LocCookie);
330 ((BackendConsumer*)Context)->InlineAsmDiagHandler2(SM, Loc);
331 }
Daniel Dunbar50aa0a52010-04-29 16:29:09 +0000332
Oliver Stannard91817852016-02-02 13:52:52 +0000333 /// Get the best possible source location to represent a diagnostic that
334 /// may have associated debug info.
335 const FullSourceLoc
Justin Bognere91e9dd2017-02-17 17:34:49 +0000336 getBestLocationFromDebugLoc(const llvm::DiagnosticInfoWithLocationBase &D,
Oliver Stannard91817852016-02-02 13:52:52 +0000337 bool &BadDebugInfo, StringRef &Filename,
338 unsigned &Line, unsigned &Column) const;
339
Chris Lattner5ec32e72010-04-06 18:38:50 +0000340 void InlineAsmDiagHandler2(const llvm::SMDiagnostic &,
341 SourceLocation LocCookie);
Quentin Colombet728c5542014-02-06 18:30:43 +0000342
343 void DiagnosticHandlerImpl(const llvm::DiagnosticInfo &DI);
344 /// \brief Specialized handler for InlineAsm diagnostic.
345 /// \return True if the diagnostic has been successfully reported, false
346 /// otherwise.
347 bool InlineAsmDiagHandler(const llvm::DiagnosticInfoInlineAsm &D);
348 /// \brief Specialized handler for StackSize diagnostic.
349 /// \return True if the diagnostic has been successfully reported, false
350 /// otherwise.
351 bool StackSizeDiagHandler(const llvm::DiagnosticInfoStackSize &D);
Oliver Stannard91817852016-02-02 13:52:52 +0000352 /// \brief Specialized handler for unsupported backend feature diagnostic.
353 void UnsupportedDiagHandler(const llvm::DiagnosticInfoUnsupported &D);
Diego Novillod23ec942014-05-29 19:55:06 +0000354 /// \brief Specialized handlers for optimization remarks.
355 /// Note that these handlers only accept remarks and they always handle
Diego Novillo829b1702014-04-16 16:54:24 +0000356 /// them.
Tyler Nowickif8a767d2014-07-18 19:40:19 +0000357 void EmitOptimizationMessage(const llvm::DiagnosticInfoOptimizationBase &D,
358 unsigned DiagID);
Adam Nemet7b796f82017-01-26 04:07:11 +0000359 void
360 OptimizationRemarkHandler(const llvm::DiagnosticInfoOptimizationBase &D);
Diego Novillod23ec942014-05-29 19:55:06 +0000361 void OptimizationRemarkHandler(
Adam Nemetb4e64a72016-09-27 22:19:29 +0000362 const llvm::OptimizationRemarkAnalysisFPCommute &D);
Diego Novillod23ec942014-05-29 19:55:06 +0000363 void OptimizationRemarkHandler(
Adam Nemetb4e64a72016-09-27 22:19:29 +0000364 const llvm::OptimizationRemarkAnalysisAliasing &D);
Tyler Nowickif8a767d2014-07-18 19:40:19 +0000365 void OptimizationFailureHandler(
366 const llvm::DiagnosticInfoOptimizationFailure &D);
Mike Stump11289f42009-09-09 15:08:12 +0000367 };
Jonas Devlieghere5eb9c812017-03-13 18:08:11 +0000368
David Blaikie68e081d2011-12-20 02:48:34 +0000369 void BackendConsumer::anchor() {}
Alexander Kornienkoab9db512015-06-22 23:07:51 +0000370}
Daniel Dunbarc13935e2008-10-21 23:49:24 +0000371
Vivek Pandya1dee3be2017-09-15 20:09:55 +0000372bool ClangDiagnosticHandler::handleDiagnostics(const DiagnosticInfo &DI) {
373 BackendCon->DiagnosticHandlerImpl(DI);
374 return true;
375}
376
Chris Lattner79f67a72010-04-08 00:23:06 +0000377/// ConvertBackendLocation - Convert a location in a temporary llvm::SourceMgr
378/// buffer to be a valid FullSourceLoc.
379static FullSourceLoc ConvertBackendLocation(const llvm::SMDiagnostic &D,
380 SourceManager &CSM) {
381 // Get both the clang and llvm source managers. The location is relative to
382 // a memory buffer that the LLVM Source Manager is handling, we need to add
Daniel Dunbar50aa0a52010-04-29 16:29:09 +0000383 // a copy to the Clang source manager.
Chris Lattner79f67a72010-04-08 00:23:06 +0000384 const llvm::SourceMgr &LSM = *D.getSourceMgr();
Daniel Dunbar50aa0a52010-04-29 16:29:09 +0000385
Chris Lattner79f67a72010-04-08 00:23:06 +0000386 // We need to copy the underlying LLVM memory buffer because llvm::SourceMgr
387 // already owns its one and clang::SourceManager wants to own its one.
388 const MemoryBuffer *LBuf =
389 LSM.getMemoryBuffer(LSM.FindBufferContainingLoc(D.getLoc()));
Daniel Dunbar50aa0a52010-04-29 16:29:09 +0000390
Chris Lattner79f67a72010-04-08 00:23:06 +0000391 // Create the copy and transfer ownership to clang::SourceManager.
Alp Tokeraa0dd5a2014-06-27 06:02:00 +0000392 // TODO: Avoid copying files into memory.
Rafael Espindolad87f8d72014-08-27 20:03:29 +0000393 std::unique_ptr<llvm::MemoryBuffer> CBuf =
394 llvm::MemoryBuffer::getMemBufferCopy(LBuf->getBuffer(),
395 LBuf->getBufferIdentifier());
Alp Tokeraa0dd5a2014-06-27 06:02:00 +0000396 // FIXME: Keep a file ID map instead of creating new IDs for each location.
David Blaikie50a5f972014-08-29 07:59:55 +0000397 FileID FID = CSM.createFileID(std::move(CBuf));
Daniel Dunbar50aa0a52010-04-29 16:29:09 +0000398
Chris Lattner79f67a72010-04-08 00:23:06 +0000399 // Translate the offset into the file.
Alp Tokeraa0dd5a2014-06-27 06:02:00 +0000400 unsigned Offset = D.getLoc().getPointer() - LBuf->getBufferStart();
Daniel Dunbar50aa0a52010-04-29 16:29:09 +0000401 SourceLocation NewLoc =
Argyrios Kyrtzidise6e67de2011-09-19 20:40:19 +0000402 CSM.getLocForStartOfFile(FID).getLocWithOffset(Offset);
Chris Lattner79f67a72010-04-08 00:23:06 +0000403 return FullSourceLoc(NewLoc, CSM);
404}
405
Chris Lattner6d672132010-04-06 17:52:14 +0000406
Chris Lattner5ec32e72010-04-06 18:38:50 +0000407/// InlineAsmDiagHandler2 - This function is invoked when the backend hits an
408/// error parsing inline asm. The SMDiagnostic indicates the error relative to
Daniel Dunbar50aa0a52010-04-29 16:29:09 +0000409/// the temporary memory buffer that the inline asm parser has set up.
Chris Lattner5ec32e72010-04-06 18:38:50 +0000410void BackendConsumer::InlineAsmDiagHandler2(const llvm::SMDiagnostic &D,
411 SourceLocation LocCookie) {
412 // There are a couple of different kinds of errors we could get here. First,
413 // we re-format the SMDiagnostic in terms of a clang diagnostic.
Argyrios Kyrtzidisa11b35a2012-02-01 06:36:49 +0000414
415 // Strip "error: " off the start of the message string.
Chris Lattner0e62c1c2011-07-23 10:55:15 +0000416 StringRef Message = D.getMessage();
Argyrios Kyrtzidisa11b35a2012-02-01 06:36:49 +0000417 if (Message.startswith("error: "))
418 Message = Message.substr(7);
Chris Lattner5ec32e72010-04-06 18:38:50 +0000419
Chris Lattnerc7ed7ea2010-06-15 00:03:12 +0000420 // If the SMDiagnostic has an inline asm source location, translate it.
Chris Lattner5ec32e72010-04-06 18:38:50 +0000421 FullSourceLoc Loc;
Chris Lattner79f67a72010-04-08 00:23:06 +0000422 if (D.getLoc() != SMLoc())
423 Loc = ConvertBackendLocation(D, Context->getSourceManager());
Argyrios Kyrtzidisa11b35a2012-02-01 06:36:49 +0000424
Joey Gouly5798b262014-06-05 21:23:42 +0000425 unsigned DiagID;
426 switch (D.getKind()) {
427 case llvm::SourceMgr::DK_Error:
428 DiagID = diag::err_fe_inline_asm;
429 break;
430 case llvm::SourceMgr::DK_Warning:
431 DiagID = diag::warn_fe_inline_asm;
432 break;
433 case llvm::SourceMgr::DK_Note:
434 DiagID = diag::note_fe_inline_asm;
435 break;
436 }
Chris Lattnerc7ed7ea2010-06-15 00:03:12 +0000437 // If this problem has clang-level source location information, report the
Joey Gouly5798b262014-06-05 21:23:42 +0000438 // issue in the source with a note showing the instantiated
Chris Lattnerc7ed7ea2010-06-15 00:03:12 +0000439 // code.
440 if (LocCookie.isValid()) {
Joey Gouly5798b262014-06-05 21:23:42 +0000441 Diags.Report(LocCookie, DiagID).AddString(Message);
Jonas Devlieghere5eb9c812017-03-13 18:08:11 +0000442
Benjamin Kramere06b2b72011-10-16 10:48:28 +0000443 if (D.getLoc().isValid()) {
444 DiagnosticBuilder B = Diags.Report(Loc, diag::note_fe_inline_asm_here);
445 // Convert the SMDiagnostic ranges into SourceRange and attach them
446 // to the diagnostic.
Yaron Kerenede60302015-08-01 19:11:36 +0000447 for (const std::pair<unsigned, unsigned> &Range : D.getRanges()) {
Benjamin Kramere06b2b72011-10-16 10:48:28 +0000448 unsigned Column = D.getColumnNo();
449 B << SourceRange(Loc.getLocWithOffset(Range.first - Column),
450 Loc.getLocWithOffset(Range.second - Column));
451 }
452 }
Chris Lattnerc7ed7ea2010-06-15 00:03:12 +0000453 return;
454 }
Jonas Devlieghere5eb9c812017-03-13 18:08:11 +0000455
Joey Gouly5798b262014-06-05 21:23:42 +0000456 // Otherwise, report the backend issue as occurring in the generated .s file.
457 // If Loc is invalid, we still need to report the issue, it just gets no
Chris Lattnerc7ed7ea2010-06-15 00:03:12 +0000458 // location info.
Joey Gouly5798b262014-06-05 21:23:42 +0000459 Diags.Report(Loc, DiagID).AddString(Message);
Chris Lattner5ec32e72010-04-06 18:38:50 +0000460}
461
Quentin Colombet728c5542014-02-06 18:30:43 +0000462#define ComputeDiagID(Severity, GroupName, DiagID) \
463 do { \
464 switch (Severity) { \
465 case llvm::DS_Error: \
466 DiagID = diag::err_fe_##GroupName; \
467 break; \
468 case llvm::DS_Warning: \
469 DiagID = diag::warn_fe_##GroupName; \
470 break; \
Tobias Grosser74160242014-02-28 09:11:08 +0000471 case llvm::DS_Remark: \
472 llvm_unreachable("'remark' severity not expected"); \
473 break; \
474 case llvm::DS_Note: \
475 DiagID = diag::note_fe_##GroupName; \
476 break; \
477 } \
478 } while (false)
479
480#define ComputeDiagRemarkID(Severity, GroupName, DiagID) \
481 do { \
482 switch (Severity) { \
483 case llvm::DS_Error: \
484 DiagID = diag::err_fe_##GroupName; \
485 break; \
486 case llvm::DS_Warning: \
487 DiagID = diag::warn_fe_##GroupName; \
488 break; \
489 case llvm::DS_Remark: \
490 DiagID = diag::remark_fe_##GroupName; \
491 break; \
Quentin Colombet728c5542014-02-06 18:30:43 +0000492 case llvm::DS_Note: \
493 DiagID = diag::note_fe_##GroupName; \
494 break; \
495 } \
496 } while (false)
497
498bool
499BackendConsumer::InlineAsmDiagHandler(const llvm::DiagnosticInfoInlineAsm &D) {
500 unsigned DiagID;
501 ComputeDiagID(D.getSeverity(), inline_asm, DiagID);
502 std::string Message = D.getMsgStr().str();
503
504 // If this problem has clang-level source location information, report the
Tobias Grosserbd25beb2014-02-26 10:21:56 +0000505 // issue as being a problem in the source with a note showing the instantiated
Quentin Colombet728c5542014-02-06 18:30:43 +0000506 // code.
507 SourceLocation LocCookie =
508 SourceLocation::getFromRawEncoding(D.getLocCookie());
509 if (LocCookie.isValid())
510 Diags.Report(LocCookie, DiagID).AddString(Message);
511 else {
512 // Otherwise, report the backend diagnostic as occurring in the generated
513 // .s file.
514 // If Loc is invalid, we still need to report the diagnostic, it just gets
515 // no location info.
516 FullSourceLoc Loc;
517 Diags.Report(Loc, DiagID).AddString(Message);
518 }
519 // We handled all the possible severities.
520 return true;
521}
522
523bool
524BackendConsumer::StackSizeDiagHandler(const llvm::DiagnosticInfoStackSize &D) {
525 if (D.getSeverity() != llvm::DS_Warning)
526 // For now, the only support we have for StackSize diagnostic is warning.
527 // We do not know how to format other severities.
528 return false;
529
Alp Tokerfb8d02b2014-06-05 22:10:59 +0000530 if (const Decl *ND = Gen->GetDeclForMangledName(D.getFunction().getName())) {
Matt Arsenault4deb4ed22016-06-20 18:13:09 +0000531 // FIXME: Shouldn't need to truncate to uint32_t
Alp Tokerfb8d02b2014-06-05 22:10:59 +0000532 Diags.Report(ND->getASTContext().getFullLoc(ND->getLocation()),
533 diag::warn_fe_frame_larger_than)
Matt Arsenault4deb4ed22016-06-20 18:13:09 +0000534 << static_cast<uint32_t>(D.getStackSize()) << Decl::castToDeclContext(ND);
Alp Tokerfb8d02b2014-06-05 22:10:59 +0000535 return true;
536 }
537
538 return false;
Quentin Colombet728c5542014-02-06 18:30:43 +0000539}
540
Oliver Stannard91817852016-02-02 13:52:52 +0000541const FullSourceLoc BackendConsumer::getBestLocationFromDebugLoc(
Justin Bognere91e9dd2017-02-17 17:34:49 +0000542 const llvm::DiagnosticInfoWithLocationBase &D, bool &BadDebugInfo,
543 StringRef &Filename, unsigned &Line, unsigned &Column) const {
Diego Novillod23ec942014-05-29 19:55:06 +0000544 SourceManager &SourceMgr = Context->getSourceManager();
545 FileManager &FileMgr = SourceMgr.getFileManager();
Alp Toker27506272014-06-05 22:11:12 +0000546 SourceLocation DILoc;
Diego Novillo86f884e2015-05-08 20:59:56 +0000547
548 if (D.isLocationAvailable()) {
549 D.getLocation(&Filename, &Line, &Column);
550 const FileEntry *FE = FileMgr.getFile(Filename);
551 if (FE && Line > 0) {
552 // If -gcolumn-info was not used, Column will be 0. This upsets the
553 // source manager, so pass 1 if Column is not set.
554 DILoc = SourceMgr.translateFileLineCol(FE, Line, Column ? Column : 1);
555 }
Oliver Stannard91817852016-02-02 13:52:52 +0000556 BadDebugInfo = DILoc.isInvalid();
Diego Novillo829b1702014-04-16 16:54:24 +0000557 }
Alp Toker27506272014-06-05 22:11:12 +0000558
559 // If a location isn't available, try to approximate it using the associated
560 // function definition. We use the definition's right brace to differentiate
561 // from diagnostics that genuinely relate to the function itself.
562 FullSourceLoc Loc(DILoc, SourceMgr);
563 if (Loc.isInvalid())
564 if (const Decl *FD = Gen->GetDeclForMangledName(D.getFunction().getName()))
Oliver Stannard91817852016-02-02 13:52:52 +0000565 Loc = FD->getASTContext().getFullLoc(FD->getLocation());
Diego Novillod23ec942014-05-29 19:55:06 +0000566
Diego Novillo86f884e2015-05-08 20:59:56 +0000567 if (DILoc.isInvalid() && D.isLocationAvailable())
Diego Novillod23ec942014-05-29 19:55:06 +0000568 // If we were not able to translate the file:line:col information
569 // back to a SourceLocation, at least emit a note stating that
570 // we could not translate this location. This can happen in the
571 // case of #line directives.
Oliver Stannard91817852016-02-02 13:52:52 +0000572 Diags.Report(Loc, diag::note_fe_backend_invalid_loc)
Ben Craig6e4695a2016-05-06 13:29:46 +0000573 << Filename << Line << Column;
Oliver Stannard91817852016-02-02 13:52:52 +0000574
575 return Loc;
576}
577
578void BackendConsumer::UnsupportedDiagHandler(
579 const llvm::DiagnosticInfoUnsupported &D) {
580 // We only support errors.
581 assert(D.getSeverity() == llvm::DS_Error);
582
583 StringRef Filename;
584 unsigned Line, Column;
Reid Klecknerf70ee602017-05-12 00:10:49 +0000585 bool BadDebugInfo = false;
586 FullSourceLoc Loc =
587 getBestLocationFromDebugLoc(D, BadDebugInfo, Filename, Line, Column);
Oliver Stannard91817852016-02-02 13:52:52 +0000588
589 Diags.Report(Loc, diag::err_fe_backend_unsupported) << D.getMessage().str();
590
591 if (BadDebugInfo)
592 // If we were not able to translate the file:line:col information
593 // back to a SourceLocation, at least emit a note stating that
594 // we could not translate this location. This can happen in the
595 // case of #line directives.
596 Diags.Report(Loc, diag::note_fe_backend_invalid_loc)
597 << Filename << Line << Column;
598}
599
600void BackendConsumer::EmitOptimizationMessage(
601 const llvm::DiagnosticInfoOptimizationBase &D, unsigned DiagID) {
602 // We only support warnings and remarks.
603 assert(D.getSeverity() == llvm::DS_Remark ||
604 D.getSeverity() == llvm::DS_Warning);
605
606 StringRef Filename;
607 unsigned Line, Column;
608 bool BadDebugInfo = false;
Reid Klecknerf70ee602017-05-12 00:10:49 +0000609 FullSourceLoc Loc =
610 getBestLocationFromDebugLoc(D, BadDebugInfo, Filename, Line, Column);
Oliver Stannard91817852016-02-02 13:52:52 +0000611
Adam Nemet1eea3e52016-09-13 04:32:40 +0000612 std::string Msg;
613 raw_string_ostream MsgStream(Msg);
Adam Nemet699fc5b2016-09-27 20:55:12 +0000614 MsgStream << D.getMsg();
Adam Nemet1eea3e52016-09-13 04:32:40 +0000615
616 if (D.getHotness())
617 MsgStream << " (hotness: " << *D.getHotness() << ")";
618
Oliver Stannard91817852016-02-02 13:52:52 +0000619 Diags.Report(Loc, DiagID)
Mehdi Amini117296c2016-10-01 02:56:57 +0000620 << AddFlagValue(D.getPassName())
Adam Nemet1eea3e52016-09-13 04:32:40 +0000621 << MsgStream.str();
Oliver Stannard91817852016-02-02 13:52:52 +0000622
623 if (BadDebugInfo)
624 // If we were not able to translate the file:line:col information
625 // back to a SourceLocation, at least emit a note stating that
626 // we could not translate this location. This can happen in the
627 // case of #line directives.
628 Diags.Report(Loc, diag::note_fe_backend_invalid_loc)
Diego Novillod23ec942014-05-29 19:55:06 +0000629 << Filename << Line << Column;
630}
631
632void BackendConsumer::OptimizationRemarkHandler(
Adam Nemet7b796f82017-01-26 04:07:11 +0000633 const llvm::DiagnosticInfoOptimizationBase &D) {
Adam Nemet28c2c222017-10-04 04:25:31 +0000634 // Without hotness information, don't show noisy remarks.
635 if (D.isVerbose() && !D.getHotness())
636 return;
637
Adam Nemet7b796f82017-01-26 04:07:11 +0000638 if (D.isPassed()) {
639 // Optimization remarks are active only if the -Rpass flag has a regular
640 // expression that matches the name of the pass name in \p D.
641 if (CodeGenOpts.OptimizationRemarkPattern &&
642 CodeGenOpts.OptimizationRemarkPattern->match(D.getPassName()))
643 EmitOptimizationMessage(D, diag::remark_fe_backend_optimization_remark);
644 } else if (D.isMissed()) {
645 // Missed optimization remarks are active only if the -Rpass-missed
646 // flag has a regular expression that matches the name of the pass
647 // name in \p D.
648 if (CodeGenOpts.OptimizationRemarkMissedPattern &&
649 CodeGenOpts.OptimizationRemarkMissedPattern->match(D.getPassName()))
650 EmitOptimizationMessage(
651 D, diag::remark_fe_backend_optimization_remark_missed);
652 } else {
653 assert(D.isAnalysis() && "Unknown remark type");
Diego Novillod23ec942014-05-29 19:55:06 +0000654
Adam Nemet7b796f82017-01-26 04:07:11 +0000655 bool ShouldAlwaysPrint = false;
656 if (auto *ORA = dyn_cast<llvm::OptimizationRemarkAnalysis>(&D))
657 ShouldAlwaysPrint = ORA->shouldAlwaysPrint();
Diego Novillod23ec942014-05-29 19:55:06 +0000658
Adam Nemet7b796f82017-01-26 04:07:11 +0000659 if (ShouldAlwaysPrint ||
660 (CodeGenOpts.OptimizationRemarkAnalysisPattern &&
661 CodeGenOpts.OptimizationRemarkAnalysisPattern->match(D.getPassName())))
662 EmitOptimizationMessage(
663 D, diag::remark_fe_backend_optimization_remark_analysis);
664 }
Diego Novillo829b1702014-04-16 16:54:24 +0000665}
666
Tyler Nowicki8a0925c2015-08-10 19:56:40 +0000667void BackendConsumer::OptimizationRemarkHandler(
Adam Nemetb4e64a72016-09-27 22:19:29 +0000668 const llvm::OptimizationRemarkAnalysisFPCommute &D) {
Tyler Nowicki65061a22015-08-11 01:10:08 +0000669 // Optimization analysis remarks are active if the pass name is set to
670 // llvm::DiagnosticInfo::AlwasyPrint or if the -Rpass-analysis flag has a
671 // regular expression that matches the name of the pass name in \p D.
672
Adam Nemetb5beb972016-06-29 04:55:31 +0000673 if (D.shouldAlwaysPrint() ||
Tyler Nowicki65061a22015-08-11 01:10:08 +0000674 (CodeGenOpts.OptimizationRemarkAnalysisPattern &&
675 CodeGenOpts.OptimizationRemarkAnalysisPattern->match(D.getPassName())))
Tyler Nowicki8a0925c2015-08-10 19:56:40 +0000676 EmitOptimizationMessage(
677 D, diag::remark_fe_backend_optimization_remark_analysis_fpcommute);
678}
679
Tyler Nowicki034baf62015-08-10 23:05:16 +0000680void BackendConsumer::OptimizationRemarkHandler(
Adam Nemetb4e64a72016-09-27 22:19:29 +0000681 const llvm::OptimizationRemarkAnalysisAliasing &D) {
Tyler Nowicki65061a22015-08-11 01:10:08 +0000682 // Optimization analysis remarks are active if the pass name is set to
683 // llvm::DiagnosticInfo::AlwasyPrint or if the -Rpass-analysis flag has a
684 // regular expression that matches the name of the pass name in \p D.
685
Adam Nemetb5beb972016-06-29 04:55:31 +0000686 if (D.shouldAlwaysPrint() ||
Tyler Nowicki65061a22015-08-11 01:10:08 +0000687 (CodeGenOpts.OptimizationRemarkAnalysisPattern &&
688 CodeGenOpts.OptimizationRemarkAnalysisPattern->match(D.getPassName())))
Tyler Nowicki034baf62015-08-10 23:05:16 +0000689 EmitOptimizationMessage(
690 D, diag::remark_fe_backend_optimization_remark_analysis_aliasing);
691}
692
Tyler Nowickif8a767d2014-07-18 19:40:19 +0000693void BackendConsumer::OptimizationFailureHandler(
694 const llvm::DiagnosticInfoOptimizationFailure &D) {
695 EmitOptimizationMessage(D, diag::warn_fe_backend_optimization_failure);
696}
697
Quentin Colombet728c5542014-02-06 18:30:43 +0000698/// \brief This function is invoked when the backend needs
699/// to report something to the user.
700void BackendConsumer::DiagnosticHandlerImpl(const DiagnosticInfo &DI) {
701 unsigned DiagID = diag::err_fe_inline_asm;
702 llvm::DiagnosticSeverity Severity = DI.getSeverity();
703 // Get the diagnostic ID based.
704 switch (DI.getKind()) {
705 case llvm::DK_InlineAsm:
706 if (InlineAsmDiagHandler(cast<DiagnosticInfoInlineAsm>(DI)))
707 return;
708 ComputeDiagID(Severity, inline_asm, DiagID);
709 break;
710 case llvm::DK_StackSize:
711 if (StackSizeDiagHandler(cast<DiagnosticInfoStackSize>(DI)))
712 return;
713 ComputeDiagID(Severity, backend_frame_larger_than, DiagID);
714 break;
Rafael Espindola8ce88a52015-12-14 23:17:07 +0000715 case DK_Linker:
716 assert(CurLinkModule);
717 // FIXME: stop eating the warnings and notes.
718 if (Severity != DS_Error)
719 return;
720 DiagID = diag::err_fe_cannot_link_module;
721 break;
Diego Novillo829b1702014-04-16 16:54:24 +0000722 case llvm::DK_OptimizationRemark:
723 // Optimization remarks are always handled completely by this
724 // handler. There is no generic way of emitting them.
Adam Nemetb4e64a72016-09-27 22:19:29 +0000725 OptimizationRemarkHandler(cast<OptimizationRemark>(DI));
Diego Novillo829b1702014-04-16 16:54:24 +0000726 return;
Diego Novillo9c89ff12014-05-29 16:19:27 +0000727 case llvm::DK_OptimizationRemarkMissed:
Diego Novillod23ec942014-05-29 19:55:06 +0000728 // Optimization remarks are always handled completely by this
729 // handler. There is no generic way of emitting them.
Adam Nemetb4e64a72016-09-27 22:19:29 +0000730 OptimizationRemarkHandler(cast<OptimizationRemarkMissed>(DI));
Diego Novillod23ec942014-05-29 19:55:06 +0000731 return;
Diego Novillo9c89ff12014-05-29 16:19:27 +0000732 case llvm::DK_OptimizationRemarkAnalysis:
Diego Novillod23ec942014-05-29 19:55:06 +0000733 // Optimization remarks are always handled completely by this
734 // handler. There is no generic way of emitting them.
Adam Nemetb4e64a72016-09-27 22:19:29 +0000735 OptimizationRemarkHandler(cast<OptimizationRemarkAnalysis>(DI));
Diego Novillo9c89ff12014-05-29 16:19:27 +0000736 return;
Tyler Nowicki8a0925c2015-08-10 19:56:40 +0000737 case llvm::DK_OptimizationRemarkAnalysisFPCommute:
738 // Optimization remarks are always handled completely by this
739 // handler. There is no generic way of emitting them.
Adam Nemetb4e64a72016-09-27 22:19:29 +0000740 OptimizationRemarkHandler(cast<OptimizationRemarkAnalysisFPCommute>(DI));
Tyler Nowicki8a0925c2015-08-10 19:56:40 +0000741 return;
Tyler Nowicki034baf62015-08-10 23:05:16 +0000742 case llvm::DK_OptimizationRemarkAnalysisAliasing:
743 // Optimization remarks are always handled completely by this
744 // handler. There is no generic way of emitting them.
Adam Nemetb4e64a72016-09-27 22:19:29 +0000745 OptimizationRemarkHandler(cast<OptimizationRemarkAnalysisAliasing>(DI));
Tyler Nowicki034baf62015-08-10 23:05:16 +0000746 return;
Adam Nemet7b796f82017-01-26 04:07:11 +0000747 case llvm::DK_MachineOptimizationRemark:
748 // Optimization remarks are always handled completely by this
749 // handler. There is no generic way of emitting them.
750 OptimizationRemarkHandler(cast<MachineOptimizationRemark>(DI));
751 return;
752 case llvm::DK_MachineOptimizationRemarkMissed:
753 // Optimization remarks are always handled completely by this
754 // handler. There is no generic way of emitting them.
755 OptimizationRemarkHandler(cast<MachineOptimizationRemarkMissed>(DI));
756 return;
757 case llvm::DK_MachineOptimizationRemarkAnalysis:
758 // Optimization remarks are always handled completely by this
759 // handler. There is no generic way of emitting them.
760 OptimizationRemarkHandler(cast<MachineOptimizationRemarkAnalysis>(DI));
761 return;
Tyler Nowickif8a767d2014-07-18 19:40:19 +0000762 case llvm::DK_OptimizationFailure:
763 // Optimization failures are always handled completely by this
764 // handler.
765 OptimizationFailureHandler(cast<DiagnosticInfoOptimizationFailure>(DI));
766 return;
Oliver Stannard91817852016-02-02 13:52:52 +0000767 case llvm::DK_Unsupported:
768 UnsupportedDiagHandler(cast<DiagnosticInfoUnsupported>(DI));
769 return;
Quentin Colombet728c5542014-02-06 18:30:43 +0000770 default:
771 // Plugin IDs are not bound to any value as they are set dynamically.
Tobias Grosser74160242014-02-28 09:11:08 +0000772 ComputeDiagRemarkID(Severity, backend_plugin, DiagID);
Quentin Colombet728c5542014-02-06 18:30:43 +0000773 break;
774 }
775 std::string MsgStorage;
776 {
777 raw_string_ostream Stream(MsgStorage);
778 DiagnosticPrinterRawOStream DP(Stream);
779 DI.print(DP);
780 }
781
Rafael Espindola8ce88a52015-12-14 23:17:07 +0000782 if (DiagID == diag::err_fe_cannot_link_module) {
783 Diags.Report(diag::err_fe_cannot_link_module)
784 << CurLinkModule->getModuleIdentifier() << MsgStorage;
785 return;
786 }
787
Quentin Colombet728c5542014-02-06 18:30:43 +0000788 // Report the backend message using the usual diagnostic mechanism.
789 FullSourceLoc Loc;
790 Diags.Report(Loc, DiagID).AddString(MsgStorage);
791}
792#undef ComputeDiagID
Daniel Dunbarcea0c702010-02-25 04:37:45 +0000793
Peter Collingbourne8f5cf742011-02-19 23:03:58 +0000794CodeGenAction::CodeGenAction(unsigned _Act, LLVMContext *_VMContext)
Artem Belevich5d40ae32015-10-27 17:56:59 +0000795 : Act(_Act), VMContext(_VMContext ? _VMContext : new LLVMContext),
Eric Christopher02e3dd42016-03-12 01:47:11 +0000796 OwnsVMContext(!_VMContext) {}
Daniel Dunbarcea0c702010-02-25 04:37:45 +0000797
Peter Collingbourne8f5cf742011-02-19 23:03:58 +0000798CodeGenAction::~CodeGenAction() {
799 TheModule.reset();
800 if (OwnsVMContext)
801 delete VMContext;
802}
Daniel Dunbare8ecf9a2010-02-25 20:37:44 +0000803
Daniel Dunbar6f8362c2010-06-07 23:27:59 +0000804bool CodeGenAction::hasIRSupport() const { return true; }
805
Daniel Dunbar400a6932010-02-25 04:37:50 +0000806void CodeGenAction::EndSourceFileAction() {
807 // If the consumer creation failed, do nothing.
808 if (!getCompilerInstance().hasASTConsumer())
809 return;
810
811 // Steal the module from the consumer.
David Blaikie780dd3b2014-08-29 05:08:19 +0000812 TheModule = BEConsumer->takeModule();
Daniel Dunbar400a6932010-02-25 04:37:50 +0000813}
814
Rafael Espindolae8337302014-08-19 14:36:35 +0000815std::unique_ptr<llvm::Module> CodeGenAction::takeModule() {
816 return std::move(TheModule);
817}
818
Peter Collingbourne8f5cf742011-02-19 23:03:58 +0000819llvm::LLVMContext *CodeGenAction::takeLLVMContext() {
820 OwnsVMContext = false;
821 return VMContext;
822}
823
Peter Collingbourne03f89072016-07-15 00:55:40 +0000824static std::unique_ptr<raw_pwrite_stream>
Rafael Espindola2f16bc12015-04-14 15:15:49 +0000825GetOutputStream(CompilerInstance &CI, StringRef InFile, BackendAction Action) {
Daniel Dunbar6f8362c2010-06-07 23:27:59 +0000826 switch (Action) {
827 case Backend_EmitAssembly:
828 return CI.createDefaultOutputFile(false, InFile, "s");
829 case Backend_EmitLL:
830 return CI.createDefaultOutputFile(false, InFile, "ll");
831 case Backend_EmitBC:
832 return CI.createDefaultOutputFile(true, InFile, "bc");
833 case Backend_EmitNothing:
Craig Topper8a13c412014-05-21 05:09:00 +0000834 return nullptr;
Daniel Dunbar6f8362c2010-06-07 23:27:59 +0000835 case Backend_EmitMCNull:
Alp Tokerea046722014-06-03 17:23:34 +0000836 return CI.createNullOutputFile();
Daniel Dunbar6f8362c2010-06-07 23:27:59 +0000837 case Backend_EmitObj:
838 return CI.createDefaultOutputFile(true, InFile, "o");
839 }
840
David Blaikie83d382b2011-09-23 05:06:16 +0000841 llvm_unreachable("Invalid action!");
Daniel Dunbar6f8362c2010-06-07 23:27:59 +0000842}
843
David Blaikie6beb6aa2014-08-10 19:56:51 +0000844std::unique_ptr<ASTConsumer>
845CodeGenAction::CreateASTConsumer(CompilerInstance &CI, StringRef InFile) {
Daniel Dunbarcea0c702010-02-25 04:37:45 +0000846 BackendAction BA = static_cast<BackendAction>(Act);
Peter Collingbourne03f89072016-07-15 00:55:40 +0000847 std::unique_ptr<raw_pwrite_stream> OS = GetOutputStream(CI, InFile, BA);
Daniel Dunbarcea0c702010-02-25 04:37:45 +0000848 if (BA != Backend_EmitNothing && !OS)
Craig Topper8a13c412014-05-21 05:09:00 +0000849 return nullptr;
Daniel Dunbarcea0c702010-02-25 04:37:45 +0000850
Artem Belevich5d40ae32015-10-27 17:56:59 +0000851 // Load bitcode modules to link with, if we need to.
852 if (LinkModules.empty())
Justin Lebarb080b632017-01-25 21:29:48 +0000853 for (const CodeGenOptions::BitcodeFileToLink &F :
854 CI.getCodeGenOpts().LinkBitcodeFiles) {
855 auto BCBuf = CI.getFileManager().getBufferForFile(F.Filename);
Artem Belevich5d40ae32015-10-27 17:56:59 +0000856 if (!BCBuf) {
857 CI.getDiagnostics().Report(diag::err_cannot_open_file)
Justin Lebarb080b632017-01-25 21:29:48 +0000858 << F.Filename << BCBuf.getError().message();
Artem Belevich5d40ae32015-10-27 17:56:59 +0000859 LinkModules.clear();
860 return nullptr;
861 }
Peter Collingbournef1d76db2011-10-30 17:30:44 +0000862
Peter Collingbourned9445c42016-11-13 07:00:17 +0000863 Expected<std::unique_ptr<llvm::Module>> ModuleOrErr =
Peter Collingbournee2dcf7c2016-11-08 06:03:43 +0000864 getOwningLazyBitcodeModule(std::move(*BCBuf), *VMContext);
Peter Collingbourned9445c42016-11-13 07:00:17 +0000865 if (!ModuleOrErr) {
866 handleAllErrors(ModuleOrErr.takeError(), [&](ErrorInfoBase &EIB) {
867 CI.getDiagnostics().Report(diag::err_cannot_open_file)
Justin Lebarb080b632017-01-25 21:29:48 +0000868 << F.Filename << EIB.message();
Peter Collingbourned9445c42016-11-13 07:00:17 +0000869 });
Artem Belevich5d40ae32015-10-27 17:56:59 +0000870 LinkModules.clear();
871 return nullptr;
872 }
Jonas Devlieghere5eb9c812017-03-13 18:08:11 +0000873 LinkModules.push_back({std::move(ModuleOrErr.get()), F.PropagateAttrs,
874 F.Internalize, F.LinkFlags});
Peter Collingbournef1d76db2011-10-30 17:30:44 +0000875 }
Peter Collingbournef1d76db2011-10-30 17:30:44 +0000876
Alex Lorenzee024992014-08-04 18:41:51 +0000877 CoverageSourceInfo *CoverageInfo = nullptr;
878 // Add the preprocessor callback only when the coverage mapping is generated.
879 if (CI.getCodeGenOpts().CoverageMapping) {
880 CoverageInfo = new CoverageSourceInfo;
Craig Topperb8a70532014-09-10 04:53:53 +0000881 CI.getPreprocessor().addPPCallbacks(
882 std::unique_ptr<PPCallbacks>(CoverageInfo));
Alex Lorenzee024992014-08-04 18:41:51 +0000883 }
Artem Belevich5d40ae32015-10-27 17:56:59 +0000884
David Blaikie037e75b2014-08-10 21:06:17 +0000885 std::unique_ptr<BackendConsumer> Result(new BackendConsumer(
Adrian Prantle74f5252015-06-30 02:26:03 +0000886 BA, CI.getDiagnostics(), CI.getHeaderSearchOpts(),
887 CI.getPreprocessorOpts(), CI.getCodeGenOpts(), CI.getTargetOpts(),
Justin Lebarb080b632017-01-25 21:29:48 +0000888 CI.getLangOpts(), CI.getFrontendOpts().ShowTimers, InFile,
889 std::move(LinkModules), std::move(OS), *VMContext, CoverageInfo));
David Blaikie6beb6aa2014-08-10 19:56:51 +0000890 BEConsumer = Result.get();
Amjad Aboud546bc112017-02-09 22:07:24 +0000891
892 // Enable generating macro debug info only when debug info is not disabled and
893 // also macro debug info is enabled.
894 if (CI.getCodeGenOpts().getDebugInfo() != codegenoptions::NoDebugInfo &&
895 CI.getCodeGenOpts().MacroDebugInfo) {
896 std::unique_ptr<PPCallbacks> Callbacks =
897 llvm::make_unique<MacroPPCallbacks>(BEConsumer->getCodeGenerator(),
898 CI.getPreprocessor());
899 CI.getPreprocessor().addPPCallbacks(std::move(Callbacks));
900 }
901
David Blaikie6beb6aa2014-08-10 19:56:51 +0000902 return std::move(Result);
Daniel Dunbarc13935e2008-10-21 23:49:24 +0000903}
Daniel Dunbarcea0c702010-02-25 04:37:45 +0000904
Tim Northover1390b442016-04-06 19:58:07 +0000905static void BitcodeInlineAsmDiagHandler(const llvm::SMDiagnostic &SM,
906 void *Context,
907 unsigned LocCookie) {
908 SM.print(nullptr, llvm::errs());
909
910 auto Diags = static_cast<DiagnosticsEngine *>(Context);
911 unsigned DiagID;
912 switch (SM.getKind()) {
913 case llvm::SourceMgr::DK_Error:
914 DiagID = diag::err_fe_inline_asm;
915 break;
916 case llvm::SourceMgr::DK_Warning:
917 DiagID = diag::warn_fe_inline_asm;
918 break;
919 case llvm::SourceMgr::DK_Note:
920 DiagID = diag::note_fe_inline_asm;
921 break;
922 }
923
924 Diags->Report(DiagID).AddString("cannot compile inline asm");
925}
926
Peter Collingbourne65cb42c2017-01-24 19:55:38 +0000927std::unique_ptr<llvm::Module> CodeGenAction::loadModule(MemoryBufferRef MBRef) {
928 CompilerInstance &CI = getCompilerInstance();
929 SourceManager &SM = CI.getSourceManager();
930
931 // For ThinLTO backend invocations, ensure that the context
Peter Collingbournef5d17122017-01-26 21:09:48 +0000932 // merges types based on ODR identifiers. We also need to read
933 // the correct module out of a multi-module bitcode file.
934 if (!CI.getCodeGenOpts().ThinLTOIndexFile.empty()) {
Peter Collingbourne65cb42c2017-01-24 19:55:38 +0000935 VMContext->enableDebugTypeODRUniquing();
936
Peter Collingbournef5d17122017-01-26 21:09:48 +0000937 auto DiagErrors = [&](Error E) -> std::unique_ptr<llvm::Module> {
938 unsigned DiagID =
939 CI.getDiagnostics().getCustomDiagID(DiagnosticsEngine::Error, "%0");
940 handleAllErrors(std::move(E), [&](ErrorInfoBase &EIB) {
941 CI.getDiagnostics().Report(DiagID) << EIB.message();
942 });
943 return {};
944 };
945
946 Expected<llvm::BitcodeModule> BMOrErr = FindThinLTOModule(MBRef);
947 if (!BMOrErr)
948 return DiagErrors(BMOrErr.takeError());
949
950 Expected<std::unique_ptr<llvm::Module>> MOrErr =
951 BMOrErr->parseModule(*VMContext);
952 if (!MOrErr)
953 return DiagErrors(MOrErr.takeError());
954 return std::move(*MOrErr);
955 }
956
Peter Collingbourne65cb42c2017-01-24 19:55:38 +0000957 llvm::SMDiagnostic Err;
958 if (std::unique_ptr<llvm::Module> M = parseIR(MBRef, Err, *VMContext))
959 return M;
960
961 // Translate from the diagnostic info to the SourceManager location if
962 // available.
963 // TODO: Unify this with ConvertBackendLocation()
964 SourceLocation Loc;
965 if (Err.getLineNo() > 0) {
966 assert(Err.getColumnNo() >= 0);
967 Loc = SM.translateFileLineCol(SM.getFileEntryForID(SM.getMainFileID()),
968 Err.getLineNo(), Err.getColumnNo() + 1);
969 }
970
971 // Strip off a leading diagnostic code if there is one.
972 StringRef Msg = Err.getMessage();
973 if (Msg.startswith("error: "))
974 Msg = Msg.substr(7);
975
976 unsigned DiagID =
977 CI.getDiagnostics().getCustomDiagID(DiagnosticsEngine::Error, "%0");
978
979 CI.getDiagnostics().Report(Loc, DiagID) << Msg;
980 return {};
981}
982
Daniel Dunbar6f8362c2010-06-07 23:27:59 +0000983void CodeGenAction::ExecuteAction() {
984 // If this is an IR file, we have to treat it specially.
Richard Smith40c0efa2017-04-26 18:57:40 +0000985 if (getCurrentFileKind().getLanguage() == InputKind::LLVM_IR) {
Daniel Dunbar6f8362c2010-06-07 23:27:59 +0000986 BackendAction BA = static_cast<BackendAction>(Act);
987 CompilerInstance &CI = getCompilerInstance();
Peter Collingbourne03f89072016-07-15 00:55:40 +0000988 std::unique_ptr<raw_pwrite_stream> OS =
989 GetOutputStream(CI, getCurrentFile(), BA);
Daniel Dunbar6f8362c2010-06-07 23:27:59 +0000990 if (BA != Backend_EmitNothing && !OS)
991 return;
992
993 bool Invalid;
994 SourceManager &SM = CI.getSourceManager();
Alp Toker7b463d52014-06-30 01:33:59 +0000995 FileID FID = SM.getMainFileID();
996 llvm::MemoryBuffer *MainFile = SM.getBuffer(FID, &Invalid);
Daniel Dunbar6f8362c2010-06-07 23:27:59 +0000997 if (Invalid)
998 return;
999
Peter Collingbourne65cb42c2017-01-24 19:55:38 +00001000 TheModule = loadModule(*MainFile);
1001 if (!TheModule)
Daniel Dunbar6f8362c2010-06-07 23:27:59 +00001002 return;
Peter Collingbourne65cb42c2017-01-24 19:55:38 +00001003
Rafael Espindolad5e81e52013-12-20 22:01:25 +00001004 const TargetOptions &TargetOpts = CI.getTargetOpts();
1005 if (TheModule->getTargetTriple() != TargetOpts.Triple) {
Nico Weber6cf2df22015-01-29 06:25:59 +00001006 CI.getDiagnostics().Report(SourceLocation(),
1007 diag::warn_fe_override_module)
1008 << TargetOpts.Triple;
Rafael Espindolad5e81e52013-12-20 22:01:25 +00001009 TheModule->setTargetTriple(TargetOpts.Triple);
1010 }
Daniel Dunbar6f8362c2010-06-07 23:27:59 +00001011
Steven Wu27fb5222016-05-11 16:26:03 +00001012 EmbedBitcode(TheModule.get(), CI.getCodeGenOpts(),
1013 MainFile->getMemBufferRef());
1014
Tim Northover1390b442016-04-06 19:58:07 +00001015 LLVMContext &Ctx = TheModule->getContext();
1016 Ctx.setInlineAsmDiagnosticHandler(BitcodeInlineAsmDiagHandler,
1017 &CI.getDiagnostics());
Steven Wu27fb5222016-05-11 16:26:03 +00001018
Saleem Abdulrasool888e2892017-01-05 16:02:32 +00001019 EmitBackendOutput(CI.getDiagnostics(), CI.getHeaderSearchOpts(),
1020 CI.getCodeGenOpts(), TargetOpts, CI.getLangOpts(),
1021 CI.getTarget().getDataLayout(), TheModule.get(), BA,
1022 std::move(OS));
Daniel Dunbar6f8362c2010-06-07 23:27:59 +00001023 return;
1024 }
1025
1026 // Otherwise follow the normal AST path.
1027 this->ASTFrontendAction::ExecuteAction();
1028}
1029
1030//
1031
David Blaikie68e081d2011-12-20 02:48:34 +00001032void EmitAssemblyAction::anchor() { }
Peter Collingbourne8f5cf742011-02-19 23:03:58 +00001033EmitAssemblyAction::EmitAssemblyAction(llvm::LLVMContext *_VMContext)
1034 : CodeGenAction(Backend_EmitAssembly, _VMContext) {}
Daniel Dunbarcea0c702010-02-25 04:37:45 +00001035
David Blaikie68e081d2011-12-20 02:48:34 +00001036void EmitBCAction::anchor() { }
Peter Collingbourne8f5cf742011-02-19 23:03:58 +00001037EmitBCAction::EmitBCAction(llvm::LLVMContext *_VMContext)
1038 : CodeGenAction(Backend_EmitBC, _VMContext) {}
Daniel Dunbarcea0c702010-02-25 04:37:45 +00001039
David Blaikie68e081d2011-12-20 02:48:34 +00001040void EmitLLVMAction::anchor() { }
Peter Collingbourne8f5cf742011-02-19 23:03:58 +00001041EmitLLVMAction::EmitLLVMAction(llvm::LLVMContext *_VMContext)
1042 : CodeGenAction(Backend_EmitLL, _VMContext) {}
Daniel Dunbarcea0c702010-02-25 04:37:45 +00001043
David Blaikie68e081d2011-12-20 02:48:34 +00001044void EmitLLVMOnlyAction::anchor() { }
Peter Collingbourne8f5cf742011-02-19 23:03:58 +00001045EmitLLVMOnlyAction::EmitLLVMOnlyAction(llvm::LLVMContext *_VMContext)
1046 : CodeGenAction(Backend_EmitNothing, _VMContext) {}
Daniel Dunbarcea0c702010-02-25 04:37:45 +00001047
David Blaikie68e081d2011-12-20 02:48:34 +00001048void EmitCodeGenOnlyAction::anchor() { }
Peter Collingbourne8f5cf742011-02-19 23:03:58 +00001049EmitCodeGenOnlyAction::EmitCodeGenOnlyAction(llvm::LLVMContext *_VMContext)
1050 : CodeGenAction(Backend_EmitMCNull, _VMContext) {}
Daniel Dunbar4c77a642010-05-25 18:41:01 +00001051
David Blaikie68e081d2011-12-20 02:48:34 +00001052void EmitObjAction::anchor() { }
Peter Collingbourne8f5cf742011-02-19 23:03:58 +00001053EmitObjAction::EmitObjAction(llvm::LLVMContext *_VMContext)
1054 : CodeGenAction(Backend_EmitObj, _VMContext) {}