mirror of
https://github.com/c64scene-ar/llvm-6502.git
synced 2024-12-26 21:32:10 +00:00
2c94d0faa0
This is a basic first step towards symbolization of disassembled instructions. This used to be done using externally provided (C API) callbacks. This patch introduces: - the MCSymbolizer class, that mimics the same functions that were used in the X86 and ARM disassemblers to symbolize immediate operands and to annotate loads based off PC (for things like c string literals). - the MCExternalSymbolizer class, which implements the old C API. - the MCRelocationInfo class, which provides a way for targets to translate relocations (either object::RelocationRef, or disassembler C API VariantKinds) to MCExprs. - the MCObjectSymbolizer class, which does symbolization using what it finds in an object::ObjectFile. This makes simple symbolization (with no fancy relocation stuff) work for all object formats! - x86-64 Mach-O and ELF MCRelocationInfos. - A basic ARM Mach-O MCRelocationInfo, that provides just enough to support the C API VariantKinds. Most of what works in otool (the only user of the old symbolization API that I know of) for x86-64 symbolic disassembly (-tvV) works, namely: - symbol references: call _foo; jmp 15 <_foo+50> - relocations: call _foo-_bar; call _foo-4 - __cf?string: leaq 193(%rip), %rax ## literal pool for "hello" Stub support is the main missing part (because libObject doesn't know, among other things, about mach-o indirect symbols). As for the MCSymbolizer API, instead of relying on the disassemblers to call the tryAdding* methods, maybe this could be done automagically using InstrInfo? For instance, even though PC-relative LEAs are used to get the address of string literals in a typical Mach-O file, a MOV would be used in an ELF file. And right now, the explicit symbolization only recognizes PC-relative LEAs. InstrInfo should have already have most of what is needed to know what to symbolize, so this can definitely be improved. I'd also like to remove object::RelocationRef::getValueString (it seems only used by relocation printing in objdump), as simply printing the created MCExpr is definitely enough (and cleaner than string concats). git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@182625 91177308-0d34-0410-b5e6-96231b3b80d8
59 lines
2.0 KiB
C++
59 lines
2.0 KiB
C++
//===-- llvm/MC/MCExternalSymbolizer.h - ------------------------*- C++ -*-===//
|
|
//
|
|
// The LLVM Compiler Infrastructure
|
|
//
|
|
// This file is distributed under the University of Illinois Open Source
|
|
// License. See LICENSE.TXT for details.
|
|
//
|
|
//===----------------------------------------------------------------------===//
|
|
//
|
|
// This file contains the declaration of the MCExternalSymbolizer class, which
|
|
// enables library users to provide callbacks (through the C API) to do the
|
|
// symbolization externally.
|
|
//
|
|
//===----------------------------------------------------------------------===//
|
|
|
|
#ifndef LLVM_MC_MCEXTERNALSYMBOLIZER_H
|
|
#define LLVM_MC_MCEXTERNALSYMBOLIZER_H
|
|
|
|
#include "llvm-c/Disassembler.h"
|
|
#include "llvm/MC/MCSymbolizer.h"
|
|
|
|
namespace llvm {
|
|
|
|
/// \brief Symbolize using user-provided, C API, callbacks.
|
|
///
|
|
/// See llvm-c/Disassembler.h.
|
|
class MCExternalSymbolizer : public MCSymbolizer {
|
|
|
|
/// \name Hooks for symbolic disassembly via the public 'C' interface.
|
|
/// @{
|
|
/// The function to get the symbolic information for operands.
|
|
LLVMOpInfoCallback GetOpInfo;
|
|
/// The function to lookup a symbol name.
|
|
LLVMSymbolLookupCallback SymbolLookUp;
|
|
/// The pointer to the block of symbolic information for above call back.
|
|
void *DisInfo;
|
|
/// @}
|
|
|
|
public:
|
|
MCExternalSymbolizer(MCContext &Ctx,
|
|
OwningPtr<MCRelocationInfo> &RelInfo,
|
|
LLVMOpInfoCallback getOpInfo,
|
|
LLVMSymbolLookupCallback symbolLookUp,
|
|
void *disInfo)
|
|
: MCSymbolizer(Ctx, RelInfo),
|
|
GetOpInfo(getOpInfo), SymbolLookUp(symbolLookUp), DisInfo(disInfo) {}
|
|
|
|
bool tryAddingSymbolicOperand(MCInst &MI, raw_ostream &CommentStream,
|
|
int64_t Value,
|
|
uint64_t Address, bool IsBranch,
|
|
uint64_t Offset, uint64_t InstSize);
|
|
void tryAddingPcLoadReferenceComment(raw_ostream &CommentStream,
|
|
int64_t Value, uint64_t Address);
|
|
};
|
|
|
|
}
|
|
|
|
#endif
|