com.github.unidbg.arm

Class AbstractARMDebugger

java.lang.Object

com.github.unidbg.arm.AbstractARMDebugger

All Implemented Interfaces:

BlockHook, CodeHook, DebugHook, Detachable, Breaker, Debugger

Direct Known Subclasses:

AbstractDebugServer

public abstract class AbstractARMDebugger
extends Object
implements Debugger

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static class	AbstractARMDebugger.StringType

Field Summary

Fields

Modifier and Type	Field and Description
protected boolean	callbackRunning
protected Emulator<?>	emulator
protected McpServer	mcpServer
protected boolean	scannerNeedsRefresh

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractARMDebugger(Emulator<?> emulator)

Method Summary

Modifier and Type	Method and Description
BreakPoint	addBreakPoint(long address)
BreakPoint	addBreakPoint(long address, BreakPointCallback callback)
BreakPoint	addBreakPoint(Module module, long offset)
BreakPoint	addBreakPoint(Module module, long offset, BreakPointCallback callback)
BreakPoint	addBreakPoint(Module module, String symbol)
BreakPoint	addBreakPoint(Module module, String symbol, BreakPointCallback callback)
void	addMcpTool(String name, String description, String... paramNames)
void	brk(UnidbgPointer pc, int svcNumber)
void	close()
protected abstract keystone.Keystone	createKeystone(boolean isThumb)
void	debug(String reason)
void	detach()
void	disassembleBlock(Emulator<?> emulator, long address, boolean thumb)
protected void	dumpClass(String className)
protected void	dumpGPBProtobufMsg(String className)
static Module	findModuleByAddress(Emulator<?> emulator, long address)
Map<Long,BreakPoint>	getBreakPoints()
boolean	hasRunnable()
void	hook(Backend backend, long address, int size, Object user)
void	hookBlock(Backend backend, long address, int size, Object user)
boolean	isDebugging()
protected abstract void	loop(Emulator<?> emulator, long address, int size, DebugRunnable<?> runnable)
void	notifyExecutionStarted(long address)
void	onAttach(UnHook unHook)
void	onBreak(Backend backend, long address, int size, Object user)
boolean	removeBreakPoint(long address)
protected abstract int	resolveRegister(String command, String[] nameOut)
protected abstract int	resolveWriteRegister(String command)
<T> T	run(DebugRunnable<T> runnable)
protected void	searchClass(String keywords)
void	setDebugListener(DebugListener listener)
protected void	setSingleStep(int singleStep)
protected abstract void	showWriteHelp()
protected abstract void	showWriteRegs(int reg)
void	traceFunctionCall(FunctionCallListener listener)
void	traceFunctionCall(Module module, FunctionCallListener listener) use with unicorn

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.github.unidbg.debugger.Breaker

debug

Field Detail

emulator

protected final Emulator<?> emulator

mcpServer

protected McpServer mcpServer

scannerNeedsRefresh

protected volatile boolean scannerNeedsRefresh

callbackRunning

protected boolean callbackRunning

Constructor Detail

AbstractARMDebugger

protected AbstractARMDebugger(Emulator<?> emulator)

Method Detail

getBreakPoints

public Map<Long,BreakPoint> getBreakPoints()

Specified by:

getBreakPoints in interface Debugger

onAttach

public void onAttach(UnHook unHook)

Specified by:

onAttach in interface Detachable

detach

public void detach()

Specified by:

detach in interface Detachable

addBreakPoint

public final BreakPoint addBreakPoint(Module module,
                                      String symbol)

Specified by:

addBreakPoint in interface Debugger

addBreakPoint

public final BreakPoint addBreakPoint(Module module,
                                      String symbol,
                                      BreakPointCallback callback)

Specified by:

addBreakPoint in interface Debugger

addBreakPoint

public final BreakPoint addBreakPoint(Module module,
                                      long offset)

Specified by:

addBreakPoint in interface Debugger

addBreakPoint

public final BreakPoint addBreakPoint(Module module,
                                      long offset,
                                      BreakPointCallback callback)

Specified by:

addBreakPoint in interface Debugger

addBreakPoint

public BreakPoint addBreakPoint(long address)

Specified by:

addBreakPoint in interface Debugger

Parameters:

address - 奇数地址表示thumb断点

addBreakPoint

public BreakPoint addBreakPoint(long address,
                                BreakPointCallback callback)

Specified by:

addBreakPoint in interface Debugger

traceFunctionCall

public void traceFunctionCall(FunctionCallListener listener)

Specified by:

traceFunctionCall in interface Debugger

traceFunctionCall

public void traceFunctionCall(Module module,
                              FunctionCallListener listener)

Description copied from interface: Debugger

use with unicorn

Specified by:

traceFunctionCall in interface Debugger

Parameters:

module - null means all modules.

createKeystone

protected abstract keystone.Keystone createKeystone(boolean isThumb)

resolveRegister

protected abstract int resolveRegister(String command,
                                       String[] nameOut)

resolveWriteRegister

protected abstract int resolveWriteRegister(String command)

showWriteRegs

protected abstract void showWriteRegs(int reg)

showWriteHelp

protected abstract void showWriteHelp()

removeBreakPoint

public final boolean removeBreakPoint(long address)

Specified by:

removeBreakPoint in interface Debugger

setDebugListener

public void setDebugListener(DebugListener listener)

Specified by:

setDebugListener in interface Debugger

onBreak

public void onBreak(Backend backend,
                    long address,
                    int size,
                    Object user)

Specified by:

onBreak in interface DebugHook

isDebugging

public boolean isDebugging()

Specified by:

isDebugging in interface Debugger

hookBlock

public void hookBlock(Backend backend,
                      long address,
                      int size,
                      Object user)

Specified by:

hookBlock in interface BlockHook

hook

public final void hook(Backend backend,
                       long address,
                       int size,
                       Object user)

Specified by:

hook in interface CodeHook

debug

public void debug(String reason)

Specified by:

debug in interface Breaker

setSingleStep

protected final void setSingleStep(int singleStep)

loop

protected abstract void loop(Emulator<?> emulator,
                             long address,
                             int size,
                             DebugRunnable<?> runnable)
                      throws Exception

Throws:

Exception

hasRunnable

public boolean hasRunnable()

Specified by:

hasRunnable in interface Debugger

run

public <T> T run(DebugRunnable<T> runnable)
          throws Exception

Specified by:

run in interface Debugger

Throws:

Exception

dumpGPBProtobufMsg

protected void dumpGPBProtobufMsg(String className)

searchClass

protected void searchClass(String keywords)

dumpClass

protected void dumpClass(String className)

disassembleBlock

public final void disassembleBlock(Emulator<?> emulator,
                                   long address,
                                   boolean thumb)

Specified by:

disassembleBlock in interface Debugger

findModuleByAddress

public static Module findModuleByAddress(Emulator<?> emulator,
                                         long address)

brk

public final void brk(UnidbgPointer pc,
                      int svcNumber)

Specified by:

brk in interface Breaker

addMcpTool

public void addMcpTool(String name,
                       String description,
                       String... paramNames)

Specified by:

addMcpTool in interface Debugger

notifyExecutionStarted

public void notifyExecutionStarted(long address)

close

public void close()

Specified by:

close in interface Debugger