Cyber security

GDBleed – Advanced Binary Instrumentation with GDB

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

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
Varshini

Varshini is a Cyber Security expert in Threat Analysis, Vulnerability Assessment, and Research. Passionate about staying ahead of emerging Threats and Technologies.

Recent Posts

Nmap cheat sheet for beginners

Nmap (Network Mapper) is a free tool that helps you find devices on a network,…

23 hours ago

Understanding the Model Context Protocol (MCP) and How It Works

Introduction to the Model Context Protocol (MCP) The Model Context Protocol (MCP) is an open…

1 week ago

The file Command – Quickly Identify File Contents in Linux

While file extensions in Linux are optional and often misleading, the file command helps decode what a…

1 week ago

How to Use the touch Command in Linux

The touch command is one of the quickest ways to create new empty files or update timestamps…

1 week ago

How to Search Files and Folders in Linux Using the find Command

Handling large numbers of files is routine for Linux users, and that’s where the find command shines.…

1 week ago

How to Move and Rename Files in Linux with the mv Command

Managing files and directories is foundational for Linux workflows, and the mv (“move”) command makes it easy…

1 week ago