LLVM  15.0.0git
DwarfFile.cpp
Go to the documentation of this file.
1 //===- llvm/CodeGen/DwarfFile.cpp - Dwarf Debug Framework -----------------===//
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 "DwarfFile.h"
10 #include "DwarfCompileUnit.h"
11 #include "DwarfDebug.h"
12 #include "DwarfUnit.h"
15 #include "llvm/MC/MCStreamer.h"
16 #include <cstdint>
17 
18 using namespace llvm;
19 
21  : Asm(AP), Abbrevs(AbbrevAllocator), StrPool(DA, *Asm, Pref) {}
22 
23 void DwarfFile::addUnit(std::unique_ptr<DwarfCompileUnit> U) {
24  CUs.push_back(std::move(U));
25 }
26 
27 // Emit the various dwarf units to the unit section USection with
28 // the abbreviations going into ASection.
29 void DwarfFile::emitUnits(bool UseOffsets) {
30  for (const auto &TheU : CUs)
31  emitUnit(TheU.get(), UseOffsets);
32 }
33 
34 void DwarfFile::emitUnit(DwarfUnit *TheU, bool UseOffsets) {
35  if (TheU->getCUNode()->isDebugDirectivesOnly())
36  return;
37 
38  MCSection *S = TheU->getSection();
39 
40  if (!S)
41  return;
42 
43  // Skip CUs that ended up not being needed (split CUs that were abandoned
44  // because they added no information beyond the non-split CU)
45  if (llvm::empty(TheU->getUnitDie().values()))
46  return;
47 
48  Asm->OutStreamer->SwitchSection(S);
49  TheU->emitHeader(UseOffsets);
50  Asm->emitDwarfDIE(TheU->getUnitDie());
51 
52  if (MCSymbol *EndLabel = TheU->getEndLabel())
53  Asm->OutStreamer->emitLabel(EndLabel);
54 }
55 
56 // Compute the size and offset for each DIE.
58  // Offset from the first CU in the debug info section is 0 initially.
59  uint64_t SecOffset = 0;
60 
61  // Iterate over each compile unit and set the size and offsets for each
62  // DIE within each compile unit. All offsets are CU relative.
63  for (const auto &TheU : CUs) {
64  if (TheU->getCUNode()->isDebugDirectivesOnly())
65  continue;
66 
67  // Skip CUs that ended up not being needed (split CUs that were abandoned
68  // because they added no information beyond the non-split CU)
69  if (llvm::empty(TheU->getUnitDie().values()))
70  return;
71 
72  TheU->setDebugSectionOffset(SecOffset);
73  SecOffset += computeSizeAndOffsetsForUnit(TheU.get());
74  }
75  if (SecOffset > UINT32_MAX && !Asm->isDwarf64())
76  report_fatal_error("The generated debug information is too large "
77  "for the 32-bit DWARF format.");
78 }
79 
81  // CU-relative offset is reset to 0 here.
82  unsigned Offset = Asm->getUnitLengthFieldByteSize() + // Length of Unit Info
83  TheU->getHeaderSize(); // Unit-specific headers
84 
85  // The return value here is CU-relative, after laying out
86  // all of the CU DIE.
87  return computeSizeAndOffset(TheU->getUnitDie(), Offset);
88 }
89 
90 // Compute the size and offset of a DIE. The offset is relative to start of the
91 // CU. It returns the offset after laying out the DIE.
92 unsigned DwarfFile::computeSizeAndOffset(DIE &Die, unsigned Offset) {
93  return Die.computeOffsetsAndAbbrevs(Asm->getDwarfFormParams(), Abbrevs,
94  Offset);
95 }
96 
97 void DwarfFile::emitAbbrevs(MCSection *Section) { Abbrevs.Emit(Asm, Section); }
98 
99 // Emit strings into a string section.
100 void DwarfFile::emitStrings(MCSection *StrSection, MCSection *OffsetSection,
101  bool UseRelativeOffsets) {
102  StrPool.emit(*Asm, StrSection, OffsetSection, UseRelativeOffsets);
103 }
104 
106  auto &ScopeVars = ScopeVariables[LS];
107  const DILocalVariable *DV = Var->getVariable();
108  if (unsigned ArgNum = DV->getArg()) {
109  auto Cached = ScopeVars.Args.find(ArgNum);
110  if (Cached == ScopeVars.Args.end())
111  ScopeVars.Args[ArgNum] = Var;
112  else {
113  Cached->second->addMMIEntry(*Var);
114  return false;
115  }
116  } else {
117  ScopeVars.Locals.push_back(Var);
118  }
119  return true;
120 }
121 
123  SmallVectorImpl<DbgLabel *> &Labels = ScopeLabels[LS];
124  Labels.push_back(Label);
125 }
126 
127 std::pair<uint32_t, RangeSpanList *>
129  CURangeLists.push_back(
130  RangeSpanList{Asm->createTempSymbol("debug_ranges"), &CU, std::move(R)});
131  return std::make_pair(CURangeLists.size() - 1, &CURangeLists.back());
132 }
AsmPrinter.h
llvm
This is an optimization pass for GlobalISel generic memory operations.
Definition: AddressRanges.h:17
llvm::MCSymbol
MCSymbol - Instances of this class represent a symbol name in the MC file, and MCSymbols are created ...
Definition: MCSymbol.h:41
llvm::DwarfUnit::emitHeader
virtual void emitHeader(bool UseOffsets)=0
Emit the header for this unit, not including the initial length field.
DebugInfoMetadata.h
llvm::AsmPrinter::createTempSymbol
MCSymbol * createTempSymbol(const Twine &Name) const
Definition: AsmPrinter.cpp:3316
llvm::DwarfFile::DwarfFile
DwarfFile(AsmPrinter *AP, StringRef Pref, BumpPtrAllocator &DA)
Definition: DwarfFile.cpp:20
llvm::DwarfCompileUnit
Definition: DwarfCompileUnit.h:46
llvm::SmallVector
This is a 'vector' (really, a variable-sized array), optimized for the case when the array is small.
Definition: SmallVector.h:1185
llvm::LexicalScope
LexicalScope - This class is used to track scope information.
Definition: LexicalScopes.h:44
llvm::DwarfUnit::getEndLabel
MCSymbol * getEndLabel() const
Definition: DwarfUnit.h:97
llvm::DwarfFile::addScopeVariable
bool addScopeVariable(LexicalScope *LS, DbgVariable *Var)
Definition: DwarfFile.cpp:105
llvm::DIE
A structured debug information entry.
Definition: DIE.h:739
llvm::DbgLabel
This class is used to track label information.
Definition: DwarfDebug.h:232
llvm::DIE::computeOffsetsAndAbbrevs
unsigned computeOffsetsAndAbbrevs(const dwarf::FormParams &FormParams, DIEAbbrevSet &AbbrevSet, unsigned CUOffset)
Compute the offset of this DIE and all its children.
Definition: DIE.cpp:272
llvm::DIEValueList::values
value_range values()
Definition: DIE.h:727
llvm::DwarfFile::computeSizeAndOffset
unsigned computeSizeAndOffset(DIE &Die, unsigned Offset)
Compute the size and offset of a DIE given an incoming Offset.
Definition: DwarfFile.cpp:92
DwarfFile.h
llvm::DwarfFile::emitUnit
void emitUnit(DwarfUnit *TheU, bool UseOffsets)
Emit the given unit to its section.
Definition: DwarfFile.cpp:34
llvm::DILocalVariable
Local variable.
Definition: DebugInfoMetadata.h:3048
llvm::AsmPrinter::OutStreamer
std::unique_ptr< MCStreamer > OutStreamer
This is the MCStreamer object for the file we are generating.
Definition: AsmPrinter.h:96
llvm::DwarfUnit::getCUNode
const DICompileUnit * getCUNode() const
Definition: DwarfUnit.h:99
llvm::BasicBlockSection::Labels
@ Labels
llvm::report_fatal_error
void report_fatal_error(Error Err, bool gen_crash_diag=true)
Report a serious error, calling any installed error handler.
Definition: Error.cpp:143
llvm::DwarfFile::addRange
std::pair< uint32_t, RangeSpanList * > addRange(const DwarfCompileUnit &CU, SmallVector< RangeSpan, 2 > R)
Definition: DwarfFile.cpp:128
llvm::DwarfFile::emitStrings
void emitStrings(MCSection *StrSection, MCSection *OffsetSection=nullptr, bool UseRelativeOffsets=false)
Emit all of the strings to the section given.
Definition: DwarfFile.cpp:100
llvm::DIEAbbrevSet::Emit
void Emit(const AsmPrinter *AP, MCSection *Section) const
Print all abbreviations using the specified asm printer.
Definition: DIE.cpp:164
DwarfDebug.h
llvm::DbgVariable
This class is used to track local variable information.
Definition: DwarfDebug.h:115
llvm::DILocalVariable::getArg
unsigned getArg() const
Definition: DebugInfoMetadata.h:3111
uint64_t
llvm::BumpPtrAllocatorImpl
Allocate memory in an ever growing pool, as if by bump-pointer.
Definition: Allocator.h:63
move
compiles ldr LCPI1_0 ldr ldr mov lsr tst moveq r1 ldr LCPI1_1 and r0 bx lr It would be better to do something like to fold the shift into the conditional move
Definition: README.txt:546
llvm::DIEUnit::getSection
MCSection * getSection() const
Return the section that this DIEUnit will be emitted into.
Definition: DIE.h:916
llvm::DICompileUnit::isDebugDirectivesOnly
bool isDebugDirectivesOnly() const
Definition: DebugInfoMetadata.h:1444
llvm::DwarfFile::computeSizeAndOffsetsForUnit
unsigned computeSizeAndOffsetsForUnit(DwarfUnit *TheU)
Compute the size and offset of all the DIEs in the given unit.
Definition: DwarfFile.cpp:80
llvm::DwarfFile::addScopeLabel
void addScopeLabel(LexicalScope *LS, DbgLabel *Label)
Definition: DwarfFile.cpp:122
llvm::StringRef
StringRef - Represent a constant reference to a string, i.e.
Definition: StringRef.h:58
llvm::DwarfStringPool::emit
void emit(AsmPrinter &Asm, MCSection *StrSection, MCSection *OffsetSection=nullptr, bool UseRelativeOffsets=false)
Definition: DwarfStringPool.cpp:75
llvm::MCSection
Instances of this class represent a uniqued identifier for a section in the current translation unit.
Definition: MCSection.h:39
S
add sub stmia L5 ldr r0 bl L_printf $stub Instead of a and a wouldn t it be better to do three moves *Return an aggregate type is even return S
Definition: README.txt:210
DwarfCompileUnit.h
llvm::AsmPrinter::getUnitLengthFieldByteSize
unsigned int getUnitLengthFieldByteSize() const
Returns 4 for DWARF32 and 12 for DWARF64.
Definition: AsmPrinter.cpp:3829
llvm::DwarfFile::addUnit
void addUnit(std::unique_ptr< DwarfCompileUnit > U)
Add a unit to the list of CUs.
Definition: DwarfFile.cpp:23
llvm::DwarfFile::computeSizeAndOffsets
void computeSizeAndOffsets()
Compute the size and offset of all the DIEs.
Definition: DwarfFile.cpp:57
llvm::empty
constexpr bool empty(const T &RangeOrContainer)
Test whether RangeOrContainer is empty. Similar to C++17 std::empty.
Definition: STLExtras.h:268
llvm::AsmPrinter::isDwarf64
bool isDwarf64() const
Definition: AsmPrinter.cpp:3814
llvm::AArch64CC::LS
@ LS
Definition: AArch64BaseInfo.h:264
DwarfUnit.h
llvm::AsmPrinter
This class is intended to be used as a driving class for all asm writers.
Definition: AsmPrinter.h:81
llvm::M68kBeads::DA
@ DA
Definition: M68kBaseInfo.h:59
llvm::DwarfFile::emitUnits
void emitUnits(bool UseOffsets)
Emit all of the units to the section listed with the given abbreviation section.
Definition: DwarfFile.cpp:29
MCStreamer.h
llvm::DbgVariable::getVariable
const DILocalVariable * getVariable() const
Definition: DwarfDebug.h:166
llvm::SmallVectorImpl
This class consists of common code factored out of the SmallVector class to reduce code duplication b...
Definition: APFloat.h:42
llvm::HexStyle::Asm
@ Asm
0ffh
Definition: MCInstPrinter.h:34
llvm::AsmPrinter::emitDwarfDIE
void emitDwarfDIE(const DIE &Die) const
Recursively emit Dwarf DIE tree.
Definition: AsmPrinterDwarf.cpp:285
llvm::DwarfUnit
This dwarf writer support class manages information associated with a source file.
Definition: DwarfUnit.h:35
llvm::DwarfFile::emitAbbrevs
void emitAbbrevs(MCSection *)
Emit a set of abbreviations to the specific section.
Definition: DwarfFile.cpp:97
llvm::DbgVariable::addMMIEntry
void addMMIEntry(const DbgVariable &V)
Definition: DwarfDebug.cpp:290
CU
Definition: AArch64AsmBackend.cpp:505
llvm::RangeSpanList
Definition: DwarfFile.h:41
llvm::DIEUnit::getUnitDie
DIE & getUnitDie()
Definition: DIE.h:919
llvm::DwarfUnit::getHeaderSize
virtual unsigned getHeaderSize() const
Compute the size of a header for this unit, not including the initial length field.
Definition: DwarfUnit.h:269
llvm::AsmPrinter::getDwarfFormParams
dwarf::FormParams getDwarfFormParams() const
Returns information about the byte size of DW_FORM values.
Definition: AsmPrinter.cpp:3823