contrib/llvm/include/llvm/DebugInfo/DWARF/DWARFObject.h

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