1 //===- DWARFDebugRangeList.h ------------------------------------*- 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_DEBUGINFO_DWARF_DWARFDEBUGRANGELIST_H
11 #define LLVM_DEBUGINFO_DWARF_DWARFDEBUGRANGELIST_H
13 #include "llvm/DebugInfo/DWARF/DWARFAddressRange.h"
14 #include "llvm/DebugInfo/DWARF/DWARFDataExtractor.h"
23 class DWARFDebugRangeList {
25 struct RangeListEntry {
26 /// A beginning address offset. This address offset has the size of an
27 /// address and is relative to the applicable base address of the
28 /// compilation unit referencing this range list. It marks the beginning
29 /// of an address range.
30 uint64_t StartAddress;
31 /// An ending address offset. This address offset again has the size of
32 /// an address and is relative to the applicable base address of the
33 /// compilation unit referencing this range list. It marks the first
34 /// address past the end of the address range. The ending address must
35 /// be greater than or equal to the beginning address.
37 /// A section index this range belongs to.
38 uint64_t SectionIndex;
40 /// The end of any given range list is marked by an end of list entry,
41 /// which consists of a 0 for the beginning address offset
42 /// and a 0 for the ending address offset.
43 bool isEndOfListEntry() const {
44 return (StartAddress == 0) && (EndAddress == 0);
47 /// A base address selection entry consists of:
48 /// 1. The value of the largest representable address offset
49 /// (for example, 0xffffffff when the size of an address is 32 bits).
50 /// 2. An address, which defines the appropriate base address for
51 /// use in interpreting the beginning and ending address offsets of
52 /// subsequent entries of the location list.
53 bool isBaseAddressSelectionEntry(uint8_t AddressSize) const {
54 assert(AddressSize == 4 || AddressSize == 8);
56 return StartAddress == -1U;
58 return StartAddress == -1ULL;
63 /// Offset in .debug_ranges section.
66 std::vector<RangeListEntry> Entries;
69 DWARFDebugRangeList() { clear(); }
72 void dump(raw_ostream &OS) const;
73 Error extract(const DWARFDataExtractor &data, uint32_t *offset_ptr);
74 const std::vector<RangeListEntry> &getEntries() { return Entries; }
76 /// getAbsoluteRanges - Returns absolute address ranges defined by this range
77 /// list. Has to be passed base address of the compile unit referencing this
79 DWARFAddressRangesVector
80 getAbsoluteRanges(llvm::Optional<SectionedAddress> BaseAddr) const;
83 } // end namespace llvm
85 #endif // LLVM_DEBUGINFO_DWARF_DWARFDEBUGRANGELIST_H