mirror of
				https://github.com/c64scene-ar/llvm-6502.git
				synced 2025-11-04 05:17:07 +00:00 
			
		
		
		
	disassembler API. Hooked this up to the ARM target so such tools as Darwin's otool(1) can now print things like branch targets for example this: blx _puts instead of this: blx #-36 And even print the expression encoded in the Mach-O relocation entried for things like this: movt r0, :upper16:((_foo-_bar)+1234) git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@129284 91177308-0d34-0410-b5e6-96231b3b80d8
		
			
				
	
	
		
			87 lines
		
	
	
		
			3.2 KiB
		
	
	
	
		
			C++
		
	
	
	
	
	
			
		
		
	
	
			87 lines
		
	
	
		
			3.2 KiB
		
	
	
	
		
			C++
		
	
	
	
	
	
//===-- llvm/MC/MCDisassembler.h - Disassembler interface -------*- C++ -*-===//
 | 
						|
//
 | 
						|
//                     The LLVM Compiler Infrastructure
 | 
						|
//
 | 
						|
// This file is distributed under the University of Illinois Open Source
 | 
						|
// License. See LICENSE.TXT for details.
 | 
						|
//
 | 
						|
//===----------------------------------------------------------------------===//
 | 
						|
#ifndef MCDISASSEMBLER_H
 | 
						|
#define MCDISASSEMBLER_H
 | 
						|
 | 
						|
#include "llvm/Support/DataTypes.h"
 | 
						|
#include "llvm-c/Disassembler.h"
 | 
						|
 | 
						|
namespace llvm {
 | 
						|
  
 | 
						|
class MCInst;
 | 
						|
class MemoryObject;
 | 
						|
class raw_ostream;
 | 
						|
class MCContext;
 | 
						|
  
 | 
						|
struct EDInstInfo;
 | 
						|
 | 
						|
/// MCDisassembler - Superclass for all disassemblers.  Consumes a memory region
 | 
						|
///   and provides an array of assembly instructions.
 | 
						|
class MCDisassembler {
 | 
						|
public:
 | 
						|
  /// Constructor     - Performs initial setup for the disassembler.
 | 
						|
  MCDisassembler() : GetOpInfo(0), DisInfo(0), Ctx(0) {}
 | 
						|
  
 | 
						|
  virtual ~MCDisassembler();
 | 
						|
  
 | 
						|
  /// getInstruction  - Returns the disassembly of a single instruction.
 | 
						|
  ///
 | 
						|
  /// @param instr    - An MCInst to populate with the contents of the 
 | 
						|
  ///                   instruction.
 | 
						|
  /// @param size     - A value to populate with the size of the instruction, or
 | 
						|
  ///                   the number of bytes consumed while attempting to decode
 | 
						|
  ///                   an invalid instruction.
 | 
						|
  /// @param region   - The memory object to use as a source for machine code.
 | 
						|
  /// @param address  - The address, in the memory space of region, of the first
 | 
						|
  ///                   byte of the instruction.
 | 
						|
  /// @param vStream  - The stream to print warnings and diagnostic messages on.
 | 
						|
  /// @return         - True if the instruction is valid; false otherwise.
 | 
						|
  virtual bool          getInstruction(MCInst& instr,
 | 
						|
                                       uint64_t& size,
 | 
						|
                                       const MemoryObject ®ion,
 | 
						|
                                       uint64_t address,
 | 
						|
                                       raw_ostream &vStream) const = 0;
 | 
						|
 | 
						|
  /// getEDInfo - Returns the enhanced instruction information corresponding to
 | 
						|
  ///   the disassembler.
 | 
						|
  ///
 | 
						|
  /// @return         - An array of instruction information, with one entry for
 | 
						|
  ///                   each MCInst opcode this disassembler returns.
 | 
						|
  ///                   NULL if there is no info for this target.
 | 
						|
  virtual EDInstInfo   *getEDInfo() const { return (EDInstInfo*)0; }
 | 
						|
 | 
						|
private:
 | 
						|
  //
 | 
						|
  // Hooks for symbolic disassembly via the public 'C' interface.
 | 
						|
  //
 | 
						|
  // The function to get the symbolic information for operands.
 | 
						|
  LLVMOpInfoCallback GetOpInfo;
 | 
						|
  // The pointer to the block of symbolic information for above call back.
 | 
						|
  void *DisInfo;
 | 
						|
  // The assembly context for creating symbols and MCExprs in place of
 | 
						|
  // immediate operands when there is symbolic information.
 | 
						|
  MCContext *Ctx;
 | 
						|
 | 
						|
public:
 | 
						|
  void setupForSymbolicDisassembly(LLVMOpInfoCallback getOpInfo,
 | 
						|
                                   void *disInfo,
 | 
						|
                                   MCContext *ctx) {
 | 
						|
    GetOpInfo = getOpInfo;
 | 
						|
    DisInfo = disInfo;
 | 
						|
    Ctx = ctx;
 | 
						|
  }
 | 
						|
  LLVMOpInfoCallback getLLVMOpInfoCallback() const { return GetOpInfo; }
 | 
						|
  void *getDisInfoBlock() const { return DisInfo; }
 | 
						|
  MCContext *getMCContext() const { return Ctx; }
 | 
						|
};
 | 
						|
 | 
						|
} // namespace llvm
 | 
						|
 | 
						|
#endif
 |