1 //===- DWARFObject.h --------------------------------------------*- C++ -*-===// 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 #ifndef LLVM_DEBUGINFO_DWARF_DWARFOBJECT_H 11 #define LLVM_DEBUGINFO_DWARF_DWARFOBJECT_H 12 13 #include "llvm/DebugInfo/DWARF/DWARFRelocMap.h" 14 #include "llvm/DebugInfo/DWARF/DWARFSection.h" 15 #include "llvm/Object/ObjectFile.h" 16 17 namespace llvm { 18 // This is responsible for low level access to the object file. It 19 // knows how to find the required sections and compute relocated 20 // values. 21 // The default implementations of the get<Section> methods return dummy values. 22 // This is to allow clients that only need some of those to implement just the 23 // ones they need. We can't use unreachable for as many cases because the parser 24 // implementation is eager and will call some of these methods even if the 25 // result is not used. 26 class DWARFObject { 27 DWARFSection Dummy; 28 29 public: 30 virtual ~DWARFObject() = default; getFileName()31 virtual StringRef getFileName() const { llvm_unreachable("unimplemented"); } getFile()32 virtual const object::ObjectFile *getFile() const { return nullptr; } getSectionNames()33 virtual ArrayRef<SectionName> getSectionNames() const { return {}; } 34 virtual bool isLittleEndian() const = 0; getAddressSize()35 virtual uint8_t getAddressSize() const { llvm_unreachable("unimplemented"); } getInfoSection()36 virtual const DWARFSection &getInfoSection() const { return Dummy; } 37 virtual void forEachTypesSections(function_ref<void (const DWARFSection &)> F)38 forEachTypesSections(function_ref<void(const DWARFSection &)> F) const {} getAbbrevSection()39 virtual StringRef getAbbrevSection() const { return ""; } getLocSection()40 virtual const DWARFSection &getLocSection() const { return Dummy; } getARangeSection()41 virtual StringRef getARangeSection() const { return ""; } getDebugFrameSection()42 virtual StringRef getDebugFrameSection() const { return ""; } getEHFrameSection()43 virtual StringRef getEHFrameSection() const { return ""; } getLineSection()44 virtual const DWARFSection &getLineSection() const { return Dummy; } getLineStringSection()45 virtual StringRef getLineStringSection() const { return ""; } getStringSection()46 virtual StringRef getStringSection() const { return ""; } getRangeSection()47 virtual const DWARFSection &getRangeSection() const { return Dummy; } getRnglistsSection()48 virtual const DWARFSection &getRnglistsSection() const { return Dummy; } getMacinfoSection()49 virtual StringRef getMacinfoSection() const { return ""; } getPubNamesSection()50 virtual StringRef getPubNamesSection() const { return ""; } getPubTypesSection()51 virtual StringRef getPubTypesSection() const { return ""; } getGnuPubNamesSection()52 virtual StringRef getGnuPubNamesSection() const { return ""; } getGnuPubTypesSection()53 virtual StringRef getGnuPubTypesSection() const { return ""; } getStringOffsetSection()54 virtual const DWARFSection &getStringOffsetSection() const { return Dummy; } getInfoDWOSection()55 virtual const DWARFSection &getInfoDWOSection() const { return Dummy; } 56 virtual void forEachTypesDWOSections(function_ref<void (const DWARFSection &)> F)57 forEachTypesDWOSections(function_ref<void(const DWARFSection &)> F) const {} getAbbrevDWOSection()58 virtual StringRef getAbbrevDWOSection() const { return ""; } getLineDWOSection()59 virtual const DWARFSection &getLineDWOSection() const { return Dummy; } getLocDWOSection()60 virtual const DWARFSection &getLocDWOSection() const { return Dummy; } getStringDWOSection()61 virtual StringRef getStringDWOSection() const { return ""; } getStringOffsetDWOSection()62 virtual const DWARFSection &getStringOffsetDWOSection() const { 63 return Dummy; 64 } getRangeDWOSection()65 virtual const DWARFSection &getRangeDWOSection() const { return Dummy; } getRnglistsDWOSection()66 virtual const DWARFSection &getRnglistsDWOSection() const { return Dummy; } getAddrSection()67 virtual const DWARFSection &getAddrSection() const { return Dummy; } getAppleNamesSection()68 virtual const DWARFSection &getAppleNamesSection() const { return Dummy; } getAppleTypesSection()69 virtual const DWARFSection &getAppleTypesSection() const { return Dummy; } getAppleNamespacesSection()70 virtual const DWARFSection &getAppleNamespacesSection() const { 71 return Dummy; 72 } getDebugNamesSection()73 virtual const DWARFSection &getDebugNamesSection() const { return Dummy; } getAppleObjCSection()74 virtual const DWARFSection &getAppleObjCSection() const { return Dummy; } getCUIndexSection()75 virtual StringRef getCUIndexSection() const { return ""; } getGdbIndexSection()76 virtual StringRef getGdbIndexSection() const { return ""; } getTUIndexSection()77 virtual StringRef getTUIndexSection() const { return ""; } 78 virtual Optional<RelocAddrEntry> find(const DWARFSection &Sec, 79 uint64_t Pos) const = 0; 80 }; 81 82 } // namespace llvm 83 #endif 84