Simple easy to use C and python debugging framework for OSX
Switch branches/tags
Nothing to show
Clone or download
T and T daily bug
Latest commit 9025446 May 4, 2016
Type Name Latest commit message Commit time
Failed to load latest commit information.
src Actually print all registers. Jan 21, 2016
.gitignore cleaning Jan 16, 2016 first commit Jan 16, 2016
div_zero.tif daily bug May 4, 2016 Update Jan 17, 2016
talks_slides.pdf up Jan 19, 2016

Mac Debugger

Mac Debugger was created with the focus on giving the programmer a powerful framework to programatically create scripts to debug programs on Mac OSX not found in other products for the platform.

The core of macdbg, written in C, is kept as minimal as possible to provide enough basic interaction between the kernel and userland to create powerful features. Higher level functionality is left to the Python implementation such as stack tracing, dissasembly, watchpoints, thread state, and more. A wrapper class is provided for the programmer to create a scripting program.

NOTE: This is an Alpha implementation more showing concepts and ideas but not fully refined. Expect the Beta version in the coming months with more refined variable naming cleaner code and more useable examples. Thanks for all the interest suggestions comments and help welcome!

Getting Started

$ git clone

Navigate to the MacDBG directory, then cd src and make. The shared library libmcdb.dylib will be compiled and several binaries.



Running a test debugger on a test program.

  1. cd Python/examples and open another terminal.
  2. Run sudo ./
  3. This is just a test rogram which we will be attach and set breakpoints on. Hit f to fork the program enter to continue or press c to crash it. You should see breakpoint output like seen below.
  4. There are many other examples in the examples directory most having at least a small description available, nore descriptions and usage coming soon.
  5. Most examples will spawn a program but nearly all of them can take a PID and attach to that. Please note some were written specifaclly for a specific program such as was written to track mallocs on Firefox changes would need to be made to make it work on other programs.