Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
scriptable Win32/Linux/OSX debugger written in ruby
Ruby

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
examples
lib fix Ragweed::Process#write
spec
test initial bones structure and cleanup
.gitignore gem's don't need to be tracked
History.txt
LICENSE fixup! add New BSD license
README.rdoc
README.txt
Rakefile
VERSION
ragweed.gemspec

README.rdoc

Ragweed

by tduehr, crohlf, and tqbf
http://www.matasano.com/research/ragweed/

DESCRIPTION:

  • 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.

FEATURES/PROBLEMS:

  • 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

SYNOPSIS:

require 'debuggerosx'
d = Debuggerosx.new(514) # pid of process to trace

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

REQUIREMENTS:

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

INSTALL:

gem install ragweed

# yep, thats it. you're done.

LICENSE:

Copyright 2009-2011 Matasano Security, LLC All Rights Reserved

Something went wrong with that request. Please try again.