1 //===------------- Disassembler.h - LLVM Disassembler -----------*- 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 defines the interface for the Disassembly library's disassembler 10 // context. The disassembler is responsible for producing strings for 11 // individual instructions according to a given architecture and disassembly 12 // syntax. 13 // 14 //===----------------------------------------------------------------------===// 15 16 #ifndef LLVM_LIB_MC_MCDISASSEMBLER_DISASSEMBLER_H 17 #define LLVM_LIB_MC_MCDISASSEMBLER_DISASSEMBLER_H 18 19 #include "llvm-c/Disassembler.h" 20 #include "llvm/ADT/SmallString.h" 21 #include "llvm/MC/MCAsmInfo.h" 22 #include "llvm/MC/MCContext.h" 23 #include "llvm/MC/MCDisassembler/MCDisassembler.h" 24 #include "llvm/MC/MCInstPrinter.h" 25 #include "llvm/MC/MCInstrInfo.h" 26 #include "llvm/MC/MCRegisterInfo.h" 27 #include "llvm/MC/MCSubtargetInfo.h" 28 #include "llvm/Support/raw_ostream.h" 29 #include <string> 30 #include <utility> 31 32 namespace llvm { 33 class Target; 34 35 // 36 // This is the disassembler context returned by LLVMCreateDisasm(). 37 // 38 class LLVMDisasmContext { 39 private: 40 // 41 // The passed parameters when the disassembler context is created. 42 // 43 // The TripleName for this disassembler. 44 std::string TripleName; 45 // The pointer to the caller's block of symbolic information. 46 void *DisInfo; 47 // The Triple specific symbolic information type returned by GetOpInfo. 48 int TagType; 49 // The function to get the symbolic information for operands. 50 LLVMOpInfoCallback GetOpInfo; 51 // The function to look up a symbol name. 52 LLVMSymbolLookupCallback SymbolLookUp; 53 // 54 // The objects created and saved by LLVMCreateDisasm() then used by 55 // LLVMDisasmInstruction(). 56 // 57 // The LLVM target corresponding to the disassembler. 58 // FIXME: using std::unique_ptr<const llvm::Target> causes a malloc error 59 // when this LLVMDisasmContext is deleted. 60 const Target *TheTarget; 61 // The assembly information for the target architecture. 62 std::unique_ptr<const llvm::MCAsmInfo> MAI; 63 // The register information for the target architecture. 64 std::unique_ptr<const llvm::MCRegisterInfo> MRI; 65 // The subtarget information for the target architecture. 66 std::unique_ptr<const llvm::MCSubtargetInfo> MSI; 67 // The instruction information for the target architecture. 68 std::unique_ptr<const llvm::MCInstrInfo> MII; 69 // The assembly context for creating symbols and MCExprs. 70 std::unique_ptr<const llvm::MCContext> Ctx; 71 // The disassembler for the target architecture. 72 std::unique_ptr<const llvm::MCDisassembler> DisAsm; 73 // The instruction printer for the target architecture. 74 std::unique_ptr<llvm::MCInstPrinter> IP; 75 // The options used to set up the disassembler. 76 uint64_t Options; 77 // The CPU string. 78 std::string CPU; 79 80 public: 81 // Comment stream and backing vector. 82 SmallString<128> CommentsToEmit; 83 raw_svector_ostream CommentStream; 84 85 LLVMDisasmContext(std::string tripleName, void *disInfo, int tagType, 86 LLVMOpInfoCallback getOpInfo, 87 LLVMSymbolLookupCallback symbolLookUp, 88 const Target *theTarget, const MCAsmInfo *mAI, 89 const MCRegisterInfo *mRI, const MCSubtargetInfo *mSI, 90 const MCInstrInfo *mII, llvm::MCContext *ctx, 91 const MCDisassembler *disAsm, MCInstPrinter *iP) 92 : TripleName(std::move(tripleName)), DisInfo(disInfo), TagType(tagType), 93 GetOpInfo(getOpInfo), SymbolLookUp(symbolLookUp), TheTarget(theTarget), 94 Options(0), CommentStream(CommentsToEmit) { 95 MAI.reset(mAI); 96 MRI.reset(mRI); 97 MSI.reset(mSI); 98 MII.reset(mII); 99 Ctx.reset(ctx); 100 DisAsm.reset(disAsm); 101 IP.reset(iP); 102 } 103 const std::string &getTripleName() const { return TripleName; } 104 void *getDisInfo() const { return DisInfo; } 105 int getTagType() const { return TagType; } 106 LLVMOpInfoCallback getGetOpInfo() const { return GetOpInfo; } 107 LLVMSymbolLookupCallback getSymbolLookupCallback() const { 108 return SymbolLookUp; 109 } 110 const Target *getTarget() const { return TheTarget; } 111 const MCDisassembler *getDisAsm() const { return DisAsm.get(); } 112 const MCAsmInfo *getAsmInfo() const { return MAI.get(); } 113 const MCInstrInfo *getInstrInfo() const { return MII.get(); } 114 const MCRegisterInfo *getRegisterInfo() const { return MRI.get(); } 115 const MCSubtargetInfo *getSubtargetInfo() const { return MSI.get(); } 116 MCInstPrinter *getIP() { return IP.get(); } 117 void setIP(MCInstPrinter *NewIP) { IP.reset(NewIP); } 118 uint64_t getOptions() const { return Options; } 119 void addOptions(uint64_t Options) { this->Options |= Options; } 120 StringRef getCPU() const { return CPU; } 121 void setCPU(const char *CPU) { this->CPU = CPU; } 122 }; 123 124 } // namespace llvm 125 126 #endif 127