1 //===-- llvm/CodeGen/DwarfFile.h - Dwarf Debug Framework -------*- C++ -*--===//
3 // The LLVM Compiler Infrastructure
5 // This file is distributed under the University of Illinois Open Source
6 // License. See LICENSE.TXT for details.
8 //===----------------------------------------------------------------------===//
10 #ifndef LLVM_LIB_CODEGEN_ASMPRINTER_DWARFFILE_H
11 #define LLVM_LIB_CODEGEN_ASMPRINTER_DWARFFILE_H
13 #include "AddressPool.h"
14 #include "DwarfStringPool.h"
15 #include "llvm/ADT/DenseMap.h"
16 #include "llvm/ADT/FoldingSet.h"
17 #include "llvm/ADT/SmallVector.h"
18 #include "llvm/ADT/StringMap.h"
19 #include "llvm/IR/Metadata.h"
20 #include "llvm/Support/Allocator.h"
27 class DwarfCompileUnit;
38 // Target of Dwarf emission, used for sizing of abbreviations.
41 BumpPtrAllocator AbbrevAllocator;
43 // Used to uniquely define abbreviations.
44 FoldingSet<DIEAbbrev> AbbreviationsSet;
46 // A list of all the unique abbreviations in use.
47 std::vector<DIEAbbrev *> Abbreviations;
49 // A pointer to all units in the section.
50 SmallVector<std::unique_ptr<DwarfCompileUnit>, 1> CUs;
52 DwarfStringPool StrPool;
54 // Collection of dbg variables of a scope.
55 DenseMap<LexicalScope *, SmallVector<DbgVariable *, 8>> ScopeVariables;
57 // Collection of abstract subprogram DIEs.
58 DenseMap<const MDNode *, DIE *> AbstractSPDies;
60 /// Maps MDNodes for type system with the corresponding DIEs. These DIEs can
61 /// be shared across CUs, that is why we keep the map here instead
62 /// of in DwarfCompileUnit.
63 DenseMap<const MDNode *, DIE *> DITypeNodeToDieMap;
66 DwarfFile(AsmPrinter *AP, StringRef Pref, BumpPtrAllocator &DA);
70 const SmallVectorImpl<std::unique_ptr<DwarfCompileUnit>> &getUnits() {
74 /// \brief Compute the size and offset of a DIE given an incoming Offset.
75 unsigned computeSizeAndOffset(DIE &Die, unsigned Offset);
77 /// \brief Compute the size and offset of all the DIEs.
78 void computeSizeAndOffsets();
80 /// \brief Compute the size and offset of all the DIEs in the given unit.
81 /// \returns The size of the root DIE.
82 unsigned computeSizeAndOffsetsForUnit(DwarfUnit *TheU);
84 /// Define a unique number for the abbreviation.
86 /// Compute the abbreviation for \c Die, look up its unique number, and
87 /// return a reference to it in the uniquing table.
88 DIEAbbrev &assignAbbrevNumber(DIE &Die);
90 /// \brief Add a unit to the list of CUs.
91 void addUnit(std::unique_ptr<DwarfCompileUnit> U);
93 /// \brief Emit all of the units to the section listed with the given
94 /// abbreviation section.
95 void emitUnits(bool UseOffsets);
97 /// \brief Emit the given unit to its section.
98 void emitUnit(DwarfUnit *U, bool UseOffsets);
100 /// \brief Emit a set of abbreviations to the specific section.
101 void emitAbbrevs(MCSection *);
103 /// \brief Emit all of the strings to the section given.
104 void emitStrings(MCSection *StrSection, MCSection *OffsetSection = nullptr);
106 /// \brief Returns the string pool.
107 DwarfStringPool &getStringPool() { return StrPool; }
109 /// \returns false if the variable was merged with a previous one.
110 bool addScopeVariable(LexicalScope *LS, DbgVariable *Var);
112 DenseMap<LexicalScope *, SmallVector<DbgVariable *, 8>> &getScopeVariables() {
113 return ScopeVariables;
116 DenseMap<const MDNode *, DIE *> &getAbstractSPDies() {
117 return AbstractSPDies;
120 void insertDIE(const MDNode *TypeMD, DIE *Die) {
121 DITypeNodeToDieMap.insert(std::make_pair(TypeMD, Die));
123 DIE *getDIE(const MDNode *TypeMD) {
124 return DITypeNodeToDieMap.lookup(TypeMD);