1 //===- DWARFAcceleratorTable.cpp ------------------------------------------===//
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 #include "llvm/DebugInfo/DWARF/DWARFAcceleratorTable.h"
11 
12 #include "llvm/ADT/SmallVector.h"
13 #include "llvm/BinaryFormat/Dwarf.h"
14 #include "llvm/DebugInfo/DWARF/DWARFContext.h"
15 #include "llvm/DebugInfo/DWARF/DWARFFormValue.h"
16 #include "llvm/DebugInfo/DWARF/DWARFRelocMap.h"
17 #include "llvm/Support/Compiler.h"
18 #include "llvm/Support/Format.h"
19 #include "llvm/Support/raw_ostream.h"
20 #include <cstddef>
21 #include <cstdint>
22 #include <utility>
23 
24 using namespace llvm;
25 
26 bool DWARFAcceleratorTable::extract() {
27   uint32_t Offset = 0;
28 
29   // Check that we can at least read the header.
30   if (!AccelSection.isValidOffset(offsetof(Header, HeaderDataLength)+4))
31     return false;
32 
33   Hdr.Magic = AccelSection.getU32(&Offset);
34   Hdr.Version = AccelSection.getU16(&Offset);
35   Hdr.HashFunction = AccelSection.getU16(&Offset);
36   Hdr.NumBuckets = AccelSection.getU32(&Offset);
37   Hdr.NumHashes = AccelSection.getU32(&Offset);
38   Hdr.HeaderDataLength = AccelSection.getU32(&Offset);
39 
40   // Check that we can read all the hashes and offsets from the
41   // section (see SourceLevelDebugging.rst for the structure of the index).
42   if (!AccelSection.isValidOffset(sizeof(Hdr) + Hdr.HeaderDataLength +
43                                   Hdr.NumBuckets*4 + Hdr.NumHashes*8))
44     return false;
45 
46   HdrData.DIEOffsetBase = AccelSection.getU32(&Offset);
47   uint32_t NumAtoms = AccelSection.getU32(&Offset);
48 
49   for (unsigned i = 0; i < NumAtoms; ++i) {
50     uint16_t AtomType = AccelSection.getU16(&Offset);
51     auto AtomForm = static_cast<dwarf::Form>(AccelSection.getU16(&Offset));
52     HdrData.Atoms.push_back(std::make_pair(AtomType, AtomForm));
53   }
54 
55   return true;
56 }
57 
58 uint32_t DWARFAcceleratorTable::getNumBuckets() { return Hdr.NumBuckets; }
59 uint32_t DWARFAcceleratorTable::getNumHashes() { return Hdr.NumHashes; }
60 uint32_t DWARFAcceleratorTable::getSizeHdr() { return sizeof(Hdr); }
61 uint32_t DWARFAcceleratorTable::getHeaderDataLength() {
62   return Hdr.HeaderDataLength;
63 }
64 
65 ArrayRef<std::pair<DWARFAcceleratorTable::HeaderData::AtomType,
66                    DWARFAcceleratorTable::HeaderData::Form>>
67 DWARFAcceleratorTable::getAtomsDesc() {
68   return HdrData.Atoms;
69 }
70 
71 bool DWARFAcceleratorTable::validateForms() {
72   for (auto Atom : getAtomsDesc()) {
73     DWARFFormValue FormValue(Atom.second);
74     switch (Atom.first) {
75     case dwarf::DW_ATOM_die_offset:
76     case dwarf::DW_ATOM_die_tag:
77     case dwarf::DW_ATOM_type_flags:
78       if ((!FormValue.isFormClass(DWARFFormValue::FC_Constant) &&
79            !FormValue.isFormClass(DWARFFormValue::FC_Flag)) ||
80           FormValue.getForm() == dwarf::DW_FORM_sdata)
81         return false;
82     default:
83       break;
84     }
85   }
86   return true;
87 }
88 
89 std::pair<uint32_t, dwarf::Tag>
90 DWARFAcceleratorTable::readAtoms(uint32_t &HashDataOffset) {
91   uint32_t DieOffset = dwarf::DW_INVALID_OFFSET;
92   dwarf::Tag DieTag = dwarf::DW_TAG_null;
93 
94   for (auto Atom : getAtomsDesc()) {
95     DWARFFormValue FormValue(Atom.second);
96     FormValue.extractValue(AccelSection, &HashDataOffset, NULL);
97     switch (Atom.first) {
98     case dwarf::DW_ATOM_die_offset:
99       DieOffset = *FormValue.getAsUnsignedConstant();
100       break;
101     case dwarf::DW_ATOM_die_tag:
102       DieTag = (dwarf::Tag)*FormValue.getAsUnsignedConstant();
103       break;
104     default:
105       break;
106     }
107   }
108   return {DieOffset, DieTag};
109 }
110 
111 LLVM_DUMP_METHOD void DWARFAcceleratorTable::dump(raw_ostream &OS) const {
112   // Dump the header.
113   OS << "Magic = " << format("0x%08x", Hdr.Magic) << '\n'
114      << "Version = " << format("0x%04x", Hdr.Version) << '\n'
115      << "Hash function = " << format("0x%08x", Hdr.HashFunction) << '\n'
116      << "Bucket count = " << Hdr.NumBuckets << '\n'
117      << "Hashes count = " << Hdr.NumHashes << '\n'
118      << "HeaderData length = " << Hdr.HeaderDataLength << '\n'
119      << "DIE offset base = " << HdrData.DIEOffsetBase << '\n'
120      << "Number of atoms = " << HdrData.Atoms.size() << '\n';
121 
122   unsigned i = 0;
123   SmallVector<DWARFFormValue, 3> AtomForms;
124   for (const auto &Atom: HdrData.Atoms) {
125     OS << format("Atom[%d] Type: ", i++);
126     auto TypeString = dwarf::AtomTypeString(Atom.first);
127     if (!TypeString.empty())
128       OS << TypeString;
129     else
130       OS << format("DW_ATOM_Unknown_0x%x", Atom.first);
131     OS << " Form: ";
132     auto FormString = dwarf::FormEncodingString(Atom.second);
133     if (!FormString.empty())
134       OS << FormString;
135     else
136       OS << format("DW_FORM_Unknown_0x%x", Atom.second);
137     OS << '\n';
138     AtomForms.push_back(DWARFFormValue(Atom.second));
139   }
140 
141   // Now go through the actual tables and dump them.
142   uint32_t Offset = sizeof(Hdr) + Hdr.HeaderDataLength;
143   unsigned HashesBase = Offset + Hdr.NumBuckets * 4;
144   unsigned OffsetsBase = HashesBase + Hdr.NumHashes * 4;
145 
146   for (unsigned Bucket = 0; Bucket < Hdr.NumBuckets; ++Bucket) {
147     unsigned Index = AccelSection.getU32(&Offset);
148 
149     OS << format("Bucket[%d]\n", Bucket);
150     if (Index == UINT32_MAX) {
151       OS << "  EMPTY\n";
152       continue;
153     }
154 
155     for (unsigned HashIdx = Index; HashIdx < Hdr.NumHashes; ++HashIdx) {
156       unsigned HashOffset = HashesBase + HashIdx*4;
157       unsigned OffsetsOffset = OffsetsBase + HashIdx*4;
158       uint32_t Hash = AccelSection.getU32(&HashOffset);
159 
160       if (Hash % Hdr.NumBuckets != Bucket)
161         break;
162 
163       unsigned DataOffset = AccelSection.getU32(&OffsetsOffset);
164       OS << format("  Hash = 0x%08x Offset = 0x%08x\n", Hash, DataOffset);
165       if (!AccelSection.isValidOffset(DataOffset)) {
166         OS << "    Invalid section offset\n";
167         continue;
168       }
169       while (AccelSection.isValidOffsetForDataOfSize(DataOffset, 4)) {
170         unsigned StringOffset = AccelSection.getRelocatedValue(4, &DataOffset);
171         if (!StringOffset)
172           break;
173         OS << format("    Name: %08x \"%s\"\n", StringOffset,
174                      StringSection.getCStr(&StringOffset));
175         unsigned NumData = AccelSection.getU32(&DataOffset);
176         for (unsigned Data = 0; Data < NumData; ++Data) {
177           OS << format("    Data[%d] => ", Data);
178           unsigned i = 0;
179           for (auto &Atom : AtomForms) {
180             OS << format("{Atom[%d]: ", i++);
181             if (Atom.extractValue(AccelSection, &DataOffset, nullptr))
182               Atom.dump(OS);
183             else
184               OS << "Error extracting the value";
185             OS << "} ";
186           }
187           OS << '\n';
188         }
189       }
190     }
191   }
192 }
193