Home | History | Annotate | Download | only in DWARF
      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;
     31   virtual StringRef getFileName() const { llvm_unreachable("unimplemented"); }
     32   virtual const object::ObjectFile *getFile() const { return nullptr; }
     33   virtual ArrayRef<SectionName> getSectionNames() const { return {}; }
     34   virtual bool isLittleEndian() const = 0;
     35   virtual uint8_t getAddressSize() const { llvm_unreachable("unimplemented"); }
     36   virtual const DWARFSection &getInfoSection() const { return Dummy; }
     37   virtual void
     38   forEachTypesSections(function_ref<void(const DWARFSection &)> F) const {}
     39   virtual StringRef getAbbrevSection() const { return ""; }
     40   virtual const DWARFSection &getLocSection() const { return Dummy; }
     41   virtual StringRef getARangeSection() const { return ""; }
     42   virtual StringRef getDebugFrameSection() const { return ""; }
     43   virtual StringRef getEHFrameSection() const { return ""; }
     44   virtual const DWARFSection &getLineSection() const { return Dummy; }
     45   virtual StringRef getLineStringSection() const { return ""; }
     46   virtual StringRef getStringSection() const { return ""; }
     47   virtual const DWARFSection &getRangeSection() const { return Dummy; }
     48   virtual const DWARFSection &getRnglistsSection() const { return Dummy; }
     49   virtual StringRef getMacinfoSection() const { return ""; }
     50   virtual StringRef getPubNamesSection() const { return ""; }
     51   virtual StringRef getPubTypesSection() const { return ""; }
     52   virtual StringRef getGnuPubNamesSection() const { return ""; }
     53   virtual StringRef getGnuPubTypesSection() const { return ""; }
     54   virtual const DWARFSection &getStringOffsetSection() const { return Dummy; }
     55   virtual const DWARFSection &getInfoDWOSection() const { return Dummy; }
     56   virtual void
     57   forEachTypesDWOSections(function_ref<void(const DWARFSection &)> F) const {}
     58   virtual StringRef getAbbrevDWOSection() const { return ""; }
     59   virtual const DWARFSection &getLineDWOSection() const { return Dummy; }
     60   virtual const DWARFSection &getLocDWOSection() const { return Dummy; }
     61   virtual StringRef getStringDWOSection() const { return ""; }
     62   virtual const DWARFSection &getStringOffsetDWOSection() const {
     63     return Dummy;
     64   }
     65   virtual const DWARFSection &getRangeDWOSection() const { return Dummy; }
     66   virtual const DWARFSection &getRnglistsDWOSection() const { return Dummy; }
     67   virtual const DWARFSection &getAddrSection() const { return Dummy; }
     68   virtual const DWARFSection &getAppleNamesSection() const { return Dummy; }
     69   virtual const DWARFSection &getAppleTypesSection() const { return Dummy; }
     70   virtual const DWARFSection &getAppleNamespacesSection() const {
     71     return Dummy;
     72   }
     73   virtual const DWARFSection &getDebugNamesSection() const { return Dummy; }
     74   virtual const DWARFSection &getAppleObjCSection() const { return Dummy; }
     75   virtual StringRef getCUIndexSection() const { return ""; }
     76   virtual StringRef getGdbIndexSection() const { return ""; }
     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