tin-z / GDBleed

Dynamic-Static binary instrumentation framework on top of GDB

GDBleed

⚠️ Please note the binary instrumentation part is implemented by GDBcov, which is still a work in progress.

GDBleed - Dynamic-Static binary instrumentation framework on top of GDB

GDBleed is a gdb wrapper exposing a set of commands for x86-64, ARM and MIPS (x86 and ARM thumb-mode in progress) architectures to perform binary instrumentation. The objective was to exploit the hackish features of GDB python API, while ignoring the software performance attribute (for now). And in the end to have a user-friendly framework. GDBleed focus is applicability, then we have efficiency. The more CPU archs it does suport the better it is.

Why?

• "easy"-fast minimal static-dynamic code instrumentation supporting all main CPU archs

• Framework based on tools with a strong community support: GDB, gcc, r2, keystone, LIEF, etc.

• No control flow information is needed

• ideal for IoT devices, why?

  • no binary instrumentation for MIPS

  • cross-compilation is boring (and if it works then it will break somewhere during the execution)

  • A lot of the new IoT devices still using old linux kernel versions not supporting EBPF

Usage

• run gdb from the current folder

• Start the process using start command or attach gdb to the debugged process

• Run the command

source gdbleed.py

• For more info take a look at the tests folder

---

Usage of the hooking functionalities

• Start guide

  • For more clearance on how hooking/instrument stuff is working take a look at strategy doc section

---

Req

• Tested on ubuntu 20.04

• Dep: keystone, LIEF

Installation

• Install

# GEF gdb extension, ref https://github.com/hugsy/gef
sudo apt-get -y install unzip cmake binutils

• Declare env vars

# python's version which your gdb intalled supports
export PYTHON_VER="python3"
sudo apt-get install ${PYTHON_VER}-distutils ${PYTHON_VER}-setuptools

# Choose module versions (i suggest not changing the major number version)
export KEYSTONE_VER="0.9.2"
export LIEF_VER="0.12.3"

• From current folder run:

./setup.sh

Required for hooking/instrumentation also aka Inline GOT hooking

• Install

export TARGET=arm-linux-gnueabi
sudo apt-get install -y binutils-${TARGET} gcc-${TARGET}

export TARGET=mips-linux-gnu
sudo apt-get install -y binutils-${TARGET} gcc-${TARGET}

• add vim highlighting

augroup filetypedetect
  au! BufRead,BufNewFile *.c.bleed setfiletype c
augroup END