com.github.unidbg

Interface Emulator<T extends NewFileIO>

All Superinterfaces:

ArmDisassembler, AutoCloseable, Closeable, Serializable

All Known Subinterfaces:

ARMEmulator<T>

All Known Implementing Classes:

AbstractARM64Emulator, AbstractARMEmulator, AbstractEmulator

public interface Emulator<T extends NewFileIO>
extends Closeable, ArmDisassembler, Serializable

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

Method Summary

Modifier and Type	Method and Description
Debugger	attach()
Debugger	attach(DebuggerType type)
LibraryFile	createURLibraryFile(URL url, String libName)
default String	dumpGPBProtobufDef(String className) Dump GPB (Google Protobuf for Objective-C) message definition as .proto format.
default String	dumpObjcClass(String className) Dump Objective-C class definition (properties, methods, protocols, ivars).
Number	eEntry(long begin, long sp)
Number	eFunc(long begin, Number... arguments)
boolean	emulateSignal(int sig) emulate signal handler
<V> V	get(String key)
Backend	getBackend()
<V extends RegisterContext> V	getContext()
Dlfcn	getDlfcn()
Family	getFamily()
FileSystem<T>	getFileSystem()
Memory	getMemory()
default String	getObjcClassName(long address) Get Objective-C class name for the object at the given address.
int	getPageAlign()
int	getPid()
int	getPointerSize()
String	getProcessName()
long	getReturnAddress()
SvcMemory	getSvcMemory()
SyscallHandler<T>	getSyscallHandler()
ThreadDispatcher	getThreadDispatcher()
Unwinder	getUnwinder()
boolean	is32Bit()
boolean	is64Bit()
boolean	isRunning() 是否正在运行
Module	loadLibrary(File libraryFile)
Module	loadLibrary(File libraryFile, boolean forceCallInit)
int	popContext()
void	pushContext(int off)
void	set(String key, Object value)
void	setTimeout(long timeout)
void	setTraceSystemMemoryWrite(long begin, long end, TraceSystemMemoryWriteListener listener)
void	showRegs() show all registers
void	showRegs(int... regs) show registers
TraceHook	traceCode() trace instruction note: low performance
TraceHook	traceCode(long begin, long end)
TraceHook	traceCode(long begin, long end, TraceCodeListener listener)
default MemoryTracker	traceMemoryLeaks() Start tracking memory allocations (mmap/munmap/brk) for leak detection.
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 interface java.io.Closeable

close

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

disassemble, disassemble, printAssemble

Methods inherited from interface com.github.unidbg.serialize.Serializable

serialize

Method Detail

getPointerSize

int getPointerSize()

is64Bit

boolean is64Bit()

is32Bit

boolean is32Bit()

getPageAlign

int getPageAlign()

traceRead

TraceHook traceRead()

trace memory read

traceRead

TraceHook traceRead(long begin,
                    long end)

traceRead

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

traceWrite

TraceHook traceWrite()

trace memory write

traceWrite

TraceHook traceWrite(long begin,
                     long end)

traceWrite

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

setTraceSystemMemoryWrite

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

traceCode

TraceHook traceCode()

trace instruction note: low performance

traceCode

TraceHook traceCode(long begin,
                    long end)

traceCode

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

eFunc

Number eFunc(long begin,
             Number... arguments)

eEntry

Number eEntry(long begin,
              long sp)

emulateSignal

boolean emulateSignal(int sig)

emulate signal handler

Parameters:

sig - signal number

Returns:

true means called handler function.

isRunning

boolean isRunning()

是否正在运行

showRegs

void showRegs()

show all registers

showRegs

void showRegs(int... regs)

show registers

loadLibrary

Module loadLibrary(File libraryFile)

loadLibrary

Module loadLibrary(File libraryFile,
                   boolean forceCallInit)

getMemory

Memory getMemory()

getBackend

Backend getBackend()

getPid

int getPid()

getProcessName

String getProcessName()

attach

Debugger attach()

attach

Debugger attach(DebuggerType type)

getFileSystem

FileSystem<T> getFileSystem()

getSvcMemory

SvcMemory getSvcMemory()

getSyscallHandler

SyscallHandler<T> getSyscallHandler()

getFamily

Family getFamily()

createURLibraryFile

LibraryFile createURLibraryFile(URL url,
                                String libName)

getDlfcn

Dlfcn getDlfcn()

setTimeout

void setTimeout(long timeout)

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.

getContext

<V extends RegisterContext> V getContext()

getUnwinder

Unwinder getUnwinder()

traceMemoryLeaks

default MemoryTracker traceMemoryLeaks()

Start tracking memory allocations (mmap/munmap/brk) for leak detection. Use with try-with-resources: close() restores previous listener and prints the leak report.

pushContext

void pushContext(int off)

popContext

int popContext()

getThreadDispatcher

ThreadDispatcher getThreadDispatcher()

getReturnAddress

long getReturnAddress()

set

void set(String key,
         Object value)

get

<V> V get(String key)

getObjcClassName

default String getObjcClassName(long address)

Get Objective-C class name for the object at the given address. Reads isa pointer, applies ISA_MASK, and parses class_ro_t to get the name. Only available on iOS emulators.

dumpObjcClass

default String dumpObjcClass(String className)

Dump Objective-C class definition (properties, methods, protocols, ivars). Only available on iOS emulators with ObjC runtime loaded.

dumpGPBProtobufDef

default String dumpGPBProtobufDef(String className)

Dump GPB (Google Protobuf for Objective-C) message definition as .proto format. Only available on iOS 64-bit emulators with GPB protobuf library loaded.