com.github.unidbg

类 AbstractEmulator<T extends NewFileIO>

java.lang.Object

com.github.unidbg.AbstractEmulator<T>

所有已实现的接口:

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

直接已知子类:

AbstractARM64Emulator, AbstractARMEmulator

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

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

字段概要

字段

限定符和类型	字段和说明
protected Backend	backend
protected DateFormat	dateFormat
static long	DEFAULT_TIMEOUT
protected SvcMemory	svcMemory
protected long	timeout

构造器概要

构造器

构造器和说明
AbstractEmulator(boolean is64Bit, String processName, long svcBase, int svcSize, File rootDir, Family family, Collection<BackendFactory> backendFactories)

方法概要

限定符和类型	方法和说明
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)

从类继承的方法 java.lang.Object

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

从接口继承的方法 com.github.unidbg.Emulator

createURLibraryFile, eEntry, eFunc, getDlfcn, getMemory, getPointerSize, getReturnAddress, getSyscallHandler, getUnwinder, loadLibrary, loadLibrary, showRegs, showRegs

从接口继承的方法 com.github.unidbg.spi.ArmDisassembler

disassemble, disassemble, printAssemble

字段详细资料

DEFAULT_TIMEOUT

public static final long DEFAULT_TIMEOUT

另请参阅:

常量字段值

backend

protected final Backend backend

timeout

protected long timeout

svcMemory

protected final SvcMemory svcMemory

dateFormat

protected final DateFormat dateFormat

构造器详细资料

AbstractEmulator

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

方法详细资料

createThreadDispatcher

protected ThreadDispatcher createThreadDispatcher()

getPageAlign

public final int getPageAlign()

指定者:

getPageAlign 在接口中 Emulator<T extends NewFileIO>

getPageAlignInternal

protected abstract int getPageAlignInternal()

getFamily

public Family getFamily()

指定者:

getFamily 在接口中 Emulator<T extends NewFileIO>

getSvcMemory

public final SvcMemory getSvcMemory()

指定者:

getSvcMemory 在接口中 Emulator<T extends NewFileIO>

getFileSystem

public final FileSystem<T> getFileSystem()

指定者:

getFileSystem 在接口中 Emulator<T extends NewFileIO>

createFileSystem

protected abstract FileSystem<T> createFileSystem(File rootDir)

is64Bit

public boolean is64Bit()

指定者:

is64Bit 在接口中 Emulator<T extends NewFileIO>

is32Bit

public boolean is32Bit()

指定者:

is32Bit 在接口中 Emulator<T extends NewFileIO>

createRegisterContext

protected abstract RegisterContext createRegisterContext(Backend backend)

getContext

public <V extends RegisterContext> V getContext()

指定者:

getContext 在接口中 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()

指定者:

attach 在接口中 Emulator<T extends NewFileIO>

attach

public Debugger attach(DebuggerType type)

指定者:

attach 在接口中 Emulator<T extends NewFileIO>

createConsoleDebugger

protected abstract Debugger createConsoleDebugger()

getPid

public int getPid()

指定者:

getPid 在接口中 Emulator<T extends NewFileIO>

traceRead

public final TraceHook traceRead(long begin,
                                 long end)

指定者:

traceRead 在接口中 Emulator<T extends NewFileIO>

traceRead

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

指定者:

traceRead 在接口中 Emulator<T extends NewFileIO>

traceWrite

public final TraceHook traceWrite(long begin,
                                  long end)

指定者:

traceWrite 在接口中 Emulator<T extends NewFileIO>

setTraceSystemMemoryWrite

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

指定者:

setTraceSystemMemoryWrite 在接口中 Emulator<T extends NewFileIO>

onSystemWrite

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

指定者:

onSystemWrite 在接口中 MemoryWriteListener

traceWrite

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

指定者:

traceWrite 在接口中 Emulator<T extends NewFileIO>

traceRead

public final TraceHook traceRead()

从接口复制的说明: Emulator

trace memory read

指定者:

traceRead 在接口中 Emulator<T extends NewFileIO>

traceWrite

public final TraceHook traceWrite()

从接口复制的说明: Emulator

trace memory write

指定者:

traceWrite 在接口中 Emulator<T extends NewFileIO>

traceCode

public final TraceHook traceCode()

从接口复制的说明: Emulator

trace instruction note: low performance

指定者:

traceCode 在接口中 Emulator<T extends NewFileIO>

traceCode

public final TraceHook traceCode(long begin,
                                 long end)

指定者:

traceCode 在接口中 Emulator<T extends NewFileIO>

traceCode

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

指定者:

traceCode 在接口中 Emulator<T extends NewFileIO>

setTimeout

public void setTimeout(long timeout)

指定者:

setTimeout 在接口中 Emulator<T extends NewFileIO>

参数:

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()

从接口复制的说明: Emulator

是否正在运行

指定者:

isRunning 在接口中 Emulator<T extends NewFileIO>

getThreadDispatcher

public ThreadDispatcher getThreadDispatcher()

指定者:

getThreadDispatcher 在接口中 Emulator<T extends NewFileIO>

emulateSignal

public boolean emulateSignal(int sig)

从接口复制的说明: Emulator

emulate signal handler

指定者:

emulateSignal 在接口中 Emulator<T extends NewFileIO>

参数:

sig - signal number

返回:

true means called handler function.

runMainForResult

protected final Number runMainForResult(MainTask task)

emulate

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

返回:

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

抛出:

PopContextException

getStackPointer

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

close

public final void close()
                 throws IOException

指定者:

close 在接口中 Closeable

指定者:

close 在接口中 AutoCloseable

抛出:

IOException

closeInternal

protected abstract void closeInternal()

getBackend

public Backend getBackend()

指定者:

getBackend 在接口中 Emulator<T extends NewFileIO>

getProcessName

public String getProcessName()

指定者:

getProcessName 在接口中 Emulator<T extends NewFileIO>

set

public void set(String key,
                Object value)

指定者:

set 在接口中 Emulator<T extends NewFileIO>

get

public <V> V get(String key)

指定者:

get 在接口中 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

指定者:

serialize 在接口中 Serializable

抛出:

IOException

pushContext

public void pushContext(int off)

指定者:

pushContext 在接口中 Emulator<T extends NewFileIO>

popContext

public int popContext()

指定者:

popContext 在接口中 Emulator<T extends NewFileIO>