Skip to content
This repository

scriptable Win32/Linux/OSX debugger written in ruby

Fetching latest commit…

Octocat-spinner-32-eaf2f5

Cannot retrieve the latest commit at this time

Octocat-spinner-32 examples osx fixes July 26, 2011
Octocat-spinner-32 lib
Octocat-spinner-32 spec initial bones structure and cleanup May 13, 2009
Octocat-spinner-32 test initial bones structure and cleanup May 13, 2009
Octocat-spinner-32 .gitignore gem's don't need to be tracked November 22, 2009
Octocat-spinner-32 History.txt proper fixes for 0.1.7.1 September 21, 2009
Octocat-spinner-32 README.rdoc
Octocat-spinner-32 README.txt initial commit from struct's version May 13, 2009
Octocat-spinner-32 Rakefile
Octocat-spinner-32 VERSION
Octocat-spinner-32 ragweed.gemspec
README.rdoc

Ragweed

by tduehr, crohlf, and tqbf
http://chargen.matasano.com

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:

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