com.github.unidbg

Class AbstractEmulator<T extends NewFileIO>

java.lang.Object

com.github.unidbg.AbstractEmulator<T>

All Implemented Interfaces:

Emulator<T>, MemoryWriteListener, Serializable, ArmDisassembler, Closeable, AutoCloseable

Direct Known Subclasses:

AbstractARM64Emulator, AbstractARMEmulator

public abstract class AbstractEmulator<T extends NewFileIO>
extends Object
implements Emulator<T>, MemoryWriteListener

abstract emulator Created by zhkl0228 on 2017/5/2.

Field Summary

Fields

Modifier and Type	Field and Description
protected Backend	backend
protected DateFormat	dateFormat
static long	DEFAULT_TIMEOUT
protected SvcMemory	svcMemory
protected long	timeout

Constructor Summary

Constructors

Constructor and Description
AbstractEmulator(boolean is64Bit, String processName, long svcBase, int svcSize, File rootDir, Family family, Collection<BackendFactory> backendFactories)

Method Summary

Modifier and Type	Method and Description
protected abstract byte[]	assemble(Iterable<String> assembly)
Debugger	attach()
Debugger	attach(DebuggerType type)
void	close()
protected abstract void	closeInternal()
protected abstract Debugger	createConsoleDebugger()
protected abstract Dlfcn	createDyld(SvcMemory svcMemory)
protected abstract FileSystem<T>	createFileSystem(File rootDir)
protected abstract Memory	createMemory(UnixSyscallHandler<T> syscallHandler, String[] envs)
protected abstract RegisterContext	createRegisterContext(Backend backend)
protected abstract UnixSyscallHandler<T>	createSyscallHandler(SvcMemory svcMemory)
protected ThreadDispatcher	createThreadDispatcher()
protected void	dumpClass(String className)
protected void	dumpGPBProtobufMsg(String className)
Number	emulate(long begin, long until)
boolean	emulateSignal(int sig) emulate signal handler
<V> V	get(String key)
Backend	getBackend()
<V extends RegisterContext> V	getContext()
Family	getFamily()
FileSystem<T>	getFileSystem()
int	getPageAlign()
protected abstract int	getPageAlignInternal()
int	getPid()
String	getProcessName()
abstract com.sun.jna.Pointer	getStackPointer()
SvcMemory	getSvcMemory()
ThreadDispatcher	getThreadDispatcher()
boolean	is32Bit()
boolean	is64Bit()
protected abstract boolean	isPaddingArgument()
boolean	isRunning() 是否正在运行
void	onSystemWrite(long addr, byte[] data)
int	popContext()
void	pushContext(int off)
protected Number	runMainForResult(MainTask task)
protected void	searchClass(String keywords)
void	serialize(DataOutput out)
void	set(String key, Object value)
void	setTimeout(long timeout)
void	setTraceSystemMemoryWrite(long begin, long end, TraceSystemMemoryWriteListener listener)
TraceHook	traceCode() trace instruction note: low performance
TraceHook	traceCode(long begin, long end)
TraceHook	traceCode(long begin, long end, TraceCodeListener listener)
TraceHook	traceRead() trace memory read
TraceHook	traceRead(long begin, long end)
TraceHook	traceRead(long begin, long end, TraceReadListener listener)
TraceHook	traceWrite() trace memory write
TraceHook	traceWrite(long begin, long end)
TraceHook	traceWrite(long begin, long end, TraceWriteListener listener)

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.Emulator

createURLibraryFile, dumpGPBProtobufDef, dumpObjcClass, eEntry, eFunc, getDlfcn, getMemory, getObjcClassName, getPointerSize, getReturnAddress, getSyscallHandler, getUnwinder, loadLibrary, loadLibrary, showRegs, showRegs, traceMemoryLeaks

Methods inherited from interface com.github.unidbg.spi.ArmDisassembler

disassemble, disassemble, printAssemble

Field Detail

DEFAULT_TIMEOUT

public static final long DEFAULT_TIMEOUT

See Also:

Constant Field Values

backend

protected final Backend backend

timeout

protected long timeout

svcMemory

protected final SvcMemory svcMemory

dateFormat

protected final DateFormat dateFormat

Constructor Detail

AbstractEmulator

public AbstractEmulator(boolean is64Bit,
                        String processName,
                        long svcBase,
                        int svcSize,
                        File rootDir,
                        Family family,
                        Collection<BackendFactory> backendFactories)

Method Detail

createThreadDispatcher

protected ThreadDispatcher createThreadDispatcher()

getPageAlign

public final int getPageAlign()

Specified by:

getPageAlign in interface Emulator<T extends NewFileIO>

getPageAlignInternal

protected abstract int getPageAlignInternal()

getFamily

public Family getFamily()

Specified by:

getFamily in interface Emulator<T extends NewFileIO>

getSvcMemory

public final SvcMemory getSvcMemory()

Specified by:

getSvcMemory in interface Emulator<T extends NewFileIO>

getFileSystem

public final FileSystem<T> getFileSystem()

Specified by:

getFileSystem in interface Emulator<T extends NewFileIO>

createFileSystem

protected abstract FileSystem<T> createFileSystem(File rootDir)

is64Bit

public boolean is64Bit()

Specified by:

is64Bit in interface Emulator<T extends NewFileIO>

is32Bit

public boolean is32Bit()

Specified by:

is32Bit in interface Emulator<T extends NewFileIO>

createRegisterContext

protected abstract RegisterContext createRegisterContext(Backend backend)

getContext

public <V extends RegisterContext> V getContext()

Specified by:

getContext in interface Emulator<T extends NewFileIO>

createMemory

protected abstract Memory createMemory(UnixSyscallHandler<T> syscallHandler,
                                       String[] envs)

createDyld

protected abstract Dlfcn createDyld(SvcMemory svcMemory)

createSyscallHandler

protected abstract UnixSyscallHandler<T> createSyscallHandler(SvcMemory svcMemory)

assemble

protected abstract byte[] assemble(Iterable<String> assembly)

attach

public Debugger attach()

Specified by:

attach in interface Emulator<T extends NewFileIO>

attach

public Debugger attach(DebuggerType type)

Specified by:

attach in interface Emulator<T extends NewFileIO>

createConsoleDebugger

protected abstract Debugger createConsoleDebugger()

getPid

public int getPid()

Specified by:

getPid in interface Emulator<T extends NewFileIO>

traceRead

public final TraceHook traceRead(long begin,
                                 long end)

Specified by:

traceRead in interface Emulator<T extends NewFileIO>

traceRead

public TraceHook traceRead(long begin,
                           long end,
                           TraceReadListener listener)

Specified by:

traceRead in interface Emulator<T extends NewFileIO>

traceWrite

public final TraceHook traceWrite(long begin,
                                  long end)

Specified by:

traceWrite in interface Emulator<T extends NewFileIO>

setTraceSystemMemoryWrite

public void setTraceSystemMemoryWrite(long begin,
                                      long end,
                                      TraceSystemMemoryWriteListener listener)

Specified by:

setTraceSystemMemoryWrite in interface Emulator<T extends NewFileIO>

onSystemWrite

public void onSystemWrite(long addr,
                          byte[] data)

Specified by:

onSystemWrite in interface MemoryWriteListener

traceWrite

public TraceHook traceWrite(long begin,
                            long end,
                            TraceWriteListener listener)

Specified by:

traceWrite in interface Emulator<T extends NewFileIO>

traceRead

public final TraceHook traceRead()

Description copied from interface: Emulator

trace memory read

Specified by:

traceRead in interface Emulator<T extends NewFileIO>

traceWrite

public final TraceHook traceWrite()

Description copied from interface: Emulator

trace memory write

Specified by:

traceWrite in interface Emulator<T extends NewFileIO>

traceCode

public final TraceHook traceCode()

Description copied from interface: Emulator

trace instruction note: low performance

Specified by:

traceCode in interface Emulator<T extends NewFileIO>

traceCode

public final TraceHook traceCode(long begin,
                                 long end)

Specified by:

traceCode in interface Emulator<T extends NewFileIO>

traceCode

public TraceHook traceCode(long begin,
                           long end,
                           TraceCodeListener listener)

Specified by:

traceCode in interface Emulator<T extends NewFileIO>

setTimeout

public void setTimeout(long timeout)

Specified by:

setTimeout in interface Emulator<T extends NewFileIO>

Parameters:

timeout - Duration to emulate the code (in microseconds). When this value is 0, we will emulate the code in infinite time, until the code is finished.

isRunning

public boolean isRunning()

Description copied from interface: Emulator

是否正在运行

Specified by:

isRunning in interface Emulator<T extends NewFileIO>

getThreadDispatcher

public ThreadDispatcher getThreadDispatcher()

Specified by:

getThreadDispatcher in interface Emulator<T extends NewFileIO>

emulateSignal

public boolean emulateSignal(int sig)

Description copied from interface: Emulator

emulate signal handler

Specified by:

emulateSignal in interface Emulator<T extends NewFileIO>

Parameters:

sig - signal number

Returns:

true means called handler function.

runMainForResult

protected final Number runMainForResult(MainTask task)

emulate

public final Number emulate(long begin,
                            long until)
                     throws PopContextException

Returns:

null表示执行未完成，需要线程调度

Throws:

PopContextException

getStackPointer

public abstract com.sun.jna.Pointer getStackPointer()

close

public final void close()
                 throws IOException

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Throws:

IOException

closeInternal

protected abstract void closeInternal()

getBackend

public Backend getBackend()

Specified by:

getBackend in interface Emulator<T extends NewFileIO>

getProcessName

public String getProcessName()

Specified by:

getProcessName in interface Emulator<T extends NewFileIO>

set

public void set(String key,
                Object value)

Specified by:

set in interface Emulator<T extends NewFileIO>

get

public <V> V get(String key)

Specified by:

get in interface Emulator<T extends NewFileIO>

isPaddingArgument

protected abstract boolean isPaddingArgument()

dumpClass

protected void dumpClass(String className)

searchClass

protected void searchClass(String keywords)

dumpGPBProtobufMsg

protected void dumpGPBProtobufMsg(String className)

serialize

public final void serialize(DataOutput out)
                     throws IOException

Specified by:

serialize in interface Serializable

Throws:

IOException

pushContext

public void pushContext(int off)

Specified by:

pushContext in interface Emulator<T extends NewFileIO>

popContext

public int popContext()

Specified by:

popContext in interface Emulator<T extends NewFileIO>