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