Symbolize using user-provided, C API, callbacks. More...

#include "llvm/MC/MCDisassembler/MCExternalSymbolizer.h"

Inheritance diagram for llvm::MCExternalSymbolizer:

Collaboration diagram for llvm::MCExternalSymbolizer:

Public Member Functions
	MCExternalSymbolizer (MCContext &Ctx, std::unique_ptr< MCRelocationInfo > RelInfo, LLVMOpInfoCallback getOpInfo, LLVMSymbolLookupCallback symbolLookUp, void *disInfo)

bool	tryAddingSymbolicOperand (MCInst &MI, raw_ostream &CommentStream, int64_t Value, uint64_t Address, bool IsBranch, uint64_t Offset, uint64_t InstSize) override
	Try to add a symbolic operand instead of `Value` to the MCInst. More...

void	tryAddingPcLoadReferenceComment (raw_ostream &CommentStream, int64_t Value, uint64_t Address) override
	Try to add a comment on the PC-relative load. More...

Public Member Functions inherited from llvm::MCSymbolizer
	MCSymbolizer (MCContext &Ctx, std::unique_ptr< MCRelocationInfo > RelInfo)
	Construct an MCSymbolizer, taking ownership of `RelInfo`. More...

	MCSymbolizer (const MCSymbolizer &)=delete

MCSymbolizer &	operator= (const MCSymbolizer &)=delete

virtual	~MCSymbolizer ()

Protected Attributes
Hooks for symbolic disassembly via the public 'C' interface.
The function to get the symbolic information for operands.
LLVMOpInfoCallback	GetOpInfo

LLVMSymbolLookupCallback	SymbolLookUp
	The function to lookup a symbol name. More...

void *	DisInfo
	The pointer to the block of symbolic information for above call back. More...

Protected Attributes inherited from llvm::MCSymbolizer
MCContext &	Ctx

std::unique_ptr< MCRelocationInfo >	RelInfo

Detailed Description

Symbolize using user-provided, C API, callbacks.

See llvm-c/Disassembler.h.

Definition at line 28 of file MCExternalSymbolizer.h.

Constructor & Destructor Documentation

◆ MCExternalSymbolizer()

llvm::MCExternalSymbolizer::MCExternalSymbolizer	(	MCContext &	Ctx,
		std::unique_ptr< MCRelocationInfo >	RelInfo,
		LLVMOpInfoCallback	getOpInfo,
		LLVMSymbolLookupCallback	symbolLookUp,
		void *	disInfo
	)

inline

Definition at line 41 of file MCExternalSymbolizer.h.

References llvm::Address, MI, tryAddingPcLoadReferenceComment(), and tryAddingSymbolicOperand().

Referenced by llvm::createMCSymbolizer().

Member Function Documentation

◆ tryAddingPcLoadReferenceComment()

void MCExternalSymbolizer::tryAddingPcLoadReferenceComment	(	raw_ostream &	cStream,
		int64_t	Value,
		uint64_t	Address
	)

overridevirtual

Try to add a comment on the PC-relative load.

For instance, in Mach-O, this is used to add annotations to instructions that use C string literals, as found in __cstring.

Implements llvm::MCSymbolizer.

Definition at line 157 of file MCExternalSymbolizer.cpp.

References DisInfo, LLVMDisassembler_ReferenceType_In_PCrel_Load, LLVMDisassembler_ReferenceType_Out_LitPool_CstrAddr, LLVMDisassembler_ReferenceType_Out_LitPool_SymAddr, LLVMDisassembler_ReferenceType_Out_Objc_CFString_Ref, LLVMDisassembler_ReferenceType_Out_Objc_Class_Ref, LLVMDisassembler_ReferenceType_Out_Objc_Message, LLVMDisassembler_ReferenceType_Out_Objc_Message_Ref, LLVMDisassembler_ReferenceType_Out_Objc_Selector_Ref, SymbolLookUp, and llvm::raw_ostream::write_escaped().

Referenced by MCExternalSymbolizer().

◆ tryAddingSymbolicOperand()

bool MCExternalSymbolizer::tryAddingSymbolicOperand	(	MCInst &	Inst,
		raw_ostream &	cStream,
		int64_t	Value,
		uint64_t	Address,
		bool	IsBranch,
		uint64_t	Offset,
		uint64_t	InstSize
	)

overridevirtual

Try to add a symbolic operand instead of Value to the MCInst.

Instead of having a difficult to read immediate, a symbolic operand would represent this immediate in a more understandable way, for instance as a symbol or an offset from a symbol. Relocations can also be used to enrich the symbolic expression.

Parameters

Inst	- The MCInst where to insert the symbolic operand.
cStream	- Stream to print comments and annotations on.
Value	- Operand value, pc-adjusted by the caller if necessary.
Address	- Load address of the instruction.
IsBranch	- Is the instruction a branch?
Offset	- Byte offset of the operand inside the inst.
InstSize	- Size of the instruction in bytes.