lib/DebugInfo/Symbolize/SymbolizableObjectFile.h

   1 //===-- SymbolizableObjectFile.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 // This file declares the SymbolizableObjectFile class.
  11 //
  12 //===----------------------------------------------------------------------===//
  13 #ifndef LLVM_LIB_DEBUGINFO_SYMBOLIZE_SYMBOLIZABLEOBJECTFILE_H
  14 #define LLVM_LIB_DEBUGINFO_SYMBOLIZE_SYMBOLIZABLEOBJECTFILE_H
  15
  16 #include "llvm/DebugInfo/Symbolize/SymbolizableModule.h"
  17 #include <map>
  18
  19 namespace llvm {
  20 class DataExtractor;
  21 }
  22
  23 namespace llvm {
  24 namespace symbolize {
  25
  26 class SymbolizableObjectFile : public SymbolizableModule {
  27 public:
  28   static ErrorOr<std::unique_ptr<SymbolizableObjectFile>>
  29   create(object::ObjectFile *Obj, std::unique_ptr<DIContext> DICtx);
  30
  31   DILineInfo symbolizeCode(uint64_t ModuleOffset, FunctionNameKind FNKind,
  32                            bool UseSymbolTable) const override;
  33   DIInliningInfo symbolizeInlinedCode(uint64_t ModuleOffset,
  34                                       FunctionNameKind FNKind,
  35                                       bool UseSymbolTable) const override;
  36   DIGlobal symbolizeData(uint64_t ModuleOffset) const override;
  37
  38   // Return true if this is a 32-bit x86 PE COFF module.
  39   bool isWin32Module() const override;
  40
  41   // Returns the preferred base of the module, i.e. where the loader would place
  42   // it in memory assuming there were no conflicts.
  43   uint64_t getModulePreferredBase() const override;
  44
  45 private:
  46   bool getNameFromSymbolTable(object::SymbolRef::Type Type, uint64_t Address,
  47                               std::string &Name, uint64_t &Addr,
  48                               uint64_t &Size) const;
  49   // For big-endian PowerPC64 ELF, OpdAddress is the address of the .opd
  50   // (function descriptor) section and OpdExtractor refers to its contents.
  51   std::error_code addSymbol(const object::SymbolRef &Symbol,
  52                             uint64_t SymbolSize,
  53                             DataExtractor *OpdExtractor = nullptr,
  54                             uint64_t OpdAddress = 0);
  55   std::error_code addCoffExportSymbols(const object::COFFObjectFile *CoffObj);
  56
  57   object::ObjectFile *Module;
  58   std::unique_ptr<DIContext> DebugInfoContext;
  59
  60   struct SymbolDesc {
  61     uint64_t Addr;
  62     // If size is 0, assume that symbol occupies the whole memory range up to
  63     // the following symbol.
  64     uint64_t Size;
  65     friend bool operator<(const SymbolDesc &s1, const SymbolDesc &s2) {
  66       return s1.Addr < s2.Addr;
  67     }
  68   };
  69   std::map<SymbolDesc, StringRef> Functions;
  70   std::map<SymbolDesc, StringRef> Objects;
  71
  72   SymbolizableObjectFile(object::ObjectFile *Obj,
  73                          std::unique_ptr<DIContext> DICtx);
  74 };
  75
  76 }  // namespace symbolize
  77 }  // namespace llvm
  78
  79 #endif  // LLVM_LIB_DEBUGINFO_SYMBOLIZE_SYMBOLIZABLEOBJECTFILE_H