LLVM 22.0.0git
DIE.cpp
Go to the documentation of this file.
1//===--- lib/CodeGen/DIE.cpp - DWARF Info Entries -------------------------===//
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// Data structures for DWARF info entries.
10//
11//===----------------------------------------------------------------------===//
12
13#include "llvm/CodeGen/DIE.h"
14#include "DwarfCompileUnit.h"
15#include "DwarfDebug.h"
17#include "llvm/Config/llvm-config.h"
18#include "llvm/MC/MCAsmInfo.h"
19#include "llvm/MC/MCStreamer.h"
20#include "llvm/MC/MCSymbol.h"
21#include "llvm/Support/Debug.h"
23#include "llvm/Support/Format.h"
24#include "llvm/Support/LEB128.h"
26using namespace llvm;
27
28#define DEBUG_TYPE "dwarfdebug"
29
30//===----------------------------------------------------------------------===//
31// DIEAbbrevData Implementation
32//===----------------------------------------------------------------------===//
33
34/// Profile - Used to gather unique data for the abbreviation folding set.
35///
37 // Explicitly cast to an integer type for which FoldingSetNodeID has
38 // overloads. Otherwise MSVC 2010 thinks this call is ambiguous.
39 ID.AddInteger(unsigned(Attribute));
40 ID.AddInteger(unsigned(Form));
41 if (Form == dwarf::DW_FORM_implicit_const)
42 ID.AddInteger(Value);
43}
44
45//===----------------------------------------------------------------------===//
46// DIEAbbrev Implementation
47//===----------------------------------------------------------------------===//
48
49/// Profile - Used to gather unique data for the abbreviation folding set.
50///
52 ID.AddInteger(unsigned(Tag));
53 ID.AddInteger(unsigned(Children));
54
55 // For each attribute description.
56 for (const DIEAbbrevData &D : Data)
57 D.Profile(ID);
58}
59
60/// Emit - Print the abbreviation using the specified asm printer.
61///
62void DIEAbbrev::Emit(const AsmPrinter *AP) const {
63 // Emit its Dwarf tag type.
64 AP->emitULEB128(Tag, dwarf::TagString(Tag).data());
65
66 // Emit whether it has children DIEs.
67 AP->emitULEB128((unsigned)Children, dwarf::ChildrenString(Children).data());
68
69 // For each attribute description.
70 for (const DIEAbbrevData &AttrData : Data) {
71 // Emit attribute type.
72 AP->emitULEB128(AttrData.getAttribute(),
73 dwarf::AttributeString(AttrData.getAttribute()).data());
74
75 // Emit form type.
76#ifndef NDEBUG
77 // Could be an assertion, but this way we can see the failing form code
78 // easily, which helps track down where it came from.
79 if (!dwarf::isValidFormForVersion(AttrData.getForm(),
80 AP->getDwarfVersion())) {
81 LLVM_DEBUG(dbgs() << "Invalid form " << format("0x%x", AttrData.getForm())
82 << " for DWARF version " << AP->getDwarfVersion()
83 << "\n");
84 llvm_unreachable("Invalid form for specified DWARF version");
85 }
86#endif
87 AP->emitULEB128(AttrData.getForm(),
88 dwarf::FormEncodingString(AttrData.getForm()).data());
89
90 // Emit value for DW_FORM_implicit_const.
91 if (AttrData.getForm() == dwarf::DW_FORM_implicit_const)
92 AP->emitSLEB128(AttrData.getValue());
93 }
94
95 // Mark end of abbreviation.
96 AP->emitULEB128(0, "EOM(1)");
97 AP->emitULEB128(0, "EOM(2)");
98}
99
102 O << "Abbreviation @"
103 << format("0x%lx", (long)(intptr_t)this)
104 << " "
105 << dwarf::TagString(Tag)
106 << " "
107 << dwarf::ChildrenString(Children)
108 << '\n';
109
110 for (const DIEAbbrevData &D : Data) {
111 O << " " << dwarf::AttributeString(D.getAttribute()) << " "
112 << dwarf::FormEncodingString(D.getForm());
113
114 if (D.getForm() == dwarf::DW_FORM_implicit_const)
115 O << " " << D.getValue();
116
117 O << '\n';
118 }
119}
120
121#if !defined(NDEBUG) || defined(LLVM_ENABLE_DUMP)
123 print(dbgs());
124}
125#endif
126
127//===----------------------------------------------------------------------===//
128// DIEAbbrevSet Implementation
129//===----------------------------------------------------------------------===//
130
132 for (DIEAbbrev *Abbrev : Abbreviations)
133 Abbrev->~DIEAbbrev();
134}
135
137
139 DIEAbbrev Abbrev = Die.generateAbbrev();
140 Abbrev.Profile(ID);
141
142 void *InsertPos;
143 if (DIEAbbrev *Existing =
144 AbbreviationsSet.FindNodeOrInsertPos(ID, InsertPos)) {
145 Die.setAbbrevNumber(Existing->getNumber());
146 return *Existing;
147 }
148
149 // Move the abbreviation to the heap and assign a number.
150 DIEAbbrev *New = new (Alloc) DIEAbbrev(std::move(Abbrev));
151 Abbreviations.push_back(New);
152 New->setNumber(Abbreviations.size());
153 Die.setAbbrevNumber(Abbreviations.size());
154
155 // Store it for lookup.
156 AbbreviationsSet.InsertNode(New, InsertPos);
157 return *New;
158}
159
160void DIEAbbrevSet::Emit(const AsmPrinter *AP, MCSection *Section) const {
161 if (!Abbreviations.empty()) {
162 // Start the debug abbrev section.
163 AP->OutStreamer->switchSection(Section);
164 AP->emitDwarfAbbrevs(Abbreviations);
165 }
166}
167
168//===----------------------------------------------------------------------===//
169// DIE Implementation
170//===----------------------------------------------------------------------===//
171
172DIE *DIE::getParent() const { return dyn_cast_if_present<DIE *>(Owner); }
173
175 DIEAbbrev Abbrev(Tag, hasChildren());
176 for (const DIEValue &V : values())
177 if (V.getForm() == dwarf::DW_FORM_implicit_const)
178 Abbrev.AddImplicitConstAttribute(V.getAttribute(),
179 V.getDIEInteger().getValue());
180 else
181 Abbrev.AddAttribute(V.getAttribute(), V.getForm());
182 return Abbrev;
183}
184
186 const DIEUnit *Unit = getUnit();
187 assert(Unit && "DIE must be owned by a DIEUnit to get its absolute offset");
188 return Unit->getDebugSectionOffset() + getOffset();
189}
190
191const DIE *DIE::getUnitDie() const {
192 const DIE *p = this;
193 while (p) {
194 if (p->getTag() == dwarf::DW_TAG_compile_unit ||
195 p->getTag() == dwarf::DW_TAG_skeleton_unit ||
196 p->getTag() == dwarf::DW_TAG_type_unit)
197 return p;
198 p = p->getParent();
199 }
200 return nullptr;
201}
202
204 const DIE *UnitDie = getUnitDie();
205 if (UnitDie)
206 return dyn_cast_if_present<DIEUnit *>(UnitDie->Owner);
207 return nullptr;
208}
209
211 // Iterate through all the attributes until we find the one we're
212 // looking for, if we can't find it return NULL.
213 for (const auto &V : values())
214 if (V.getAttribute() == Attribute)
215 return V;
216 return DIEValue();
217}
218
220static void printValues(raw_ostream &O, const DIEValueList &Values,
221 StringRef Type, unsigned Size, unsigned IndentCount) {
222 O << Type << ": Size: " << Size << "\n";
223
224 unsigned I = 0;
225 const std::string Indent(IndentCount, ' ');
226 for (const auto &V : Values.values()) {
227 O << Indent;
228 O << "Blk[" << I++ << "]";
229 O << " " << dwarf::FormEncodingString(V.getForm()) << " ";
230 V.print(O);
231 O << "\n";
232 }
233}
234
236void DIE::print(raw_ostream &O, unsigned IndentCount) const {
237 const std::string Indent(IndentCount, ' ');
238 O << Indent << "Die: " << format("0x%lx", (long)(intptr_t) this)
239 << ", Offset: " << Offset << ", Size: " << Size << "\n";
240
241 O << Indent << dwarf::TagString(getTag()) << " "
243
244 IndentCount += 2;
245 for (const auto &V : values()) {
246 O << Indent;
247 O << dwarf::AttributeString(V.getAttribute());
248 O << " " << dwarf::FormEncodingString(V.getForm()) << " ";
249 V.print(O);
250 O << "\n";
251 }
252 IndentCount -= 2;
253
254 for (const auto &Child : children())
255 Child.print(O, IndentCount + 4);
256
257 O << "\n";
258}
259
260#if !defined(NDEBUG) || defined(LLVM_ENABLE_DUMP)
262 print(dbgs());
263}
264#endif
265
267 DIEAbbrevSet &AbbrevSet,
268 unsigned CUOffset) {
269 // Unique the abbreviation and fill in the abbreviation number so this DIE
270 // can be emitted.
271 const DIEAbbrev &Abbrev = AbbrevSet.uniqueAbbreviation(*this);
272
273 // Set compile/type unit relative offset of this DIE.
274 setOffset(CUOffset);
275
276 // Add the byte size of the abbreviation code.
277 CUOffset += getULEB128Size(getAbbrevNumber());
278
279 // Add the byte size of all the DIE attribute values.
280 for (const auto &V : values())
281 CUOffset += V.sizeOf(FormParams);
282
283 // Let the children compute their offsets and abbreviation numbers.
284 if (hasChildren()) {
285 (void)Abbrev;
286 assert(Abbrev.hasChildren() && "Children flag not set");
287
288 for (auto &Child : children())
289 CUOffset =
290 Child.computeOffsetsAndAbbrevs(FormParams, AbbrevSet, CUOffset);
291
292 // Each child chain is terminated with a zero byte, adjust the offset.
293 CUOffset += sizeof(int8_t);
294 }
295
296 // Compute the byte size of this DIE and all of its children correctly. This
297 // is needed so that top level DIE can help the compile unit set its length
298 // correctly.
299 setSize(CUOffset - getOffset());
300 return CUOffset;
301}
302
303//===----------------------------------------------------------------------===//
304// DIEUnit Implementation
305//===----------------------------------------------------------------------===//
306DIEUnit::DIEUnit(dwarf::Tag UnitTag) : Die(UnitTag) {
307 Die.Owner = this;
308 assert((UnitTag == dwarf::DW_TAG_compile_unit ||
309 UnitTag == dwarf::DW_TAG_skeleton_unit ||
310 UnitTag == dwarf::DW_TAG_type_unit ||
311 UnitTag == dwarf::DW_TAG_partial_unit) &&
312 "expected a unit TAG");
313}
314
315void DIEValue::emitValue(const AsmPrinter *AP) const {
316 switch (Ty) {
317 case isNone:
318 llvm_unreachable("Expected valid DIEValue");
319#define HANDLE_DIEVALUE(T) \
320 case is##T: \
321 getDIE##T().emitValue(AP, Form); \
322 break;
323#include "llvm/CodeGen/DIEValue.def"
324 }
325}
326
327unsigned DIEValue::sizeOf(const dwarf::FormParams &FormParams) const {
328 switch (Ty) {
329 case isNone:
330 llvm_unreachable("Expected valid DIEValue");
331#define HANDLE_DIEVALUE(T) \
332 case is##T: \
333 return getDIE##T().sizeOf(FormParams, Form);
334#include "llvm/CodeGen/DIEValue.def"
335 }
336 llvm_unreachable("Unknown DIE kind");
337}
338
341 switch (Ty) {
342 case isNone:
343 llvm_unreachable("Expected valid DIEValue");
344#define HANDLE_DIEVALUE(T) \
345 case is##T: \
346 getDIE##T().print(O); \
347 break;
348#include "llvm/CodeGen/DIEValue.def"
349 }
350}
351
352#if !defined(NDEBUG) || defined(LLVM_ENABLE_DUMP)
354 print(dbgs());
355}
356#endif
357
358//===----------------------------------------------------------------------===//
359// DIEInteger Implementation
360//===----------------------------------------------------------------------===//
361
362/// EmitValue - Emit integer of appropriate size.
363///
364void DIEInteger::emitValue(const AsmPrinter *Asm, dwarf::Form Form) const {
365 switch (Form) {
366 case dwarf::DW_FORM_implicit_const:
367 case dwarf::DW_FORM_flag_present:
368 // Emit something to keep the lines and comments in sync.
369 // FIXME: Is there a better way to do this?
370 Asm->OutStreamer->addBlankLine();
371 return;
372 case dwarf::DW_FORM_flag:
373 case dwarf::DW_FORM_ref1:
374 case dwarf::DW_FORM_data1:
375 case dwarf::DW_FORM_strx1:
376 case dwarf::DW_FORM_addrx1:
377 case dwarf::DW_FORM_ref2:
378 case dwarf::DW_FORM_data2:
379 case dwarf::DW_FORM_strx2:
380 case dwarf::DW_FORM_addrx2:
381 case dwarf::DW_FORM_strx3:
382 case dwarf::DW_FORM_addrx3:
383 case dwarf::DW_FORM_strp:
384 case dwarf::DW_FORM_ref4:
385 case dwarf::DW_FORM_data4:
386 case dwarf::DW_FORM_ref_sup4:
387 case dwarf::DW_FORM_strx4:
388 case dwarf::DW_FORM_addrx4:
389 case dwarf::DW_FORM_ref8:
390 case dwarf::DW_FORM_ref_sig8:
391 case dwarf::DW_FORM_data8:
392 case dwarf::DW_FORM_ref_sup8:
393 case dwarf::DW_FORM_GNU_ref_alt:
394 case dwarf::DW_FORM_GNU_strp_alt:
395 case dwarf::DW_FORM_line_strp:
396 case dwarf::DW_FORM_sec_offset:
397 case dwarf::DW_FORM_strp_sup:
398 case dwarf::DW_FORM_addr:
399 case dwarf::DW_FORM_ref_addr:
400 Asm->OutStreamer->emitIntValue(Integer,
401 sizeOf(Asm->getDwarfFormParams(), Form));
402 return;
403 case dwarf::DW_FORM_GNU_str_index:
404 case dwarf::DW_FORM_GNU_addr_index:
405 case dwarf::DW_FORM_ref_udata:
406 case dwarf::DW_FORM_strx:
407 case dwarf::DW_FORM_addrx:
408 case dwarf::DW_FORM_rnglistx:
409 case dwarf::DW_FORM_udata:
410 Asm->emitULEB128(Integer);
411 return;
412 case dwarf::DW_FORM_sdata:
413 Asm->emitSLEB128(Integer);
414 return;
415 default: llvm_unreachable("DIE Value form not supported yet");
416 }
417}
418
419/// sizeOf - Determine size of integer value in bytes.
420///
421unsigned DIEInteger::sizeOf(const dwarf::FormParams &FormParams,
422 dwarf::Form Form) const {
423 if (std::optional<uint8_t> FixedSize =
424 dwarf::getFixedFormByteSize(Form, FormParams))
425 return *FixedSize;
426
427 switch (Form) {
428 case dwarf::DW_FORM_GNU_str_index:
429 case dwarf::DW_FORM_GNU_addr_index:
430 case dwarf::DW_FORM_ref_udata:
431 case dwarf::DW_FORM_strx:
432 case dwarf::DW_FORM_addrx:
433 case dwarf::DW_FORM_rnglistx:
434 case dwarf::DW_FORM_udata:
435 return getULEB128Size(Integer);
436 case dwarf::DW_FORM_sdata:
437 return getSLEB128Size(Integer);
438 default: llvm_unreachable("DIE Value form not supported yet");
439 }
440}
441
444 O << "Int: " << (int64_t)Integer << " 0x";
445 O.write_hex(Integer);
446}
447
448//===----------------------------------------------------------------------===//
449// DIEExpr Implementation
450//===----------------------------------------------------------------------===//
451
452/// EmitValue - Emit expression value.
453///
454void DIEExpr::emitValue(const AsmPrinter *AP, dwarf::Form Form) const {
455 AP->emitDebugValue(Expr, sizeOf(AP->getDwarfFormParams(), Form));
456}
457
458/// SizeOf - Determine size of expression value in bytes.
459///
460unsigned DIEExpr::sizeOf(const dwarf::FormParams &FormParams,
461 dwarf::Form Form) const {
462 switch (Form) {
463 case dwarf::DW_FORM_data4:
464 return 4;
465 case dwarf::DW_FORM_data8:
466 return 8;
467 case dwarf::DW_FORM_sec_offset:
468 return FormParams.getDwarfOffsetByteSize();
469 default:
470 llvm_unreachable("DIE Value form not supported yet");
471 }
472}
473
476 O << "Expr: ";
477 MCAsmInfo().printExpr(O, *Expr);
478}
479
480//===----------------------------------------------------------------------===//
481// DIELabel Implementation
482//===----------------------------------------------------------------------===//
483
484/// EmitValue - Emit label value.
485///
486void DIELabel::emitValue(const AsmPrinter *AP, dwarf::Form Form) const {
487 bool IsSectionRelative = Form != dwarf::DW_FORM_addr;
488 AP->emitLabelReference(Label, sizeOf(AP->getDwarfFormParams(), Form),
489 IsSectionRelative);
490}
491
492/// sizeOf - Determine size of label value in bytes.
493///
494unsigned DIELabel::sizeOf(const dwarf::FormParams &FormParams,
495 dwarf::Form Form) const {
496 switch (Form) {
497 case dwarf::DW_FORM_data4:
498 return 4;
499 case dwarf::DW_FORM_data8:
500 return 8;
501 case dwarf::DW_FORM_sec_offset:
502 case dwarf::DW_FORM_strp:
503 return FormParams.getDwarfOffsetByteSize();
504 case dwarf::DW_FORM_addr:
505 return FormParams.AddrSize;
506 default:
507 llvm_unreachable("DIE Value form not supported yet");
508 }
509}
510
512void DIELabel::print(raw_ostream &O) const { O << "Lbl: " << Label->getName(); }
513
514//===----------------------------------------------------------------------===//
515// DIEBaseTypeRef Implementation
516//===----------------------------------------------------------------------===//
517
519 uint64_t Offset = CU->ExprRefedBaseTypes[Index].Die->getOffset();
520 assert(Offset < (1ULL << (ULEB128PadSize * 7)) && "Offset wont fit");
521 AP->emitULEB128(Offset, nullptr, ULEB128PadSize);
522}
523
525 return ULEB128PadSize;
526}
527
529void DIEBaseTypeRef::print(raw_ostream &O) const { O << "BaseTypeRef: " << Index; }
530
531//===----------------------------------------------------------------------===//
532// DIEDelta Implementation
533//===----------------------------------------------------------------------===//
534
535/// EmitValue - Emit delta value.
536///
537void DIEDelta::emitValue(const AsmPrinter *AP, dwarf::Form Form) const {
538 AP->emitLabelDifference(LabelHi, LabelLo,
539 sizeOf(AP->getDwarfFormParams(), Form));
540}
541
542/// SizeOf - Determine size of delta value in bytes.
543///
544unsigned DIEDelta::sizeOf(const dwarf::FormParams &FormParams,
545 dwarf::Form Form) const {
546 switch (Form) {
547 case dwarf::DW_FORM_data4:
548 return 4;
549 case dwarf::DW_FORM_data8:
550 return 8;
551 case dwarf::DW_FORM_sec_offset:
552 return FormParams.getDwarfOffsetByteSize();
553 default:
554 llvm_unreachable("DIE Value form not supported yet");
555 }
556}
557
560 O << "Del: " << LabelHi->getName() << "-" << LabelLo->getName();
561}
562
563//===----------------------------------------------------------------------===//
564// DIEString Implementation
565//===----------------------------------------------------------------------===//
566
567/// EmitValue - Emit string value.
568///
569void DIEString::emitValue(const AsmPrinter *AP, dwarf::Form Form) const {
570 // Index of string in symbol table.
571 switch (Form) {
572 case dwarf::DW_FORM_GNU_str_index:
573 case dwarf::DW_FORM_strx:
574 case dwarf::DW_FORM_strx1:
575 case dwarf::DW_FORM_strx2:
576 case dwarf::DW_FORM_strx3:
577 case dwarf::DW_FORM_strx4:
578 DIEInteger(S.getIndex()).emitValue(AP, Form);
579 return;
580 case dwarf::DW_FORM_strp:
582 DIELabel(S.getSymbol()).emitValue(AP, Form);
583 else
584 DIEInteger(S.getOffset()).emitValue(AP, Form);
585 return;
586 default:
587 llvm_unreachable("Expected valid string form");
588 }
589}
590
591/// sizeOf - Determine size of delta value in bytes.
592///
593unsigned DIEString::sizeOf(const dwarf::FormParams &FormParams,
594 dwarf::Form Form) const {
595 // Index of string in symbol table.
596 switch (Form) {
597 case dwarf::DW_FORM_GNU_str_index:
598 case dwarf::DW_FORM_strx:
599 case dwarf::DW_FORM_strx1:
600 case dwarf::DW_FORM_strx2:
601 case dwarf::DW_FORM_strx3:
602 case dwarf::DW_FORM_strx4:
603 return DIEInteger(S.getIndex()).sizeOf(FormParams, Form);
604 case dwarf::DW_FORM_strp:
606 return DIELabel(S.getSymbol()).sizeOf(FormParams, Form);
607 return DIEInteger(S.getOffset()).sizeOf(FormParams, Form);
608 default:
609 llvm_unreachable("Expected valid string form");
610 }
611}
612
615 O << "String: " << S.getString();
616}
617
618//===----------------------------------------------------------------------===//
619// DIEInlineString Implementation
620//===----------------------------------------------------------------------===//
622 if (Form == dwarf::DW_FORM_string) {
623 AP->OutStreamer->emitBytes(S);
624 AP->emitInt8(0);
625 return;
626 }
627 llvm_unreachable("Expected valid string form");
628}
629
631 // Emit string bytes + NULL byte.
632 return S.size() + 1;
633}
634
637 O << "InlineString: " << S;
638}
639
640//===----------------------------------------------------------------------===//
641// DIEEntry Implementation
642//===----------------------------------------------------------------------===//
643
644/// EmitValue - Emit debug information entry offset.
645///
646void DIEEntry::emitValue(const AsmPrinter *AP, dwarf::Form Form) const {
647
648 switch (Form) {
649 case dwarf::DW_FORM_ref1:
650 case dwarf::DW_FORM_ref2:
651 case dwarf::DW_FORM_ref4:
652 case dwarf::DW_FORM_ref8:
653 AP->OutStreamer->emitIntValue(Entry->getOffset(),
654 sizeOf(AP->getDwarfFormParams(), Form));
655 return;
656
657 case dwarf::DW_FORM_ref_udata:
658 AP->emitULEB128(Entry->getOffset());
659 return;
660
661 case dwarf::DW_FORM_ref_addr: {
662 // Get the absolute offset for this DIE within the debug info/types section.
664 if (const MCSymbol *SectionSym =
666 AP->emitLabelPlusOffset(SectionSym, Addr,
667 sizeOf(AP->getDwarfFormParams(), Form), true);
668 return;
669 }
670
671 AP->OutStreamer->emitIntValue(Addr, sizeOf(AP->getDwarfFormParams(), Form));
672 return;
673 }
674 default:
675 llvm_unreachable("Improper form for DIE reference");
676 }
677}
678
679unsigned DIEEntry::sizeOf(const dwarf::FormParams &FormParams,
680 dwarf::Form Form) const {
681 switch (Form) {
682 case dwarf::DW_FORM_ref1:
683 return 1;
684 case dwarf::DW_FORM_ref2:
685 return 2;
686 case dwarf::DW_FORM_ref4:
687 return 4;
688 case dwarf::DW_FORM_ref8:
689 return 8;
690 case dwarf::DW_FORM_ref_udata:
691 return getULEB128Size(Entry->getOffset());
692 case dwarf::DW_FORM_ref_addr:
693 return FormParams.getRefAddrByteSize();
694
695 default:
696 llvm_unreachable("Improper form for DIE reference");
697 }
698}
699
702 O << format("Die: 0x%lx", (long)(intptr_t)&Entry);
703}
704
705//===----------------------------------------------------------------------===//
706// DIELoc Implementation
707//===----------------------------------------------------------------------===//
708
709unsigned DIELoc::computeSize(const dwarf::FormParams &FormParams) const {
710 if (!Size) {
711 for (const auto &V : values())
712 Size += V.sizeOf(FormParams);
713 }
714
715 return Size;
716}
717
718/// EmitValue - Emit location data.
719///
720void DIELoc::emitValue(const AsmPrinter *Asm, dwarf::Form Form) const {
721 switch (Form) {
722 default: llvm_unreachable("Improper form for block");
723 case dwarf::DW_FORM_block1: Asm->emitInt8(Size); break;
724 case dwarf::DW_FORM_block2: Asm->emitInt16(Size); break;
725 case dwarf::DW_FORM_block4: Asm->emitInt32(Size); break;
726 case dwarf::DW_FORM_block:
727 case dwarf::DW_FORM_exprloc:
728 Asm->emitULEB128(Size);
729 break;
730 }
731
732 for (const auto &V : values())
733 V.emitValue(Asm);
734}
735
736/// sizeOf - Determine size of location data in bytes.
737///
738unsigned DIELoc::sizeOf(const dwarf::FormParams &, dwarf::Form Form) const {
739 switch (Form) {
740 case dwarf::DW_FORM_block1: return Size + sizeof(int8_t);
741 case dwarf::DW_FORM_block2: return Size + sizeof(int16_t);
742 case dwarf::DW_FORM_block4: return Size + sizeof(int32_t);
743 case dwarf::DW_FORM_block:
744 case dwarf::DW_FORM_exprloc:
745 return Size + getULEB128Size(Size);
746 default: llvm_unreachable("Improper form for block");
747 }
748}
749
752 printValues(O, *this, "ExprLoc", Size, 5);
753}
754
755//===----------------------------------------------------------------------===//
756// DIEBlock Implementation
757//===----------------------------------------------------------------------===//
758
759unsigned DIEBlock::computeSize(const dwarf::FormParams &FormParams) const {
760 if (!Size) {
761 for (const auto &V : values())
762 Size += V.sizeOf(FormParams);
763 }
764
765 return Size;
766}
767
768/// EmitValue - Emit block data.
769///
770void DIEBlock::emitValue(const AsmPrinter *Asm, dwarf::Form Form) const {
771 switch (Form) {
772 default: llvm_unreachable("Improper form for block");
773 case dwarf::DW_FORM_block1: Asm->emitInt8(Size); break;
774 case dwarf::DW_FORM_block2: Asm->emitInt16(Size); break;
775 case dwarf::DW_FORM_block4: Asm->emitInt32(Size); break;
776 case dwarf::DW_FORM_exprloc:
777 case dwarf::DW_FORM_block:
778 Asm->emitULEB128(Size);
779 break;
780 case dwarf::DW_FORM_string: break;
781 case dwarf::DW_FORM_data16: break;
782 }
783
784 for (const auto &V : values())
785 V.emitValue(Asm);
786}
787
788/// sizeOf - Determine size of block data in bytes.
789///
790unsigned DIEBlock::sizeOf(const dwarf::FormParams &, dwarf::Form Form) const {
791 switch (Form) {
792 case dwarf::DW_FORM_block1: return Size + sizeof(int8_t);
793 case dwarf::DW_FORM_block2: return Size + sizeof(int16_t);
794 case dwarf::DW_FORM_block4: return Size + sizeof(int32_t);
795 case dwarf::DW_FORM_exprloc:
796 case dwarf::DW_FORM_block: return Size + getULEB128Size(Size);
797 case dwarf::DW_FORM_data16: return 16;
798 default: llvm_unreachable("Improper form for block");
799 }
800}
801
804 printValues(O, *this, "Blk", Size, 5);
805}
806
807//===----------------------------------------------------------------------===//
808// DIELocList Implementation
809//===----------------------------------------------------------------------===//
810
811unsigned DIELocList::sizeOf(const dwarf::FormParams &FormParams,
812 dwarf::Form Form) const {
813 switch (Form) {
814 case dwarf::DW_FORM_loclistx:
815 return getULEB128Size(Index);
816 case dwarf::DW_FORM_data4:
817 assert(FormParams.Format != dwarf::DWARF64 &&
818 "DW_FORM_data4 is not suitable to emit a pointer to a location list "
819 "in the 64-bit DWARF format");
820 return 4;
821 case dwarf::DW_FORM_data8:
822 assert(FormParams.Format == dwarf::DWARF64 &&
823 "DW_FORM_data8 is not suitable to emit a pointer to a location list "
824 "in the 32-bit DWARF format");
825 return 8;
826 case dwarf::DW_FORM_sec_offset:
827 return FormParams.getDwarfOffsetByteSize();
828 default:
829 llvm_unreachable("DIE Value form not supported yet");
830 }
831}
832
833/// EmitValue - Emit label value.
834///
835void DIELocList::emitValue(const AsmPrinter *AP, dwarf::Form Form) const {
836 if (Form == dwarf::DW_FORM_loclistx) {
837 AP->emitULEB128(Index);
838 return;
839 }
840 DwarfDebug *DD = AP->getDwarfDebug();
841 MCSymbol *Label = DD->getDebugLocs().getList(Index).Label;
842 AP->emitDwarfSymbolReference(Label, /*ForceOffset*/ DD->useSplitDwarf());
843}
844
846void DIELocList::print(raw_ostream &O) const { O << "LocList: " << Index; }
847
848//===----------------------------------------------------------------------===//
849// DIEAddrOffset Implementation
850//===----------------------------------------------------------------------===//
851
852unsigned DIEAddrOffset::sizeOf(const dwarf::FormParams &FormParams,
853 dwarf::Form) const {
854 return Addr.sizeOf(FormParams, dwarf::DW_FORM_addrx) +
855 Offset.sizeOf(FormParams, dwarf::DW_FORM_data4);
856}
857
858/// EmitValue - Emit label value.
859///
861 Addr.emitValue(AP, dwarf::DW_FORM_addrx);
862 Offset.emitValue(AP, dwarf::DW_FORM_data4);
863}
864
867 O << "AddrOffset: ";
868 Addr.print(O);
869 O << " + ";
870 Offset.print(O);
871}
assert(UImm &&(UImm !=~static_cast< T >(0)) &&"Invalid immediate!")
static GCRegistry::Add< StatepointGC > D("statepoint-example", "an example strategy for statepoint")
#define LLVM_DUMP_METHOD
Mark debug helper function definitions like dump() that should not be stripped from debug builds.
Definition: Compiler.h:638
static LLVM_DUMP_METHOD void printValues(raw_ostream &O, const DIEValueList &Values, StringRef Type, unsigned Size, unsigned IndentCount)
Definition: DIE.cpp:220
uint64_t Addr
uint64_t Size
#define I(x, y, z)
Definition: MD5.cpp:58
static Split data
#define LLVM_DEBUG(...)
Definition: Debug.h:119
This class is intended to be used as a driving class for all asm writers.
Definition: AsmPrinter.h:90
void emitULEB128(uint64_t Value, const char *Desc=nullptr, unsigned PadTo=0) const
Emit the specified unsigned leb128 value.
void emitDwarfSymbolReference(const MCSymbol *Label, bool ForceOffset=false) const
Emit a reference to a symbol for use in dwarf.
virtual void emitDebugValue(const MCExpr *Value, unsigned Size) const
Emit the directive and value for debug thread local expression.
Definition: AsmPrinter.cpp:925
DwarfDebug * getDwarfDebug()
Definition: AsmPrinter.h:287
void emitLabelPlusOffset(const MCSymbol *Label, uint64_t Offset, unsigned Size, bool IsSectionRelative=false) const
Emit something like ".long Label+Offset" where the size in bytes of the directive is specified by Siz...
void emitLabelDifference(const MCSymbol *Hi, const MCSymbol *Lo, unsigned Size) const
Emit something like ".long Hi-Lo" where the size in bytes of the directive is specified by Size and H...
void emitInt8(int Value) const
Emit a byte directive and value.
void emitDwarfAbbrevs(const T &Abbrevs) const
Emit Dwarf abbreviation table.
Definition: AsmPrinter.h:840
void emitSLEB128(int64_t Value, const char *Desc=nullptr) const
Emit the specified signed leb128 value.
std::unique_ptr< MCStreamer > OutStreamer
This is the MCStreamer object for the file we are generating.
Definition: AsmPrinter.h:105
void emitLabelReference(const MCSymbol *Label, unsigned Size, bool IsSectionRelative=false) const
Emit something like ".long Label" where the size in bytes of the directive is specified by Size and L...
Definition: AsmPrinter.h:760
uint16_t getDwarfVersion() const
dwarf::FormParams getDwarfFormParams() const
Returns information about the byte size of DW_FORM values.
bool doesDwarfUseRelocationsAcrossSections() const
Definition: AsmPrinter.h:376
Dwarf abbreviation data, describes one attribute of a Dwarf abbreviation.
Definition: DIE.h:50
LLVM_ABI void Profile(FoldingSetNodeID &ID) const
Used to gather unique data for the abbreviation folding set.
Definition: DIE.cpp:36
Helps unique DIEAbbrev objects and assigns abbreviation numbers.
Definition: DIE.h:141
LLVM_ABI ~DIEAbbrevSet()
Definition: DIE.cpp:131
LLVM_ABI void Emit(const AsmPrinter *AP, MCSection *Section) const
Print all abbreviations using the specified asm printer.
Definition: DIE.cpp:160
LLVM_ABI DIEAbbrev & uniqueAbbreviation(DIE &Die)
Generate the abbreviation declaration for a DIE and return a pointer to the generated abbreviation.
Definition: DIE.cpp:136
Dwarf abbreviation, describes the organization of a debug information object.
Definition: DIE.h:80
LLVM_ABI void print(raw_ostream &O) const
Definition: DIE.cpp:101
void AddImplicitConstAttribute(dwarf::Attribute Attribute, int64_t Value)
Adds attribute with DW_FORM_implicit_const value.
Definition: DIE.h:115
LLVM_ABI void Emit(const AsmPrinter *AP) const
Print the abbreviation using the specified asm printer.
Definition: DIE.cpp:62
void AddAttribute(dwarf::Attribute Attribute, dwarf::Form Form)
Adds another set of attribute information to the abbreviation.
Definition: DIE.h:110
LLVM_ABI void dump() const
Definition: DIE.cpp:122
LLVM_ABI void Profile(FoldingSetNodeID &ID) const
Used to gather unique data for the abbreviation folding set.
Definition: DIE.cpp:51
bool hasChildren() const
Definition: DIE.h:103
LLVM_ABI void print(raw_ostream &O) const
Definition: DIE.cpp:866
LLVM_ABI unsigned sizeOf(const dwarf::FormParams &FormParams, dwarf::Form Form) const
Definition: DIE.cpp:852
LLVM_ABI void emitValue(const AsmPrinter *AP, dwarf::Form Form) const
EmitValue - Emit label value.
Definition: DIE.cpp:860
LLVM_ABI void emitValue(const AsmPrinter *AP, dwarf::Form Form) const
EmitValue - Emit base type reference.
Definition: DIE.cpp:518
LLVM_ABI void print(raw_ostream &O) const
Definition: DIE.cpp:529
LLVM_ABI unsigned sizeOf(const dwarf::FormParams &, dwarf::Form) const
sizeOf - Determine size of the base type reference in bytes.
Definition: DIE.cpp:524
LLVM_ABI unsigned sizeOf(const dwarf::FormParams &, dwarf::Form Form) const
sizeOf - Determine size of block data in bytes.
Definition: DIE.cpp:790
LLVM_ABI void print(raw_ostream &O) const
Definition: DIE.cpp:803
LLVM_ABI void emitValue(const AsmPrinter *Asm, dwarf::Form Form) const
EmitValue - Emit block data.
Definition: DIE.cpp:770
LLVM_ABI unsigned computeSize(const dwarf::FormParams &FormParams) const
Calculate the size of the location expression.
Definition: DIE.cpp:759
LLVM_ABI void print(raw_ostream &O) const
Definition: DIE.cpp:559
LLVM_ABI unsigned sizeOf(const dwarf::FormParams &FormParams, dwarf::Form Form) const
SizeOf - Determine size of delta value in bytes.
Definition: DIE.cpp:544
LLVM_ABI void emitValue(const AsmPrinter *AP, dwarf::Form Form) const
EmitValue - Emit delta value.
Definition: DIE.cpp:537
LLVM_ABI void emitValue(const AsmPrinter *AP, dwarf::Form Form) const
EmitValue - Emit debug information entry offset.
Definition: DIE.cpp:646
LLVM_ABI void print(raw_ostream &O) const
Definition: DIE.cpp:701
LLVM_ABI unsigned sizeOf(const dwarf::FormParams &FormParams, dwarf::Form Form) const
Definition: DIE.cpp:679
LLVM_ABI void print(raw_ostream &O) const
Definition: DIE.cpp:475
LLVM_ABI void emitValue(const AsmPrinter *AP, dwarf::Form Form) const
EmitValue - Emit expression value.
Definition: DIE.cpp:454
LLVM_ABI unsigned sizeOf(const dwarf::FormParams &FormParams, dwarf::Form Form) const
SizeOf - Determine size of expression value in bytes.
Definition: DIE.cpp:460
LLVM_ABI void emitValue(const AsmPrinter *AP, dwarf::Form Form) const
Definition: DIE.cpp:621
LLVM_ABI void print(raw_ostream &O) const
Definition: DIE.cpp:636
LLVM_ABI unsigned sizeOf(const dwarf::FormParams &, dwarf::Form) const
Definition: DIE.cpp:630
An integer value DIE.
Definition: DIE.h:169
LLVM_ABI unsigned sizeOf(const dwarf::FormParams &FormParams, dwarf::Form Form) const
sizeOf - Determine size of integer value in bytes.
Definition: DIE.cpp:421
LLVM_ABI void print(raw_ostream &O) const
Definition: DIE.cpp:443
LLVM_ABI void emitValue(const AsmPrinter *Asm, dwarf::Form Form) const
EmitValue - Emit integer of appropriate size.
Definition: DIE.cpp:364
A label DIE.
Definition: DIE.h:226
LLVM_ABI void emitValue(const AsmPrinter *AP, dwarf::Form Form) const
EmitValue - Emit label value.
Definition: DIE.cpp:486
LLVM_ABI void print(raw_ostream &O) const
Definition: DIE.cpp:512
LLVM_ABI unsigned sizeOf(const dwarf::FormParams &FormParams, dwarf::Form Form) const
sizeOf - Determine size of label value in bytes.
Definition: DIE.cpp:494
LLVM_ABI void print(raw_ostream &O) const
Definition: DIE.cpp:846
LLVM_ABI unsigned sizeOf(const dwarf::FormParams &FormParams, dwarf::Form Form) const
Definition: DIE.cpp:811
LLVM_ABI void emitValue(const AsmPrinter *AP, dwarf::Form Form) const
EmitValue - Emit label value.
Definition: DIE.cpp:835
LLVM_ABI void print(raw_ostream &O) const
Definition: DIE.cpp:751
LLVM_ABI unsigned sizeOf(const dwarf::FormParams &, dwarf::Form Form) const
sizeOf - Determine size of location data in bytes.
Definition: DIE.cpp:738
LLVM_ABI void emitValue(const AsmPrinter *Asm, dwarf::Form Form) const
EmitValue - Emit location data.
Definition: DIE.cpp:720
LLVM_ABI unsigned computeSize(const dwarf::FormParams &FormParams) const
Calculate the size of the location expression.
Definition: DIE.cpp:709
LLVM_ABI void emitValue(const AsmPrinter *AP, dwarf::Form Form) const
EmitValue - Emit string value.
Definition: DIE.cpp:569
LLVM_ABI void print(raw_ostream &O) const
Definition: DIE.cpp:614
LLVM_ABI unsigned sizeOf(const dwarf::FormParams &FormParams, dwarf::Form Form) const
sizeOf - Determine size of delta value in bytes.
Definition: DIE.cpp:593
Represents a compile or type unit.
Definition: DIE.h:970
virtual const MCSymbol * getCrossSectionRelativeBaseAddress() const
Definition: DIE.h:999
LLVM_ABI DIEUnit(dwarf::Tag UnitTag)
Definition: DIE.cpp:306
A list of DIE values.
Definition: DIE.h:698
value_range values()
Definition: DIE.h:816
LLVM_ABI void print(raw_ostream &O) const
Definition: DIE.cpp:340
LLVM_ABI void emitValue(const AsmPrinter *AP) const
Emit value via the Dwarf writer.
Definition: DIE.cpp:315
LLVM_ABI unsigned sizeOf(const dwarf::FormParams &FormParams) const
Return the size of a value in bytes.
Definition: DIE.cpp:327
LLVM_ABI void dump() const
Definition: DIE.cpp:353
A structured debug information entry.
Definition: DIE.h:828
LLVM_ABI DIEValue findAttribute(dwarf::Attribute Attribute) const
Find a value in the DIE with the attribute given.
Definition: DIE.cpp:210
LLVM_ABI void print(raw_ostream &O, unsigned IndentCount=0) const
Definition: DIE.cpp:236
unsigned getAbbrevNumber() const
Definition: DIE.h:863
LLVM_ABI DIEAbbrev generateAbbrev() const
Generate the abbreviation for this DIE.
Definition: DIE.cpp:174
LLVM_ABI unsigned computeOffsetsAndAbbrevs(const dwarf::FormParams &FormParams, DIEAbbrevSet &AbbrevSet, unsigned CUOffset)
Compute the offset of this DIE and all its children.
Definition: DIE.cpp:266
void setSize(unsigned S)
Definition: DIE.h:941
LLVM_ABI DIEUnit * getUnit() const
Climb up the parent chain to get the compile unit or type unit that this DIE belongs to.
Definition: DIE.cpp:203
child_range children()
Definition: DIE.h:884
LLVM_ABI const DIE * getUnitDie() const
Climb up the parent chain to get the compile unit or type unit DIE that this DIE belongs to.
Definition: DIE.cpp:191
void setAbbrevNumber(unsigned I)
Set the abbreviation number for this DIE.
Definition: DIE.h:900
unsigned getOffset() const
Get the compile/type unit relative offset of this DIE.
Definition: DIE.h:866
void setOffset(unsigned O)
Definition: DIE.h:940
bool hasChildren() const
Definition: DIE.h:876
LLVM_ABI uint64_t getDebugSectionOffset() const
Get the absolute offset within the .debug_info or .debug_types section for this DIE.
Definition: DIE.cpp:185
dwarf::Tag getTag() const
Definition: DIE.h:864
LLVM_ABI void dump() const
Definition: DIE.cpp:261
LLVM_ABI DIE * getParent() const
Definition: DIE.cpp:172
const List & getList(size_t LI) const
Collects and handles dwarf debug information.
Definition: DwarfDebug.h:351
const DebugLocStream & getDebugLocs() const
Returns the entries for the .debug_loc section.
Definition: DwarfDebug.h:863
bool useSplitDwarf() const
Returns whether or not to change the current debug info for the split dwarf proposal support.
Definition: DwarfDebug.h:824
FoldingSetNodeID - This class is used to gather all the unique data bits of a node.
Definition: FoldingSet.h:330
This class is intended to be used as a base class for asm properties and features specific to the tar...
Definition: MCAsmInfo.h:64
void printExpr(raw_ostream &, const MCExpr &) const
Definition: MCAsmInfo.cpp:153
Instances of this class represent a uniqued identifier for a section in the current translation unit.
Definition: MCSection.h:496
MCSymbol - Instances of this class represent a symbol name in the MC file, and MCSymbols are created ...
Definition: MCSymbol.h:42
StringRef getName() const
getName - Get the symbol name.
Definition: MCSymbol.h:188
StringRef - Represent a constant reference to a string, i.e.
Definition: StringRef.h:55
constexpr size_t size() const
size - Get the string size.
Definition: StringRef.h:154
constexpr const char * data() const
data - Get a pointer to the start of the string (which may not be null terminated).
Definition: StringRef.h:148
The instances of the Type class are immutable: once they are created, they are never changed.
Definition: Type.h:45
LLVM Value Representation.
Definition: Value.h:75
This class implements an extremely fast bulk output stream that can only output to a stream.
Definition: raw_ostream.h:53
LLVM_ABI StringRef AttributeString(unsigned Attribute)
Definition: Dwarf.cpp:72
LLVM_ABI StringRef FormEncodingString(unsigned Encoding)
Definition: Dwarf.cpp:105
LLVM_ABI StringRef ChildrenString(unsigned Children)
Definition: Dwarf.cpp:62
LLVM_ABI StringRef TagString(unsigned Tag)
Definition: Dwarf.cpp:21
#define llvm_unreachable(msg)
Marks that the current location is not supposed to be reachable.
unsigned ID
LLVM IR allows to use arbitrary numbers as calling convention identifiers.
Definition: CallingConv.h:24
Attribute
Attributes.
Definition: Dwarf.h:124
@ DWARF64
Definition: Dwarf.h:92
LLVM_ABI bool isValidFormForVersion(Form F, unsigned Version, bool ExtensionsOk=true)
Tells whether the specified form is defined in the specified version, or is an extension if extension...
Definition: Dwarf.cpp:880
LLVM_ABI std::optional< uint8_t > getFixedFormByteSize(dwarf::Form Form, FormParams Params)
Get the fixed byte size for a given form.
Definition: Dwarf.cpp:792
This is an optimization pass for GlobalISel generic memory operations.
Definition: AddressRanges.h:18
@ Offset
Definition: DWP.cpp:477
LLVM_ABI raw_ostream & dbgs()
dbgs() - This returns a reference to a raw_ostream for debugging messages.
Definition: Debug.cpp:207
format_object< Ts... > format(const char *Fmt, const Ts &... Vals)
These are helper functions used to produce formatted output.
Definition: Format.h:126
LLVM_ABI unsigned getULEB128Size(uint64_t Value)
Utility function to get the size of the ULEB128-encoded value.
Definition: LEB128.cpp:19
LLVM_ABI unsigned getSLEB128Size(int64_t Value)
Utility function to get the size of the SLEB128-encoded value.
Definition: LEB128.cpp:29
A helper struct providing information about the byte size of DW_FORM values that vary in size dependi...
Definition: Dwarf.h:1093
bool DwarfUsesRelocationsAcrossSections
True if DWARF v2 output generally uses relocations for references to other .debug_* sections.
Definition: Dwarf.h:1099
DwarfFormat Format
Definition: Dwarf.h:1096
uint8_t getDwarfOffsetByteSize() const
The size of a reference is determined by the DWARF 32/64-bit format.
Definition: Dwarf.h:1111
uint8_t getRefAddrByteSize() const
The definition of the size of form DW_FORM_ref_addr depends on the version.
Definition: Dwarf.h:1104