Coverage Report

Created: 2021-01-23 06:44

/Users/buildslave/jenkins/workspace/coverage/llvm-project/clang/lib/CodeGen/ObjectFilePCHContainerOperations.cpp
Line
Count
Source (jump to first uncovered line)
1
//===--- ObjectFilePCHContainerOperations.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
#include "clang/CodeGen/ObjectFilePCHContainerOperations.h"
10
#include "CGDebugInfo.h"
11
#include "CodeGenModule.h"
12
#include "clang/AST/ASTContext.h"
13
#include "clang/AST/DeclObjC.h"
14
#include "clang/AST/Expr.h"
15
#include "clang/AST/RecursiveASTVisitor.h"
16
#include "clang/Basic/CodeGenOptions.h"
17
#include "clang/Basic/Diagnostic.h"
18
#include "clang/Basic/TargetInfo.h"
19
#include "clang/CodeGen/BackendUtil.h"
20
#include "clang/Frontend/CompilerInstance.h"
21
#include "clang/Lex/HeaderSearch.h"
22
#include "clang/Lex/Preprocessor.h"
23
#include "llvm/ADT/StringRef.h"
24
#include "llvm/Bitstream/BitstreamReader.h"
25
#include "llvm/DebugInfo/DWARF/DWARFContext.h"
26
#include "llvm/IR/Constants.h"
27
#include "llvm/IR/DataLayout.h"
28
#include "llvm/IR/LLVMContext.h"
29
#include "llvm/IR/Module.h"
30
#include "llvm/Object/COFF.h"
31
#include "llvm/Object/ObjectFile.h"
32
#include "llvm/Support/Path.h"
33
#include "llvm/Support/TargetRegistry.h"
34
#include <memory>
35
#include <utility>
36
37
using namespace clang;
38
39
#define DEBUG_TYPE "pchcontainer"
40
41
namespace {
42
class PCHContainerGenerator : public ASTConsumer {
43
  DiagnosticsEngine &Diags;
44
  const std::string MainFileName;
45
  const std::string OutputFileName;
46
  ASTContext *Ctx;
47
  ModuleMap &MMap;
48
  const HeaderSearchOptions &HeaderSearchOpts;
49
  const PreprocessorOptions &PreprocessorOpts;
50
  CodeGenOptions CodeGenOpts;
51
  const TargetOptions TargetOpts;
52
  LangOptions LangOpts;
53
  std::unique_ptr<llvm::LLVMContext> VMContext;
54
  std::unique_ptr<llvm::Module> M;
55
  std::unique_ptr<CodeGen::CodeGenModule> Builder;
56
  std::unique_ptr<raw_pwrite_stream> OS;
57
  std::shared_ptr<PCHBuffer> Buffer;
58
59
  /// Visit every type and emit debug info for it.
60
  struct DebugTypeVisitor : public RecursiveASTVisitor<DebugTypeVisitor> {
61
    clang::CodeGen::CGDebugInfo &DI;
62
    ASTContext &Ctx;
63
    DebugTypeVisitor(clang::CodeGen::CGDebugInfo &DI, ASTContext &Ctx)
64
244k
        : DI(DI), Ctx(Ctx) {}
65
66
    /// Determine whether this type can be represented in DWARF.
67
557k
    static bool CanRepresent(const Type *Ty) {
68
557k
      return !Ty->isDependentType() && 
!Ty->isUndeducedType()338k
;
69
557k
    }
70
71
8
    bool VisitImportDecl(ImportDecl *D) {
72
8
      if (!D->getImportedOwningModule())
73
8
        DI.EmitImportDecl(*D);
74
8
      return true;
75
8
    }
76
77
392k
    bool VisitTypeDecl(TypeDecl *D) {
78
      // TagDecls may be deferred until after all decls have been merged and we
79
      // know the complete type. Pure forward declarations will be skipped, but
80
      // they don't need to be emitted into the module anyway.
81
392k
      if (auto *TD = dyn_cast<TagDecl>(D))
82
147k
        if (!TD->isCompleteDefinition())
83
15.1k
          return true;
84
85
377k
      QualType QualTy = Ctx.getTypeDeclType(D);
86
377k
      if (!QualTy.isNull() && CanRepresent(QualTy.getTypePtr()))
87
179k
        DI.getOrCreateStandaloneType(QualTy, D->getLocation());
88
377k
      return true;
89
377k
    }
90
91
5.66k
    bool VisitObjCInterfaceDecl(ObjCInterfaceDecl *D) {
92
5.66k
      QualType QualTy(D->getTypeForDecl(), 0);
93
5.66k
      if (!QualTy.isNull() && CanRepresent(QualTy.getTypePtr()))
94
5.66k
        DI.getOrCreateStandaloneType(QualTy, D->getLocation());
95
5.66k
      return true;
96
5.66k
    }
97
98
300k
    bool VisitFunctionDecl(FunctionDecl *D) {
99
300k
      if (isa<CXXMethodDecl>(D))
100
        // This is not yet supported. Constructing the `this' argument
101
        // mandates a CodeGenFunction.
102
143k
        return true;
103
104
156k
      SmallVector<QualType, 16> ArgTypes;
105
156k
      for (auto i : D->parameters())
106
367k
        ArgTypes.push_back(i->getType());
107
156k
      QualType RetTy = D->getReturnType();
108
156k
      QualType FnTy = Ctx.getFunctionType(RetTy, ArgTypes,
109
156k
                                          FunctionProtoType::ExtProtoInfo());
110
156k
      if (CanRepresent(FnTy.getTypePtr()))
111
135k
        DI.EmitFunctionDecl(D, D->getLocation(), FnTy);
112
156k
      return true;
113
156k
    }
114
115
19.4k
    bool VisitObjCMethodDecl(ObjCMethodDecl *D) {
116
19.4k
      if (!D->getClassInterface())
117
2.26k
        return true;
118
119
17.1k
      bool selfIsPseudoStrong, selfIsConsumed;
120
17.1k
      SmallVector<QualType, 16> ArgTypes;
121
17.1k
      ArgTypes.push_back(D->getSelfType(Ctx, D->getClassInterface(),
122
17.1k
                                        selfIsPseudoStrong, selfIsConsumed));
123
17.1k
      ArgTypes.push_back(Ctx.getObjCSelType());
124
17.1k
      for (auto i : D->parameters())
125
24.7k
        ArgTypes.push_back(i->getType());
126
17.1k
      QualType RetTy = D->getReturnType();
127
17.1k
      QualType FnTy = Ctx.getFunctionType(RetTy, ArgTypes,
128
17.1k
                                          FunctionProtoType::ExtProtoInfo());
129
17.1k
      if (CanRepresent(FnTy.getTypePtr()))
130
17.1k
        DI.EmitFunctionDecl(D, D->getLocation(), FnTy);
131
17.1k
      return true;
132
17.1k
    }
133
  };
134
135
public:
136
  PCHContainerGenerator(CompilerInstance &CI, const std::string &MainFileName,
137
                        const std::string &OutputFileName,
138
                        std::unique_ptr<raw_pwrite_stream> OS,
139
                        std::shared_ptr<PCHBuffer> Buffer)
140
      : Diags(CI.getDiagnostics()), MainFileName(MainFileName),
141
        OutputFileName(OutputFileName), Ctx(nullptr),
142
        MMap(CI.getPreprocessor().getHeaderSearchInfo().getModuleMap()),
143
        HeaderSearchOpts(CI.getHeaderSearchOpts()),
144
        PreprocessorOpts(CI.getPreprocessorOpts()),
145
        TargetOpts(CI.getTargetOpts()), LangOpts(CI.getLangOpts()),
146
275
        OS(std::move(OS)), Buffer(std::move(Buffer)) {
147
    // The debug info output isn't affected by CodeModel and
148
    // ThreadModel, but the backend expects them to be nonempty.
149
275
    CodeGenOpts.CodeModel = "default";
150
275
    LangOpts.setThreadModel(LangOptions::ThreadModelKind::Single);
151
275
    CodeGenOpts.DebugTypeExtRefs = true;
152
    // When building a module MainFileName is the name of the modulemap file.
153
275
    CodeGenOpts.MainFileName =
154
265
        LangOpts.CurrentModule.empty() ? 
MainFileName10
: LangOpts.CurrentModule;
155
275
    CodeGenOpts.setDebugInfo(codegenoptions::FullDebugInfo);
156
275
    CodeGenOpts.setDebuggerTuning(CI.getCodeGenOpts().getDebuggerTuning());
157
275
    CodeGenOpts.DebugPrefixMap =
158
275
        CI.getInvocation().getCodeGenOpts().DebugPrefixMap;
159
275
  }
160
161
275
  ~PCHContainerGenerator() override = default;
162
163
275
  void Initialize(ASTContext &Context) override {
164
275
    assert(!Ctx && "initialized multiple times");
165
166
275
    Ctx = &Context;
167
275
    VMContext.reset(new llvm::LLVMContext());
168
275
    M.reset(new llvm::Module(MainFileName, *VMContext));
169
275
    M->setDataLayout(Ctx->getTargetInfo().getDataLayout());
170
275
    Builder.reset(new CodeGen::CodeGenModule(
171
275
        *Ctx, HeaderSearchOpts, PreprocessorOpts, CodeGenOpts, *M, Diags));
172
173
    // Prepare CGDebugInfo to emit debug info for a clang module.
174
275
    auto *DI = Builder->getModuleDebugInfo();
175
275
    StringRef ModuleName = llvm::sys::path::filename(MainFileName);
176
275
    DI->setPCHDescriptor(
177
275
        {ModuleName, "", OutputFileName, ASTFileSignature::createDISentinel()});
178
275
    DI->setModuleMap(MMap);
179
275
  }
180
181
165k
  bool HandleTopLevelDecl(DeclGroupRef D) override {
182
165k
    if (Diags.hasErrorOccurred())
183
0
      return true;
184
185
    // Collect debug info for all decls in this group.
186
165k
    for (auto *I : D)
187
183k
      if (!I->isFromASTFile()) {
188
180k
        DebugTypeVisitor DTV(*Builder->getModuleDebugInfo(), *Ctx);
189
180k
        DTV.TraverseDecl(I);
190
180k
      }
191
165k
    return true;
192
165k
  }
193
194
1.13k
  void HandleTopLevelDeclInObjCContainer(DeclGroupRef D) override {
195
1.13k
    HandleTopLevelDecl(D);
196
1.13k
  }
197
198
94.1k
  void HandleTagDeclDefinition(TagDecl *D) override {
199
94.1k
    if (Diags.hasErrorOccurred())
200
0
      return;
201
202
94.1k
    if (D->isFromASTFile())
203
1
      return;
204
205
    // Anonymous tag decls are deferred until we are building their declcontext.
206
94.1k
    if (D->getName().empty())
207
28.5k
      return;
208
209
    // Defer tag decls until their declcontext is complete.
210
65.5k
    auto *DeclCtx = D->getDeclContext();
211
276k
    while (DeclCtx) {
212
212k
      if (auto *D = dyn_cast<TagDecl>(DeclCtx))
213
2.02k
        if (!D->isCompleteDefinition())
214
1.77k
          return;
215
210k
      DeclCtx = DeclCtx->getParent();
216
210k
    }
217
218
63.7k
    DebugTypeVisitor DTV(*Builder->getModuleDebugInfo(), *Ctx);
219
63.7k
    DTV.TraverseDecl(D);
220
63.7k
    Builder->UpdateCompletedType(D);
221
63.7k
  }
222
223
48.8k
  void HandleTagDeclRequiredDefinition(const TagDecl *D) override {
224
48.8k
    if (Diags.hasErrorOccurred())
225
0
      return;
226
227
48.8k
    if (const RecordDecl *RD = dyn_cast<RecordDecl>(D))
228
48.2k
      Builder->getModuleDebugInfo()->completeRequiredType(RD);
229
48.8k
  }
230
231
63.7k
  void HandleImplicitImportDecl(ImportDecl *D) override {
232
63.7k
    if (!D->getImportedOwningModule())
233
63.7k
      Builder->getModuleDebugInfo()->EmitImportDecl(*D);
234
63.7k
  }
235
236
  /// Emit a container holding the serialized AST.
237
275
  void HandleTranslationUnit(ASTContext &Ctx) override {
238
275
    assert(M && VMContext && Builder);
239
    // Delete these on function exit.
240
275
    std::unique_ptr<llvm::LLVMContext> VMContext = std::move(this->VMContext);
241
275
    std::unique_ptr<llvm::Module> M = std::move(this->M);
242
275
    std::unique_ptr<CodeGen::CodeGenModule> Builder = std::move(this->Builder);
243
244
275
    if (Diags.hasErrorOccurred())
245
0
      return;
246
247
275
    M->setTargetTriple(Ctx.getTargetInfo().getTriple().getTriple());
248
275
    M->setDataLayout(Ctx.getTargetInfo().getDataLayout());
249
250
    // PCH files don't have a signature field in the control block,
251
    // but LLVM detects DWO CUs by looking for a non-zero DWO id.
252
    // We use the lower 64 bits for debug info.
253
254
275
    uint64_t Signature =
255
265
        Buffer->Signature ? Buffer->Signature.truncatedValue() : 
~1ULL10
;
256
257
275
    Builder->getModuleDebugInfo()->setDwoId(Signature);
258
259
    // Finalize the Builder.
260
275
    if (Builder)
261
275
      Builder->Release();
262
263
    // Ensure the target exists.
264
275
    std::string Error;
265
275
    auto Triple = Ctx.getTargetInfo().getTriple();
266
275
    if (!llvm::TargetRegistry::lookupTarget(Triple.getTriple(), Error))
267
0
      llvm::report_fatal_error(Error);
268
269
    // Emit the serialized Clang AST into its own section.
270
275
    assert(Buffer->IsComplete && "serialization did not complete");
271
275
    auto &SerializedAST = Buffer->Data;
272
275
    auto Size = SerializedAST.size();
273
275
    auto Int8Ty = llvm::Type::getInt8Ty(*VMContext);
274
275
    auto *Ty = llvm::ArrayType::get(Int8Ty, Size);
275
275
    auto *Data = llvm::ConstantDataArray::getString(
276
275
        *VMContext, StringRef(SerializedAST.data(), Size),
277
275
        /*AddNull=*/false);
278
275
    auto *ASTSym = new llvm::GlobalVariable(
279
275
        *M, Ty, /*constant*/ true, llvm::GlobalVariable::InternalLinkage, Data,
280
275
        "__clang_ast");
281
    // The on-disk hashtable needs to be aligned.
282
275
    ASTSym->setAlignment(llvm::Align(8));
283
284
    // Mach-O also needs a segment name.
285
275
    if (Triple.isOSBinFormatMachO())
286
271
      ASTSym->setSection("__CLANG,__clangast");
287
    // COFF has an eight character length limit.
288
4
    else if (Triple.isOSBinFormatCOFF())
289
2
      ASTSym->setSection("clangast");
290
2
    else
291
2
      ASTSym->setSection("__clangast");
292
293
275
    LLVM_DEBUG({
294
      // Print the IR for the PCH container to the debug output.
295
275
      llvm::SmallString<0> Buffer;
296
275
      clang::EmitBackendOutput(
297
275
          Diags, HeaderSearchOpts, CodeGenOpts, TargetOpts, LangOpts,
298
275
          Ctx.getTargetInfo().getDataLayout(), M.get(),
299
275
          BackendAction::Backend_EmitLL,
300
275
          std::make_unique<llvm::raw_svector_ostream>(Buffer));
301
275
      llvm::dbgs() << Buffer;
302
275
    });
303
304
    // Use the LLVM backend to emit the pch container.
305
275
    clang::EmitBackendOutput(Diags, HeaderSearchOpts, CodeGenOpts, TargetOpts,
306
275
                             LangOpts, Ctx.getTargetInfo().getDataLayout(),
307
275
                             M.get(), BackendAction::Backend_EmitObj,
308
275
                             std::move(OS));
309
310
    // Free the memory for the temporary buffer.
311
275
    llvm::SmallVector<char, 0> Empty;
312
275
    SerializedAST = std::move(Empty);
313
275
  }
314
};
315
316
} // anonymous namespace
317
318
std::unique_ptr<ASTConsumer>
319
ObjectFilePCHContainerWriter::CreatePCHContainerGenerator(
320
    CompilerInstance &CI, const std::string &MainFileName,
321
    const std::string &OutputFileName,
322
    std::unique_ptr<llvm::raw_pwrite_stream> OS,
323
275
    std::shared_ptr<PCHBuffer> Buffer) const {
324
275
  return std::make_unique<PCHContainerGenerator>(
325
275
      CI, MainFileName, OutputFileName, std::move(OS), Buffer);
326
275
}
327
328
StringRef
329
12.4k
ObjectFilePCHContainerReader::ExtractPCH(llvm::MemoryBufferRef Buffer) const {
330
12.4k
  StringRef PCH;
331
12.4k
  auto OFOrErr = llvm::object::ObjectFile::createObjectFile(Buffer);
332
12.4k
  if (OFOrErr) {
333
9.72k
    auto &OF = OFOrErr.get();
334
9.72k
    bool IsCOFF = isa<llvm::object::COFFObjectFile>(*OF);
335
    // Find the clang AST section in the container.
336
19.4k
    for (auto &Section : OF->sections()) {
337
19.4k
      StringRef Name;
338
19.4k
      if (Expected<StringRef> NameOrErr = Section.getName())
339
19.4k
        Name = *NameOrErr;
340
0
      else
341
0
        consumeError(NameOrErr.takeError());
342
343
19.4k
      if ((!IsCOFF && 
Name == "__clangast"19.4k
) ||
(9.73k
IsCOFF9.73k
&&
Name == "clangast"8
)) {
344
9.72k
        if (Expected<StringRef> E = Section.getContents())
345
9.72k
          return *E;
346
0
        else {
347
0
          handleAllErrors(E.takeError(), [&](const llvm::ErrorInfoBase &EIB) {
348
0
            EIB.log(llvm::errs());
349
0
          });
350
0
          return "";
351
0
        }
352
9.72k
      }
353
19.4k
    }
354
9.72k
  }
355
2.71k
  handleAllErrors(OFOrErr.takeError(), [&](const llvm::ErrorInfoBase &EIB) {
356
2.71k
    if (EIB.convertToErrorCode() ==
357
2.71k
        llvm::object::object_error::invalid_file_type)
358
      // As a fallback, treat the buffer as a raw AST.
359
2.71k
      PCH = Buffer.getBuffer();
360
0
    else
361
0
      EIB.log(llvm::errs());
362
2.71k
  });
363
2.71k
  return PCH;
364
12.4k
}