Skip to content
scriptable Win32/Linux/OSX debugger written in ruby
Latest commit bf2ac1b Jan 7, 2015 @tduehr fixup! add New BSD license
Failed to load latest commit information.
examples osx fixes Jul 26, 2011
lib fix Ragweed::Process#write Jul 22, 2012
test initial bones structure and cleanup May 13, 2009
.gitignore gem's don't need to be tracked Nov 22, 2009
History.txt proper fixes for Sep 21, 2009
LICENSE fixup! add New BSD license Jan 7, 2015
README.rdoc clean up doc Jul 27, 2011
README.txt initial commit from struct's version May 13, 2009
Rakefile clean up doc Jul 27, 2011
VERSION Version bump to 0.2.9 Jul 22, 2012
ragweed.gemspec Regenerate gemspec for version 0.2.9 Jul 22, 2012



by tduehr, crohlf, and tqbf


  • Ragweed is a set of scriptable debugging tools written in native ruby.

  • Where required the FFI and Win32API libraries are used to interface the machine and OS native system calls.

  • There are no third party dependencies

Supported Platforms

Ragweed is supported and has been tested on the following platforms (32bit intel only):

Windows XP, 7
Linux Ubuntu 9.04 -> 11.04
Mac OS X 10.5, 10.6

Ragweed works with Ruby 1.8.7, 1.9.1 and 1.9.2 and should work with any Ruby that includes FFI support on 32bit WinXP, Win7, Linux 2.6 and OSX 10.6. We are actively investigating 64 bit support for each platform. Unfortunately, this will require significant changes to Ragweed.

  • We have completed switching from Ruby/DL to FFI in 0.2.0. There should be no incompatibilities as a result of this switch. Additionally, ragweed may now work on rubies that include FFI support (jruby, ree, rbx), this has not yet been tested.


  • This suite is currently fairly piecemeal. Each OS has it's own set of tools. The most complete set is for Win32.

  • Work is ongoing to complete and unify the OSX and Linux portions.

  • Struct's Nerve is an example of the API we are heading toward


require 'debuggerosx'
d = # pid of process to trace

Please see the examples directory for more. There are hit tracers for each platform.


  • FFI - This was required to get around the limitations of Ruby/DL. If you're using Ragweed from jRuby, this should be free.


gem install ragweed

# yep, thats it. you're done.


Copyright 2009-2011 Matasano Security, LLC All Rights Reserved

Something went wrong with that request. Please try again.