mirror of
https://github.com/cemu-project/idapython.git
synced 2024-12-29 03:01:52 +01:00
idc.py: Implemented many debugging-related functions
idc.py: Misc fixes and cleanups
This commit is contained in:
gergely.erdelyi
parent
23dcd0a165
commit
7d0f743143
387
python/idc.py
387
python/idc.py
@ -339,9 +339,10 @@ def rotate_left(value, count, nbits, offset):
|
||||
|
||||
return value
|
||||
|
||||
def rotate_dword(x, count): rotate_left(x, count, 32, 0)
|
||||
def rotate_word(x, count): rotate_left(x, count, 16, 0)
|
||||
def rotate_byte(x, count): rotate_left(x, count, 8, 0)
|
||||
|
||||
def rotate_dword(x, count): return rotate_left(x, count, 32, 0)
|
||||
def rotate_word(x, count): return rotate_left(x, count, 16, 0)
|
||||
def rotate_byte(x, count): return rotate_left(x, count, 8, 0)
|
||||
|
||||
|
||||
# AddHotkey return codes
|
||||
@ -5976,14 +5977,16 @@ PT_PAK4 = 0x0030 # #pragma pack(4)
|
||||
PT_PAK8 = 0x0040 # #pragma pack(8)
|
||||
PT_PAK16 = 0x0050 # #pragma pack(16)
|
||||
|
||||
def GetMaxLocalType():
|
||||
"""
|
||||
Get number of local types + 1
|
||||
|
||||
@return: value >= 1. 1 means that there are no local types.
|
||||
"""
|
||||
return idaapi.get_ordinal_qty(idaapi.cvar.idati)
|
||||
|
||||
|
||||
"""
|
||||
// ***********************************************
|
||||
// ** Get number of local types + 1
|
||||
// returns: value >= 1. 1 means that there are no local types.
|
||||
|
||||
long GetMaxLocalType(void);
|
||||
|
||||
|
||||
// ***********************************************
|
||||
// ** Parse one type declaration and store it in the specified slot
|
||||
// ordinal - slot number (1...NumberOfLocalTypes)
|
||||
@ -6008,15 +6011,19 @@ string GetLocalType(long ordinal, long flags);
|
||||
#define PRTYPE_TYPE 0x0002 // print type declaration (not variable declaration)
|
||||
#define PRTYPE_PRAGMA 0x0004 // print pragmas for alignment
|
||||
#ifdef _notdefinedsymbol
|
||||
|
||||
|
||||
// ***********************************************
|
||||
// ** Retrieve a local type name
|
||||
// ordinal - slot number (1...NumberOfLocalTypes)
|
||||
// returns: local type name or ""
|
||||
|
||||
string GetLocalTypeName(long ordinal);
|
||||
"""
|
||||
|
||||
|
||||
def GetLocalTypeName(ordinal):
|
||||
"""
|
||||
Retrieve a local type name
|
||||
|
||||
@param ordinal: slot number (1...NumberOfLocalTypes)
|
||||
|
||||
returns: local type name or None
|
||||
"""
|
||||
return idaapi.get_numbered_type_name(idaapi.cvar.idati, ordinal)
|
||||
|
||||
# ----------------------------------------------------------------------------
|
||||
# H I D D E N A R E A S
|
||||
# ----------------------------------------------------------------------------
|
||||
@ -6255,29 +6262,76 @@ def ResumeThread(tid):
|
||||
return idaapi.resume_thread(tid)
|
||||
|
||||
|
||||
"""
|
||||
// Enumerate process modules
|
||||
// These function return the module base address
|
||||
|
||||
long GetFirstModule(void);
|
||||
long GetNextModule(long base);
|
||||
def _get_modules():
|
||||
"""
|
||||
INTERNAL: Enumerate process modules
|
||||
"""
|
||||
module = idaapi.module_info_t()
|
||||
result = idaapi.get_first_module(module)
|
||||
while result:
|
||||
yield module
|
||||
result = idaapi.get_next_module(module)
|
||||
|
||||
|
||||
// ***********************************************
|
||||
// Get process module name
|
||||
// base - the base address of the module
|
||||
// returns: required info or 0
|
||||
def GetFirstModule():
|
||||
"""
|
||||
Enumerate process modules
|
||||
|
||||
string GetModuleName(long base);
|
||||
@return: first module's base address or None on failure
|
||||
"""
|
||||
for module in _get_modules():
|
||||
return module.base
|
||||
else:
|
||||
return None
|
||||
|
||||
|
||||
// ***********************************************
|
||||
// Get process module size
|
||||
// base - the base address of the module
|
||||
// returns: required info or -1
|
||||
def GetNextModule(base):
|
||||
"""
|
||||
Enumerate process modules
|
||||
|
||||
@param base: previous module's base address
|
||||
|
||||
@return: next module's base address or None on failure
|
||||
"""
|
||||
foundit = False
|
||||
for module in _get_modules():
|
||||
if foundit:
|
||||
return module.base
|
||||
if module.base == base:
|
||||
foundit = True
|
||||
else:
|
||||
return None
|
||||
|
||||
|
||||
def GetModuleName(base):
|
||||
"""
|
||||
Get process module name
|
||||
|
||||
@param base: the base address of the module
|
||||
|
||||
@return: required info or 0
|
||||
"""
|
||||
for module in _get_modules():
|
||||
if module.base == base:
|
||||
return module.name
|
||||
else:
|
||||
return 0
|
||||
|
||||
|
||||
def GetModuleSize(base):
|
||||
"""
|
||||
Get process module size
|
||||
|
||||
@param base: the base address of the module
|
||||
|
||||
@return: required info or -1
|
||||
"""
|
||||
for module in _get_modules():
|
||||
if module.base == base:
|
||||
return module.size
|
||||
else:
|
||||
return -1
|
||||
|
||||
long GetModuleSize(long base);
|
||||
"""
|
||||
|
||||
def StepInto():
|
||||
"""
|
||||
@ -6331,52 +6385,55 @@ def StepUntilRet():
|
||||
return idaapi.step_until_ret()
|
||||
|
||||
|
||||
def GetDebuggerEvent(wfne, timeout):
|
||||
"""
|
||||
Wait for the next event
|
||||
This function (optionally) resumes the process
|
||||
execution and wait for a debugger event until timeout
|
||||
|
||||
@param wfne: combination of WFNE_... constants
|
||||
@param timeout: number of seconds to wait, -1-infinity
|
||||
|
||||
@return: debugger event codes, see below
|
||||
"""
|
||||
return idaapi.wait_for_next_even(wfne, timeout)
|
||||
|
||||
|
||||
def ResumeProcess(): return GetDebuggerEvent(WFNE_CONT|WFNE_NOWAIT, 0)
|
||||
|
||||
|
||||
# wfne flag is combination of the following:
|
||||
WFNE_ANY = 0x0001 # return the first event (even if it doesn't suspend the process)
|
||||
# if the process is still running, the database
|
||||
# does not reflect the memory state. you might want
|
||||
# to call RefreshDebuggerMemory() in this case
|
||||
WFNE_SUSP = 0x0002 # wait until the process gets suspended
|
||||
WFNE_SILENT = 0x0004 # 1: be slient, 0:display modal boxes if necessary
|
||||
WFNE_CONT = 0x0008 # continue from the suspended state
|
||||
WFNE_NOWAIT = 0x0010 # do not wait for any event, immediately return DEC_TIMEOUT
|
||||
# (to be used with WFNE_CONT)
|
||||
|
||||
# debugger event codes
|
||||
NOTASK = -2 # process does not exist
|
||||
DBG_ERROR = -1 # error (e.g. network problems)
|
||||
DBG_TIMEOUT = 0 # timeout
|
||||
PROCESS_START = 0x00000001 # New process started
|
||||
PROCESS_EXIT = 0x00000002 # Process stopped
|
||||
THREAD_START = 0x00000004 # New thread started
|
||||
THREAD_EXIT = 0x00000008 # Thread stopped
|
||||
BREAKPOINT = 0x00000010 # Breakpoint reached
|
||||
STEP = 0x00000020 # One instruction executed
|
||||
EXCEPTION = 0x00000040 # Exception
|
||||
LIBRARY_LOAD = 0x00000080 # New library loaded
|
||||
LIBRARY_UNLOAD = 0x00000100 # Library unloaded
|
||||
INFORMATION = 0x00000200 # User-defined information
|
||||
SYSCALL = 0x00000400 # Syscall (not used yet)
|
||||
WINMESSAGE = 0x00000800 # Window message (not used yet)
|
||||
PROCESS_ATTACH = 0x00001000 # Attached to running process
|
||||
PROCESS_DETACH = 0x00002000 # Detached from process
|
||||
|
||||
|
||||
"""
|
||||
// ***********************************************
|
||||
// Wait for the next event
|
||||
// This function (optionally) resumes the process
|
||||
// execution and wait for a debugger event until timeout
|
||||
// wfne - combination of WFNE_... constants
|
||||
// timeout - number of seconds to wait, -1-infinity
|
||||
// returns: debugger event codes, see below
|
||||
|
||||
long GetDebuggerEvent(long wfne, long timeout);
|
||||
|
||||
#endif
|
||||
// convenience function
|
||||
#define ResumeProcess() GetDebuggerEvent(WFNE_CONT|WFNE_NOWAIT, 0)
|
||||
// wfne flag is combination of the following:
|
||||
#define WFNE_ANY 0x0001 // return the first event (even if it doesn't suspend the process)
|
||||
// if the process is still running, the database
|
||||
// does not reflect the memory state. you might want
|
||||
// to call RefreshDebuggerMemory() in this case
|
||||
#define WFNE_SUSP 0x0002 // wait until the process gets suspended
|
||||
#define WFNE_SILENT 0x0004 // 1: be slient, 0:display modal boxes if necessary
|
||||
#define WFNE_CONT 0x0008 // continue from the suspended state
|
||||
#define WFNE_NOWAIT 0x0010 // do not wait for any event, immediately return DEC_TIMEOUT
|
||||
// (to be used with WFNE_CONT)
|
||||
|
||||
// debugger event codes
|
||||
#define NOTASK -2 // process does not exist
|
||||
#define DBG_ERROR -1 // error (e.g. network problems)
|
||||
#define DBG_TIMEOUT 0 // timeout
|
||||
#define PROCESS_START 0x00000001 // New process started
|
||||
#define PROCESS_EXIT 0x00000002 // Process stopped
|
||||
#define THREAD_START 0x00000004 // New thread started
|
||||
#define THREAD_EXIT 0x00000008 // Thread stopped
|
||||
#define BREAKPOINT 0x00000010 // Breakpoint reached
|
||||
#define STEP 0x00000020 // One instruction executed
|
||||
#define EXCEPTION 0x00000040 // Exception
|
||||
#define LIBRARY_LOAD 0x00000080 // New library loaded
|
||||
#define LIBRARY_UNLOAD 0x00000100 // Library unloaded
|
||||
#define INFORMATION 0x00000200 // User-defined information
|
||||
#define SYSCALL 0x00000400 // Syscall (not used yet)
|
||||
#define WINMESSAGE 0x00000800 // Window message (not used yet)
|
||||
#define PROCESS_ATTACH 0x00001000 // Attached to running process
|
||||
#define PROCESS_DETACH 0x00002000 // Detached from process
|
||||
#ifdef _notdefinedsymbol
|
||||
|
||||
|
||||
// ***********************************************
|
||||
// Refresh debugger memory
|
||||
// Upon this call IDA will forget all cached information
|
||||
@ -6397,25 +6454,26 @@ void RefreshDebuggerMemory(void);
|
||||
// 1-copy only SFL_LOADER segments
|
||||
|
||||
success TakeMemorySnapshot(long only_loader_segs);
|
||||
"""
|
||||
|
||||
|
||||
// ***********************************************
|
||||
// Get debugged process state
|
||||
// returns: one of the DBG_... constants (see below)
|
||||
def GetProcessState():
|
||||
"""
|
||||
Get debugged process state
|
||||
|
||||
long GetProcessState(void);
|
||||
|
||||
#endif
|
||||
#define DSTATE_SUSP_FOR_EVENT -2 // process is currently suspended to react to a debug event
|
||||
#define DSTATE_SUSP -1 // process is suspended
|
||||
#define DSTATE_NOTASK 0 // no process is currently debugged
|
||||
#define DSTATE_RUN 1 // process is running
|
||||
#define DSTATE_RUN_WAIT_ATTACH 2 // process is running, waiting for process properly attached
|
||||
#define DSTATE_RUN_WAIT_END 3 // process is running, but the user asked to kill/detach the process
|
||||
// remark: in this case, most events are ignored
|
||||
#ifdef _notdefinedsymbol
|
||||
@return: one of the DBG_... constants (see below)
|
||||
"""
|
||||
return idaapi.get_process_state()
|
||||
|
||||
DSTATE_SUSP_FOR_EVENT = -2 # process is currently suspended to react to a debug event
|
||||
DSTATE_SUSP = -1 # process is suspended
|
||||
DSTATE_NOTASK = 0 # no process is currently debugged
|
||||
DSTATE_RUN = 1 # process is running
|
||||
DSTATE_RUN_WAIT_ATTACH = 2 # process is running, waiting for process properly attached
|
||||
DSTATE_RUN_WAIT_END = 3 # process is running, but the user asked to kill/detach the process
|
||||
# remark: in this case, most events are ignored
|
||||
|
||||
"""
|
||||
// ***********************************************
|
||||
// Get various information about the current debug event
|
||||
// These function are valid only when the current event exists
|
||||
@ -6448,45 +6506,52 @@ long GetEventExceptionCode(void);
|
||||
long GetEventExceptionEa(void);
|
||||
long CanExceptionContinue(void);
|
||||
string GetEventExceptionInfo(void);
|
||||
"""
|
||||
|
||||
def SetDebuggerOptions(opt):
|
||||
"""
|
||||
Get/set debugger options
|
||||
|
||||
@param opt: combination of DOPT_... constants
|
||||
|
||||
@return: old options
|
||||
"""
|
||||
return idaapi.set_debugger_options(opt)
|
||||
|
||||
|
||||
// ***********************************************
|
||||
// Get/set debugger options
|
||||
// opt - combination of DOPT_... constants
|
||||
// returns: old options
|
||||
DOPT_SEGM_MSGS = 0x00000001 # print messages on debugger segments modifications
|
||||
DOPT_START_BPT = 0x00000002 # break on process start
|
||||
DOPT_THREAD_MSGS = 0x00000004 # print messages on thread start/exit
|
||||
DOPT_THREAD_BPT = 0x00000008 # break on thread start/exit
|
||||
DOPT_BPT_MSGS = 0x00000010 # print message on breakpoint
|
||||
DOPT_LIB_MSGS = 0x00000040 # print message on library load/unlad
|
||||
DOPT_LIB_BPT = 0x00000080 # break on library load/unlad
|
||||
DOPT_INFO_MSGS = 0x00000100 # print message on debugging information
|
||||
DOPT_INFO_BPT = 0x00000200 # break on debugging information
|
||||
DOPT_REAL_MEMORY = 0x00000400 # don't hide breakpoint instructions
|
||||
DOPT_REDO_STACK = 0x00000800 # reconstruct the stack
|
||||
DOPT_ENTRY_BPT = 0x00001000 # break on program entry point
|
||||
DOPT_EXCDLG = 0x00006000 # exception dialogs:
|
||||
|
||||
long SetDebuggerOptions(long opt);
|
||||
#endif
|
||||
#define DOPT_SEGM_MSGS 0x00000001 // print messages on debugger segments modifications
|
||||
#define DOPT_START_BPT 0x00000002 // break on process start
|
||||
#define DOPT_THREAD_MSGS 0x00000004 // print messages on thread start/exit
|
||||
#define DOPT_THREAD_BPT 0x00000008 // break on thread start/exit
|
||||
#define DOPT_BPT_MSGS 0x00000010 // print message on breakpoint
|
||||
#define DOPT_LIB_MSGS 0x00000040 // print message on library load/unlad
|
||||
#define DOPT_LIB_BPT 0x00000080 // break on library load/unlad
|
||||
#define DOPT_INFO_MSGS 0x00000100 // print message on debugging information
|
||||
#define DOPT_INFO_BPT 0x00000200 // break on debugging information
|
||||
#define DOPT_REAL_MEMORY 0x00000400 // don't hide breakpoint instructions
|
||||
#define DOPT_REDO_STACK 0x00000800 // reconstruct the stack
|
||||
#define DOPT_ENTRY_BPT 0x00001000 // break on program entry point
|
||||
#define DOPT_EXCDLG 0x00006000 // exception dialogs:
|
||||
# define EXCDLG_NEVER 0x00000000 // never display exception dialogs
|
||||
# define EXCDLG_UNKNOWN 0x00002000 // display for unknown exceptions
|
||||
# define EXCDLG_ALWAYS 0x00006000 // always display
|
||||
#ifdef _notdefinedsymbol
|
||||
EXCDLG_NEVER = 0x00000000 # never display exception dialogs
|
||||
EXCDLG_UNKNOWN = 0x00002000 # display for unknown exceptions
|
||||
EXCDLG_ALWAYS = 0x00006000 # always display
|
||||
|
||||
|
||||
// ***********************************************
|
||||
// Set remote debugging options
|
||||
// hostname - remote host name or address
|
||||
// if empty, revert to local debugger
|
||||
// password - password for the debugger server
|
||||
// portnum - port number to connect (-1: don't change)
|
||||
// returns: nothing
|
||||
def SetRemoteDebugger(hostname, password, portnum):
|
||||
"""
|
||||
Set remote debugging options
|
||||
|
||||
@param hostname: remote host name or address if empty, revert to local debugger
|
||||
@param password: password for the debugger server
|
||||
@param portnum: port number to connect (-1: don't change)
|
||||
|
||||
void SetRemoteDebugger(string hostname, string password, long portnum);
|
||||
@return: nothing
|
||||
"""
|
||||
return idaapi.set_remote_debugger(hostname, password, portnum)
|
||||
|
||||
|
||||
"""
|
||||
// ***********************************************
|
||||
// Get number of defined exception codes
|
||||
|
||||
@ -6507,23 +6572,26 @@ long GetExceptionCode(long idx);
|
||||
|
||||
string GetExceptionName(long code); // returns "" on error
|
||||
long GetExceptionFlags(long code); // returns -1 on error
|
||||
"""
|
||||
|
||||
def DefineException(code, name, desc, flags):
|
||||
"""
|
||||
Add exception handling information
|
||||
|
||||
@param code: exception code
|
||||
@param name: exception name
|
||||
@param desc: exception description
|
||||
@param flags: exception flags (combination of EXC_...)
|
||||
|
||||
@return: failure description or ""
|
||||
"""
|
||||
return idaapi.define_exception(code, name, desc, flags)
|
||||
|
||||
EXC_BREAK = 0x0001 # break on the exception
|
||||
EXC_HANDLE = 0x0002 # should be handled by the debugger?
|
||||
|
||||
|
||||
// ***********************************************
|
||||
// Add exception handling information
|
||||
// code - exception code
|
||||
// name - exception name
|
||||
// desc - exception description
|
||||
// flags - exception flags (combination of EXC_...)
|
||||
// returns: failure description or ""
|
||||
|
||||
string DefineException(long code, string name, string desc, long flags);
|
||||
#endif
|
||||
#define EXC_BREAK 0x0001 // break on the exception
|
||||
#define EXC_HANDLE 0x0002 // should be handled by the debugger?
|
||||
#ifdef _notdefinedsymbol
|
||||
|
||||
|
||||
"""
|
||||
// ***********************************************
|
||||
// Set exception flags
|
||||
// code - exception code
|
||||
@ -6736,20 +6804,33 @@ def EnableBpt(ea, enable):
|
||||
"""
|
||||
return idaapi.enable_bpt(ea, enable)
|
||||
|
||||
"""
|
||||
// Enable step tracing
|
||||
// trace_level - what kind of trace to modify
|
||||
// enable - 0: turn off, 1: turn on
|
||||
// Returns: success
|
||||
|
||||
success EnableTracing(long trace_level, long enable);
|
||||
def EnableTracing(trace_level, enable):
|
||||
"""
|
||||
Enable step tracing
|
||||
|
||||
#endif
|
||||
#define TRACE_STEP 0x0 // lowest level trace. trace buffers are not maintained
|
||||
#define TRACE_INSN 0x1 // instruction level trace
|
||||
#define TRACE_FUNC 0x2 // function level trace (calls & rets)
|
||||
#ifdef _notdefinedsymbol
|
||||
"""
|
||||
@param trace_level: what kind of trace to modify
|
||||
@param enable: 0: turn off, 1: turn on
|
||||
|
||||
@return: success
|
||||
"""
|
||||
assert trace_level in [ TRACE_STEP, TRACE_INSN, TRACE_FUNC ], \
|
||||
"trace_level must be one of TRACE_* constants"
|
||||
|
||||
if trace_level == TRACE_STEP:
|
||||
return idaapi.enable_step_trace(enable)
|
||||
|
||||
if trace_level == TRACE_INSN:
|
||||
return idaapi.enable_insn_trace(enable)
|
||||
|
||||
if trace_level == TRACE_FUNC:
|
||||
return idaapi.enable_func_trace(enable)
|
||||
|
||||
return False
|
||||
|
||||
TRACE_STEP = 0x0 # lowest level trace. trace buffers are not maintained
|
||||
TRACE_INSN = 0x1 # instruction level trace
|
||||
TRACE_FUNC = 0x2 # function level trace (calls & rets)
|
||||
|
||||
#--------------------------------------------------------------------------
|
||||
# C O L O R S
|
||||
@ -6825,7 +6906,6 @@ def SetColor(ea, what, color):
|
||||
return False
|
||||
|
||||
|
||||
|
||||
#--------------------------------------------------------------------------
|
||||
# X M L
|
||||
#--------------------------------------------------------------------------
|
||||
@ -6937,5 +7017,4 @@ SEGDEL_PERM = 0x0001 # permanently, i.e. disable addresses
|
||||
SEGDEL_KEEP = 0x0002 # keep information (code & data, etc)
|
||||
SEGDEL_SILENT = 0x0004 # be silent
|
||||
|
||||
|
||||
# END OF IDC COMPATIBILY CODE
|
||||
|
||||
Loading…
Reference in New Issue
Block a user