1 //===--- ModuleBuilder.cpp - Emit LLVM Code from ASTs ---------------------===//
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 builds an AST and converts it to LLVM Code.
11 //
12 //===----------------------------------------------------------------------===//
13
14 #include "clang/CodeGen/ModuleBuilder.h"
15 #include "CGDebugInfo.h"
16 #include "CodeGenModule.h"
17 #include "clang/AST/ASTContext.h"
18 #include "clang/AST/DeclObjC.h"
19 #include "clang/AST/Expr.h"
20 #include "clang/Basic/Diagnostic.h"
21 #include "clang/Basic/TargetInfo.h"
22 #include "clang/Frontend/CodeGenOptions.h"
23 #include "llvm/ADT/StringRef.h"
24 #include "llvm/IR/DataLayout.h"
25 #include "llvm/IR/LLVMContext.h"
26 #include "llvm/IR/Module.h"
27 #include <memory>
28
29 using namespace clang;
30 using namespace CodeGen;
31
32 namespace {
33 class CodeGeneratorImpl : public CodeGenerator {
34 DiagnosticsEngine &Diags;
35 ASTContext *Ctx;
36 const HeaderSearchOptions &HeaderSearchOpts; // Only used for debug info.
37 const PreprocessorOptions &PreprocessorOpts; // Only used for debug info.
38 const CodeGenOptions CodeGenOpts; // Intentionally copied in.
39
40 unsigned HandlingTopLevelDecls;
41
42 /// Use this when emitting decls to block re-entrant decl emission. It will
43 /// emit all deferred decls on scope exit. Set EmitDeferred to false if decl
44 /// emission must be deferred longer, like at the end of a tag definition.
45 struct HandlingTopLevelDeclRAII {
46 CodeGeneratorImpl &Self;
47 bool EmitDeferred;
HandlingTopLevelDeclRAII__anon075db5b60111::CodeGeneratorImpl::HandlingTopLevelDeclRAII48 HandlingTopLevelDeclRAII(CodeGeneratorImpl &Self,
49 bool EmitDeferred = true)
50 : Self(Self), EmitDeferred(EmitDeferred) {
51 ++Self.HandlingTopLevelDecls;
52 }
~HandlingTopLevelDeclRAII__anon075db5b60111::CodeGeneratorImpl::HandlingTopLevelDeclRAII53 ~HandlingTopLevelDeclRAII() {
54 unsigned Level = --Self.HandlingTopLevelDecls;
55 if (Level == 0 && EmitDeferred)
56 Self.EmitDeferredDecls();
57 }
58 };
59
60 CoverageSourceInfo *CoverageInfo;
61
62 protected:
63 std::unique_ptr<llvm::Module> M;
64 std::unique_ptr<CodeGen::CodeGenModule> Builder;
65
66 private:
67 SmallVector<CXXMethodDecl *, 8> DeferredInlineMethodDefinitions;
68
69 public:
CodeGeneratorImpl(DiagnosticsEngine & diags,llvm::StringRef ModuleName,const HeaderSearchOptions & HSO,const PreprocessorOptions & PPO,const CodeGenOptions & CGO,llvm::LLVMContext & C,CoverageSourceInfo * CoverageInfo=nullptr)70 CodeGeneratorImpl(DiagnosticsEngine &diags, llvm::StringRef ModuleName,
71 const HeaderSearchOptions &HSO,
72 const PreprocessorOptions &PPO, const CodeGenOptions &CGO,
73 llvm::LLVMContext &C,
74 CoverageSourceInfo *CoverageInfo = nullptr)
75 : Diags(diags), Ctx(nullptr), HeaderSearchOpts(HSO),
76 PreprocessorOpts(PPO), CodeGenOpts(CGO), HandlingTopLevelDecls(0),
77 CoverageInfo(CoverageInfo), M(new llvm::Module(ModuleName, C)) {
78 C.setDiscardValueNames(CGO.DiscardValueNames);
79 }
80
~CodeGeneratorImpl()81 ~CodeGeneratorImpl() override {
82 // There should normally not be any leftover inline method definitions.
83 assert(DeferredInlineMethodDefinitions.empty() ||
84 Diags.hasErrorOccurred());
85 }
86
CGM()87 CodeGenModule &CGM() {
88 return *Builder;
89 }
90
GetModule()91 llvm::Module *GetModule() {
92 return M.get();
93 }
94
ReleaseModule()95 llvm::Module *ReleaseModule() {
96 return M.release();
97 }
98
GetDeclForMangledName(StringRef MangledName)99 const Decl *GetDeclForMangledName(StringRef MangledName) {
100 GlobalDecl Result;
101 if (!Builder->lookupRepresentativeDecl(MangledName, Result))
102 return nullptr;
103 const Decl *D = Result.getCanonicalDecl().getDecl();
104 if (auto FD = dyn_cast<FunctionDecl>(D)) {
105 if (FD->hasBody(FD))
106 return FD;
107 } else if (auto TD = dyn_cast<TagDecl>(D)) {
108 if (auto Def = TD->getDefinition())
109 return Def;
110 }
111 return D;
112 }
113
GetAddrOfGlobal(GlobalDecl global,bool isForDefinition)114 llvm::Constant *GetAddrOfGlobal(GlobalDecl global, bool isForDefinition) {
115 return Builder->GetAddrOfGlobal(global, isForDefinition);
116 }
117
Initialize(ASTContext & Context)118 void Initialize(ASTContext &Context) override {
119 Ctx = &Context;
120
121 M->setTargetTriple(Ctx->getTargetInfo().getTriple().getTriple());
122 M->setDataLayout(Ctx->getTargetInfo().getDataLayout());
123 Builder.reset(new CodeGen::CodeGenModule(Context, HeaderSearchOpts,
124 PreprocessorOpts, CodeGenOpts,
125 *M, Diags, CoverageInfo));
126
127 for (auto &&Lib : CodeGenOpts.DependentLibraries)
128 Builder->AddDependentLib(Lib);
129 for (auto &&Opt : CodeGenOpts.LinkerOptions)
130 Builder->AppendLinkerOptions(Opt);
131 }
132
HandleCXXStaticMemberVarInstantiation(VarDecl * VD)133 void HandleCXXStaticMemberVarInstantiation(VarDecl *VD) override {
134 if (Diags.hasErrorOccurred())
135 return;
136
137 Builder->HandleCXXStaticMemberVarInstantiation(VD);
138 }
139
HandleTopLevelDecl(DeclGroupRef DG)140 bool HandleTopLevelDecl(DeclGroupRef DG) override {
141 if (Diags.hasErrorOccurred())
142 return true;
143
144 HandlingTopLevelDeclRAII HandlingDecl(*this);
145
146 // Make sure to emit all elements of a Decl.
147 for (DeclGroupRef::iterator I = DG.begin(), E = DG.end(); I != E; ++I)
148 Builder->EmitTopLevelDecl(*I);
149
150 return true;
151 }
152
EmitDeferredDecls()153 void EmitDeferredDecls() {
154 if (DeferredInlineMethodDefinitions.empty())
155 return;
156
157 // Emit any deferred inline method definitions. Note that more deferred
158 // methods may be added during this loop, since ASTConsumer callbacks
159 // can be invoked if AST inspection results in declarations being added.
160 HandlingTopLevelDeclRAII HandlingDecl(*this);
161 for (unsigned I = 0; I != DeferredInlineMethodDefinitions.size(); ++I)
162 Builder->EmitTopLevelDecl(DeferredInlineMethodDefinitions[I]);
163 DeferredInlineMethodDefinitions.clear();
164 }
165
HandleInlineFunctionDefinition(FunctionDecl * D)166 void HandleInlineFunctionDefinition(FunctionDecl *D) override {
167 if (Diags.hasErrorOccurred())
168 return;
169
170 assert(D->doesThisDeclarationHaveABody());
171
172 // Handle friend functions.
173 if (D->isInIdentifierNamespace(Decl::IDNS_OrdinaryFriend)) {
174 if (Ctx->getTargetInfo().getCXXABI().isMicrosoft()
175 && !D->getLexicalDeclContext()->isDependentContext())
176 Builder->EmitTopLevelDecl(D);
177 return;
178 }
179
180 // Otherwise, must be a method.
181 auto MD = cast<CXXMethodDecl>(D);
182
183 // We may want to emit this definition. However, that decision might be
184 // based on computing the linkage, and we have to defer that in case we
185 // are inside of something that will change the method's final linkage,
186 // e.g.
187 // typedef struct {
188 // void bar();
189 // void foo() { bar(); }
190 // } A;
191 DeferredInlineMethodDefinitions.push_back(MD);
192
193 // Provide some coverage mapping even for methods that aren't emitted.
194 // Don't do this for templated classes though, as they may not be
195 // instantiable.
196 if (!MD->getParent()->getDescribedClassTemplate())
197 Builder->AddDeferredUnusedCoverageMapping(MD);
198 }
199
200 /// HandleTagDeclDefinition - This callback is invoked each time a TagDecl
201 /// to (e.g. struct, union, enum, class) is completed. This allows the
202 /// client hack on the type, which can occur at any point in the file
203 /// (because these can be defined in declspecs).
HandleTagDeclDefinition(TagDecl * D)204 void HandleTagDeclDefinition(TagDecl *D) override {
205 if (Diags.hasErrorOccurred())
206 return;
207
208 // Don't allow re-entrant calls to CodeGen triggered by PCH
209 // deserialization to emit deferred decls.
210 HandlingTopLevelDeclRAII HandlingDecl(*this, /*EmitDeferred=*/false);
211
212 Builder->UpdateCompletedType(D);
213
214 // For MSVC compatibility, treat declarations of static data members with
215 // inline initializers as definitions.
216 if (Ctx->getTargetInfo().getCXXABI().isMicrosoft()) {
217 for (Decl *Member : D->decls()) {
218 if (VarDecl *VD = dyn_cast<VarDecl>(Member)) {
219 if (Ctx->isMSStaticDataMemberInlineDefinition(VD) &&
220 Ctx->DeclMustBeEmitted(VD)) {
221 Builder->EmitGlobal(VD);
222 }
223 }
224 }
225 }
226 // For OpenMP emit declare reduction functions, if required.
227 if (Ctx->getLangOpts().OpenMP) {
228 for (Decl *Member : D->decls()) {
229 if (auto *DRD = dyn_cast<OMPDeclareReductionDecl>(Member)) {
230 if (Ctx->DeclMustBeEmitted(DRD))
231 Builder->EmitGlobal(DRD);
232 }
233 }
234 }
235 }
236
HandleTagDeclRequiredDefinition(const TagDecl * D)237 void HandleTagDeclRequiredDefinition(const TagDecl *D) override {
238 if (Diags.hasErrorOccurred())
239 return;
240
241 // Don't allow re-entrant calls to CodeGen triggered by PCH
242 // deserialization to emit deferred decls.
243 HandlingTopLevelDeclRAII HandlingDecl(*this, /*EmitDeferred=*/false);
244
245 if (CodeGen::CGDebugInfo *DI = Builder->getModuleDebugInfo())
246 if (const RecordDecl *RD = dyn_cast<RecordDecl>(D))
247 DI->completeRequiredType(RD);
248 }
249
HandleTranslationUnit(ASTContext & Ctx)250 void HandleTranslationUnit(ASTContext &Ctx) override {
251 // Release the Builder when there is no error.
252 if (!Diags.hasErrorOccurred() && Builder)
253 Builder->Release();
254
255 // If there are errors before or when releasing the Builder, reset
256 // the module to stop here before invoking the backend.
257 if (Diags.hasErrorOccurred()) {
258 if (Builder)
259 Builder->clear();
260 M.reset();
261 return;
262 }
263 }
264
AssignInheritanceModel(CXXRecordDecl * RD)265 void AssignInheritanceModel(CXXRecordDecl *RD) override {
266 if (Diags.hasErrorOccurred())
267 return;
268
269 Builder->RefreshTypeCacheForClass(RD);
270 }
271
CompleteTentativeDefinition(VarDecl * D)272 void CompleteTentativeDefinition(VarDecl *D) override {
273 if (Diags.hasErrorOccurred())
274 return;
275
276 Builder->EmitTentativeDefinition(D);
277 }
278
HandleVTable(CXXRecordDecl * RD)279 void HandleVTable(CXXRecordDecl *RD) override {
280 if (Diags.hasErrorOccurred())
281 return;
282
283 Builder->EmitVTable(RD);
284 }
285 };
286 }
287
anchor()288 void CodeGenerator::anchor() { }
289
CGM()290 CodeGenModule &CodeGenerator::CGM() {
291 return static_cast<CodeGeneratorImpl*>(this)->CGM();
292 }
293
GetModule()294 llvm::Module *CodeGenerator::GetModule() {
295 return static_cast<CodeGeneratorImpl*>(this)->GetModule();
296 }
297
ReleaseModule()298 llvm::Module *CodeGenerator::ReleaseModule() {
299 return static_cast<CodeGeneratorImpl*>(this)->ReleaseModule();
300 }
301
GetDeclForMangledName(llvm::StringRef name)302 const Decl *CodeGenerator::GetDeclForMangledName(llvm::StringRef name) {
303 return static_cast<CodeGeneratorImpl*>(this)->GetDeclForMangledName(name);
304 }
305
GetAddrOfGlobal(GlobalDecl global,bool isForDefinition)306 llvm::Constant *CodeGenerator::GetAddrOfGlobal(GlobalDecl global,
307 bool isForDefinition) {
308 return static_cast<CodeGeneratorImpl*>(this)
309 ->GetAddrOfGlobal(global, isForDefinition);
310 }
311
CreateLLVMCodeGen(DiagnosticsEngine & Diags,llvm::StringRef ModuleName,const HeaderSearchOptions & HeaderSearchOpts,const PreprocessorOptions & PreprocessorOpts,const CodeGenOptions & CGO,llvm::LLVMContext & C,CoverageSourceInfo * CoverageInfo)312 CodeGenerator *clang::CreateLLVMCodeGen(
313 DiagnosticsEngine &Diags, llvm::StringRef ModuleName,
314 const HeaderSearchOptions &HeaderSearchOpts,
315 const PreprocessorOptions &PreprocessorOpts, const CodeGenOptions &CGO,
316 llvm::LLVMContext &C, CoverageSourceInfo *CoverageInfo) {
317 return new CodeGeneratorImpl(Diags, ModuleName, HeaderSearchOpts,
318 PreprocessorOpts, CGO, C, CoverageInfo);
319 }
320