mirror of https://github.com/pwndbg/pwndbg.git
You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
516 lines
12 KiB
Python
516 lines
12 KiB
Python
"""
|
|
Talks to an XMLRPC server running inside of an active IDA Pro instance,
|
|
in order to query it about the database. Allows symbol resolution and
|
|
interactive debugging.
|
|
"""
|
|
import errno
|
|
import functools
|
|
import socket
|
|
import sys
|
|
import time
|
|
import traceback
|
|
import xmlrpc.client
|
|
from typing import Any
|
|
from typing import Dict
|
|
from typing import List
|
|
from typing import Optional
|
|
|
|
import gdb
|
|
|
|
import pwndbg.decorators
|
|
import pwndbg.gdblib.arch
|
|
import pwndbg.gdblib.config
|
|
import pwndbg.gdblib.elf
|
|
import pwndbg.gdblib.events
|
|
import pwndbg.gdblib.memory
|
|
import pwndbg.gdblib.regs
|
|
import pwndbg.lib.memoize
|
|
from pwndbg.color import message
|
|
|
|
ida_rpc_host = pwndbg.gdblib.config.add_param(
|
|
"ida-rpc-host", "127.0.0.1", "ida xmlrpc server address"
|
|
)
|
|
ida_rpc_port = pwndbg.gdblib.config.add_param("ida-rpc-port", 31337, "ida xmlrpc server port")
|
|
ida_enabled = pwndbg.gdblib.config.add_param(
|
|
"ida-enabled", False, "whether to enable ida integration"
|
|
)
|
|
ida_timeout = pwndbg.gdblib.config.add_param(
|
|
"ida-timeout", 2, "time to wait for ida xmlrpc in seconds"
|
|
)
|
|
|
|
xmlrpc.client.Marshaller.dispatch[int] = lambda _, v, w: w("<value><i8>%d</i8></value>" % v)
|
|
|
|
xmlrpc.client.Marshaller.dispatch[type(0)] = lambda _, v, w: w("<value><i8>%d</i8></value>" % v)
|
|
|
|
_ida = None
|
|
|
|
# to avoid printing the same exception multiple times, we store the last exception here
|
|
_ida_last_exception = None
|
|
|
|
# to avoid checking the connection multiple times with no delay, we store the last time we checked it
|
|
_ida_last_connection_check = 0
|
|
|
|
|
|
@pwndbg.decorators.only_after_first_prompt()
|
|
@pwndbg.gdblib.config.trigger(ida_rpc_host, ida_rpc_port, ida_enabled, ida_timeout)
|
|
def init_ida_rpc_client() -> None:
|
|
global _ida, _ida_last_exception, _ida_last_connection_check
|
|
|
|
if not ida_enabled:
|
|
return
|
|
|
|
now = time.time()
|
|
if _ida is None and (now - _ida_last_connection_check) < int(ida_timeout) + 5:
|
|
return
|
|
|
|
addr = "http://{host}:{port}".format(host=ida_rpc_host, port=ida_rpc_port)
|
|
|
|
_ida = xmlrpc.client.ServerProxy(addr)
|
|
socket.setdefaulttimeout(int(ida_timeout))
|
|
|
|
exception = None # (type, value, traceback)
|
|
try:
|
|
_ida.here()
|
|
print(message.success("Pwndbg successfully connected to Ida Pro xmlrpc: %s" % addr))
|
|
except TimeoutError:
|
|
exception = sys.exc_info()
|
|
_ida = None
|
|
except OSError as e:
|
|
if e.errno != errno.ECONNREFUSED:
|
|
exception = sys.exc_info()
|
|
_ida = None
|
|
except xmlrpc.client.ProtocolError:
|
|
exception = sys.exc_info()
|
|
_ida = None
|
|
|
|
if exception:
|
|
if (
|
|
not isinstance(_ida_last_exception, exception[0])
|
|
or _ida_last_exception.args != exception[1].args
|
|
):
|
|
if (
|
|
hasattr(pwndbg.gdblib.config, "exception_verbose")
|
|
and pwndbg.gdblib.config.exception_verbose
|
|
):
|
|
print(message.error("[!] Ida Pro xmlrpc error"))
|
|
traceback.print_exception(*exception)
|
|
else:
|
|
exc_type, exc_value, _ = exception
|
|
print(
|
|
message.error(
|
|
"Failed to connect to IDA Pro ({}: {})".format(
|
|
exc_type.__qualname__, exc_value
|
|
)
|
|
)
|
|
)
|
|
if exc_type is socket.timeout:
|
|
print(
|
|
message.notice("To increase the time to wait for IDA Pro use `")
|
|
+ message.hint("set ida-timeout <new-timeout-in-seconds>")
|
|
+ message.notice("`")
|
|
)
|
|
else:
|
|
print(
|
|
message.notice("For more info invoke `")
|
|
+ message.hint("set exception-verbose on")
|
|
+ message.notice("`")
|
|
)
|
|
print(
|
|
message.notice("To disable IDA Pro integration invoke `")
|
|
+ message.hint("set ida-enabled off")
|
|
+ message.notice("`")
|
|
)
|
|
|
|
_ida_last_exception = exception and exception[1]
|
|
_ida_last_connection_check = now
|
|
|
|
|
|
class withIDA:
|
|
def __init__(self, fn) -> None:
|
|
self.fn = fn
|
|
functools.update_wrapper(self, fn)
|
|
|
|
def __call__(self, *args: Any, **kwargs: Any) -> Optional[Any]:
|
|
if _ida is None:
|
|
init_ida_rpc_client()
|
|
if _ida is not None:
|
|
return self.fn(*args, **kwargs)
|
|
return None
|
|
|
|
|
|
def withHexrays(f):
|
|
@withIDA
|
|
@functools.wraps(f)
|
|
def wrapper(*a, **kw):
|
|
if _ida.init_hexrays_plugin():
|
|
return f(*a, **kw)
|
|
|
|
return wrapper
|
|
|
|
|
|
def takes_address(function):
|
|
@functools.wraps(function)
|
|
def wrapper(address, *args, **kwargs):
|
|
return function(l2r(address), *args, **kwargs)
|
|
|
|
return wrapper
|
|
|
|
|
|
def returns_address(function):
|
|
@functools.wraps(function)
|
|
def wrapper(*args, **kwargs):
|
|
return r2l(function(*args, **kwargs))
|
|
|
|
return wrapper
|
|
|
|
|
|
@pwndbg.lib.memoize.reset_on_stop
|
|
def available() -> bool:
|
|
if not ida_enabled:
|
|
return False
|
|
return can_connect()
|
|
|
|
|
|
@withIDA
|
|
def can_connect() -> bool:
|
|
return True
|
|
|
|
|
|
def l2r(addr):
|
|
exe = pwndbg.gdblib.elf.exe()
|
|
if not exe:
|
|
raise Exception("Can't find EXE base")
|
|
result = (addr - int(exe.address) + base()) & pwndbg.gdblib.arch.ptrmask
|
|
return result
|
|
|
|
|
|
def r2l(addr):
|
|
exe = pwndbg.gdblib.elf.exe()
|
|
if not exe:
|
|
raise Exception("Can't find EXE base")
|
|
result = (addr - base() + int(exe.address)) & pwndbg.gdblib.arch.ptrmask
|
|
return result
|
|
|
|
|
|
def remote(function) -> None:
|
|
"""Runs the provided function in IDA's interpreter.
|
|
|
|
The function must be self-contained and not reference any
|
|
global variables."""
|
|
|
|
|
|
@pwndbg.lib.memoize.reset_on_objfile
|
|
def base():
|
|
segaddr: int = _ida.get_next_seg(0)
|
|
base: int = _ida.get_fileregion_offset(segaddr)
|
|
|
|
return segaddr - base
|
|
|
|
|
|
@withIDA
|
|
@takes_address
|
|
def Comment(addr):
|
|
return _ida.get_cmt(addr, 0) or _ida.get_cmt(addr)
|
|
|
|
|
|
@withIDA
|
|
@takes_address
|
|
@pwndbg.lib.memoize.reset_on_objfile
|
|
def Name(addr):
|
|
return _ida.get_name(addr, 0x1) # GN_VISIBLE
|
|
|
|
|
|
@withIDA
|
|
@takes_address
|
|
@pwndbg.lib.memoize.reset_on_objfile
|
|
def GetFuncOffset(addr):
|
|
rv = _ida.get_func_off_str(addr)
|
|
return rv
|
|
|
|
|
|
@withIDA
|
|
@takes_address
|
|
@pwndbg.lib.memoize.reset_on_objfile
|
|
def GetType(addr):
|
|
rv = _ida.get_type(addr)
|
|
return rv
|
|
|
|
|
|
@withIDA
|
|
@returns_address
|
|
def here():
|
|
return _ida.here()
|
|
|
|
|
|
@withIDA
|
|
@takes_address
|
|
def Jump(addr):
|
|
# uses C++ api instead of idc one to avoid activating the IDA window
|
|
return _ida.jumpto(addr, -1, 0)
|
|
|
|
|
|
@withIDA
|
|
@takes_address
|
|
@pwndbg.lib.memoize.reset_on_objfile
|
|
def Anterior(addr):
|
|
hexrays_prefix = b"\x01\x04; "
|
|
lines = []
|
|
for i in range(10):
|
|
r: Optional[bytes] = _ida.get_extra_cmt(addr, 0x3E8 + i) # E_PREV
|
|
if not r:
|
|
break
|
|
if r.startswith(hexrays_prefix):
|
|
r = r[len(hexrays_prefix) :]
|
|
lines.append(r)
|
|
return b"\n".join(lines)
|
|
|
|
|
|
@withIDA
|
|
def GetBreakpoints():
|
|
for i in range(GetBptQty()):
|
|
yield GetBptEA(i)
|
|
|
|
|
|
@withIDA
|
|
def GetBptQty():
|
|
return _ida.get_bpt_qty()
|
|
|
|
|
|
@withIDA
|
|
@returns_address
|
|
def GetBptEA(i):
|
|
return _ida.get_bpt_ea(i)
|
|
|
|
|
|
_breakpoints: List[gdb.Breakpoint] = []
|
|
|
|
|
|
@pwndbg.gdblib.events.cont
|
|
@pwndbg.gdblib.events.stop
|
|
@withIDA
|
|
def UpdateBreakpoints() -> None:
|
|
# XXX: Remove breakpoints from IDA when the user removes them.
|
|
current = set(eval(b.location.lstrip("*")) for b in _breakpoints)
|
|
want = set(GetBreakpoints())
|
|
|
|
for addr in current - want:
|
|
for bp in _breakpoints:
|
|
if int(bp.location.lstrip("*"), 0) == addr:
|
|
bp.delete()
|
|
break
|
|
_breakpoints.remove(bp)
|
|
|
|
for addr in want - current:
|
|
if not pwndbg.gdblib.memory.peek(addr):
|
|
continue
|
|
|
|
bp = gdb.Breakpoint("*" + hex(int(addr)))
|
|
_breakpoints.append(bp)
|
|
|
|
|
|
@withIDA
|
|
@takes_address
|
|
def SetColor(pc, color):
|
|
return _ida.set_color(pc, 1, color)
|
|
|
|
|
|
colored_pc = None
|
|
|
|
|
|
@pwndbg.gdblib.events.stop
|
|
@withIDA
|
|
def Auto_Color_PC() -> None:
|
|
global colored_pc
|
|
colored_pc = pwndbg.gdblib.regs.pc
|
|
SetColor(colored_pc, 0x7F7FFF)
|
|
|
|
|
|
@pwndbg.gdblib.events.cont
|
|
@withIDA
|
|
def Auto_UnColor_PC() -> None:
|
|
global colored_pc
|
|
if colored_pc:
|
|
SetColor(colored_pc, 0xFFFFFF)
|
|
colored_pc = None
|
|
|
|
|
|
@withIDA
|
|
@returns_address
|
|
@pwndbg.lib.memoize.reset_on_objfile
|
|
def LocByName(name):
|
|
return _ida.get_name_ea_simple(str(name))
|
|
|
|
|
|
@withIDA
|
|
@takes_address
|
|
@returns_address
|
|
@pwndbg.lib.memoize.reset_on_objfile
|
|
def PrevHead(addr):
|
|
return _ida.prev_head(addr)
|
|
|
|
|
|
@withIDA
|
|
@takes_address
|
|
@returns_address
|
|
@pwndbg.lib.memoize.reset_on_objfile
|
|
def NextHead(addr):
|
|
return _ida.next_head(addr)
|
|
|
|
|
|
@withIDA
|
|
@takes_address
|
|
@pwndbg.lib.memoize.reset_on_objfile
|
|
def GetFunctionName(addr):
|
|
return _ida.get_func_name(addr)
|
|
|
|
|
|
@withIDA
|
|
@takes_address
|
|
@pwndbg.lib.memoize.reset_on_objfile
|
|
def GetFlags(addr):
|
|
return _ida.get_full_flags(addr)
|
|
|
|
|
|
@withIDA
|
|
@pwndbg.lib.memoize.reset_on_objfile
|
|
def isASCII(flags):
|
|
return _ida.is_strlit(flags)
|
|
|
|
|
|
@withIDA
|
|
@takes_address
|
|
@pwndbg.lib.memoize.reset_on_objfile
|
|
def ArgCount(address) -> None:
|
|
pass
|
|
|
|
|
|
@withIDA
|
|
def SaveBase(path: str):
|
|
return _ida.save_database(path)
|
|
|
|
|
|
@withIDA
|
|
def GetIdbPath():
|
|
return _ida.get_idb_path()
|
|
|
|
|
|
@takes_address
|
|
@pwndbg.lib.memoize.reset_on_stop
|
|
def has_cached_cfunc(addr):
|
|
return _ida.has_cached_cfunc(addr)
|
|
|
|
|
|
@withHexrays
|
|
@takes_address
|
|
@pwndbg.lib.memoize.reset_on_stop
|
|
def decompile(addr):
|
|
return _ida.decompile(addr)
|
|
|
|
|
|
@withHexrays
|
|
@takes_address
|
|
@pwndbg.lib.memoize.reset_on_stop
|
|
def decompile_context(pc, context_lines):
|
|
return _ida.decompile_context(pc, context_lines)
|
|
|
|
|
|
@withIDA
|
|
@pwndbg.lib.memoize.forever
|
|
def get_ida_versions():
|
|
return _ida.versions()
|
|
|
|
|
|
@withIDA
|
|
@pwndbg.lib.memoize.reset_on_stop
|
|
def GetStrucQty():
|
|
return _ida.get_struc_qty()
|
|
|
|
|
|
@withIDA
|
|
@pwndbg.lib.memoize.reset_on_stop
|
|
def GetStrucId(idx):
|
|
return _ida.get_struc_by_idx(idx)
|
|
|
|
|
|
@withIDA
|
|
@pwndbg.lib.memoize.reset_on_stop
|
|
def GetStrucName(sid):
|
|
return _ida.get_struc_name(sid)
|
|
|
|
|
|
@withIDA
|
|
@pwndbg.lib.memoize.reset_on_stop
|
|
def GetStrucSize(sid):
|
|
return _ida.get_struc_size(sid)
|
|
|
|
|
|
@withIDA
|
|
@pwndbg.lib.memoize.reset_on_stop
|
|
def GetMemberQty(sid):
|
|
return _ida.get_member_qty(sid)
|
|
|
|
|
|
@withIDA
|
|
@pwndbg.lib.memoize.reset_on_stop
|
|
def GetMemberSize(sid, offset):
|
|
return _ida.get_member_size(sid, offset)
|
|
|
|
|
|
@withIDA
|
|
@pwndbg.lib.memoize.reset_on_stop
|
|
def GetMemberId(sid, offset):
|
|
return _ida.get_member_id(sid, offset)
|
|
|
|
|
|
@withIDA
|
|
@pwndbg.lib.memoize.reset_on_stop
|
|
def GetMemberName(sid, offset):
|
|
return _ida.get_member_name(sid, offset)
|
|
|
|
|
|
@withIDA
|
|
@pwndbg.lib.memoize.reset_on_stop
|
|
def GetMemberFlag(sid, offset):
|
|
return _ida.get_member_flag(sid, offset)
|
|
|
|
|
|
@withIDA
|
|
@pwndbg.lib.memoize.reset_on_stop
|
|
def GetStrucNextOff(sid, offset):
|
|
return _ida.get_next_offset(sid, offset)
|
|
|
|
|
|
class IDC:
|
|
query = "{k:v for k,v in globals()['idc'].__dict__.items() if type(v) in (int,long)}"
|
|
|
|
def __init__(self) -> None:
|
|
if available():
|
|
data: Dict = _ida.eval(self.query)
|
|
self.__dict__.update(data)
|
|
|
|
|
|
idc = IDC()
|
|
|
|
|
|
def print_member(sid, offset) -> None:
|
|
mid = GetMemberId(sid, offset)
|
|
mname = GetMemberName(sid, offset) or "(no name)"
|
|
msize = GetMemberSize(sid, offset) or 0
|
|
mflag = GetMemberFlag(sid, offset) or 0
|
|
print(" +%#x - %s [%#x bytes]" % (offset, mname, msize))
|
|
|
|
|
|
def print_structs() -> None:
|
|
for i in range(GetStrucQty() or 0):
|
|
sid = GetStrucId(i)
|
|
|
|
name = GetStrucName(sid)
|
|
size = GetStrucSize(sid)
|
|
|
|
print("%s - %#x bytes" % (name, size))
|
|
|
|
offset = 0
|
|
while offset < size:
|
|
print_member(sid, offset)
|
|
offset = GetStrucNextOff(sid, offset)
|