1 //===-- LLVMSymbolize.h ----------------------------------------- C++ -----===//
3 // The LLVM Compiler Infrastructure
5 // This file is distributed under the University of Illinois Open Source
6 // License. See LICENSE.TXT for details.
8 //===----------------------------------------------------------------------===//
10 // Header for LLVM symbolization library.
12 //===----------------------------------------------------------------------===//
13 #ifndef LLVM_SYMBOLIZE_H
14 #define LLVM_SYMBOLIZE_H
16 #include "llvm/ADT/SmallVector.h"
17 #include "llvm/DebugInfo/DIContext.h"
18 #include "llvm/Object/MachOUniversal.h"
19 #include "llvm/Object/ObjectFile.h"
20 #include "llvm/Support/MemoryBuffer.h"
26 using namespace object;
32 class LLVMSymbolizer {
35 bool UseSymbolTable : 1;
36 bool PrintFunctions : 1;
37 bool PrintInlining : 1;
39 std::string DefaultArch;
40 Options(bool UseSymbolTable = true, bool PrintFunctions = true,
41 bool PrintInlining = true, bool Demangle = true,
42 std::string DefaultArch = "")
43 : UseSymbolTable(UseSymbolTable), PrintFunctions(PrintFunctions),
44 PrintInlining(PrintInlining), Demangle(Demangle),
45 DefaultArch(DefaultArch) {
49 LLVMSymbolizer(const Options &Opts = Options()) : Opts(Opts) {}
54 // Returns the result of symbolization for module name/offset as
55 // a string (possibly containing newlines).
57 symbolizeCode(const std::string &ModuleName, uint64_t ModuleOffset);
59 symbolizeData(const std::string &ModuleName, uint64_t ModuleOffset);
61 static std::string DemangleName(const std::string &Name);
63 typedef std::pair<Binary*, Binary*> BinaryPair;
65 ModuleInfo *getOrCreateModuleInfo(const std::string &ModuleName);
66 /// \brief Returns pair of pointers to binary and debug binary.
67 BinaryPair getOrCreateBinary(const std::string &Path);
68 /// \brief Returns a parsed object file for a given architecture in a
69 /// universal binary (or the binary itself if it is an object file).
70 ObjectFile *getObjectFileFromBinary(Binary *Bin, const std::string &ArchName);
72 std::string printDILineInfo(DILineInfo LineInfo) const;
74 // Owns all the parsed binaries and object files.
75 SmallVector<Binary*, 4> ParsedBinariesAndObjects;
76 // Owns module info objects.
77 typedef std::map<std::string, ModuleInfo *> ModuleMapTy;
79 typedef std::map<std::string, BinaryPair> BinaryMapTy;
80 BinaryMapTy BinaryForPath;
81 typedef std::map<std::pair<MachOUniversalBinary *, std::string>, ObjectFile *>
82 ObjectFileForArchMapTy;
83 ObjectFileForArchMapTy ObjectFileForArch;
86 static const char kBadString[];
91 ModuleInfo(ObjectFile *Obj, DIContext *DICtx);
93 DILineInfo symbolizeCode(uint64_t ModuleOffset,
94 const LLVMSymbolizer::Options &Opts) const;
95 DIInliningInfo symbolizeInlinedCode(
96 uint64_t ModuleOffset, const LLVMSymbolizer::Options &Opts) const;
97 bool symbolizeData(uint64_t ModuleOffset, std::string &Name, uint64_t &Start,
98 uint64_t &Size) const;
101 bool getNameFromSymbolTable(SymbolRef::Type Type, uint64_t Address,
102 std::string &Name, uint64_t &Addr,
103 uint64_t &Size) const;
104 void addSymbol(const symbol_iterator &Sym);
106 std::unique_ptr<DIContext> DebugInfoContext;
110 // If size is 0, assume that symbol occupies the whole memory range up to
111 // the following symbol.
113 friend bool operator<(const SymbolDesc &s1, const SymbolDesc &s2) {
114 return s1.Addr < s2.Addr;
117 typedef std::map<SymbolDesc, StringRef> SymbolMapTy;
118 SymbolMapTy Functions;
122 } // namespace symbolize
125 #endif // LLVM_SYMBOLIZE_H