ragweed 0.2.0-java

data/lib/ragweed/wraptux/constants.rb

@@ -0,0 +1,101 @@
+NULL = nil
+module Ragweed; end
+module Ragweed::Wraptux;end
+
+module Ragweed::Wraptux::Ptrace
+    TRACE_ME = 0
+    PEEK_TEXT = 1
+    PEEK_DATA = 2
+    PEEK_USER = 3
+    POKE_TEXT = 4
+    POKE_DATA = 5
+    POKE_USER = 6
+    CONTINUE = 7
+    KILL = 8
+    STEP = 9
+    GETREGS = 12
+    SETREGS = 13
+    ATTACH = 16
+    DETACH = 17
+    SYSCALL = 24
+    SETOPTIONS = 0x4200
+    GETEVENTMSG = 0x4201
+    GETSIGINFO = 0x4202
+    SETSIGINFO = 0x4203
+end
+
+module Ragweed::Wraptux::Ptrace::SetOptions
+    TRACESYSGOOD = 0x00000001
+    TRACEFORK = 0x00000002
+    TRACEVFORK = 0x00000004
+    TRACECLONE = 0x00000008
+    TRACEEXEC = 0x00000010
+    TRACEVFORKDONE = 0x00000020
+    TRACEEXIT = 0x00000040
+    MASK = 0x0000007f
+end
+
+module Ragweed::Wraptux::Ptrace::EventCodes
+    FORK = 1
+    VFORK = 2
+    CLONE = 3
+    EXEC = 4
+    VFORK_DONE = 5
+    EXIT = 6
+end
+
+module Ragweed::Wraptux::Signal
+	SIGHUP = 1
+	SIGINT = 2
+	SIGQUIT = 3
+	SIGILL = 4
+	SIGTRAP = 5
+	SIGABRT = 6
+	SIGIOT = 6
+	SIGBUS = 7
+	SIGFPE = 8
+	SIGKILL = 9
+	SIGUSR1 = 10
+	SIGSEGV = 11
+	SIGUSR2 = 12
+	SIGPIPE = 13
+	SIGALRM = 14
+	SIGTERM = 15
+	SIGSTKFLT = 16
+	SIGCHLD = 17
+	SIGCONT = 18
+	SIGSTOP = 19
+	SIGTSTP = 20
+	SIGTTIN = 21
+	SIGTTOU = 22
+	SIGURG = 23
+	SIGXCPU = 24
+	SIGXFSZ = 25
+	SIGVTALRM = 26
+	SIGPROF = 27
+	SIGWINCH = 28
+	SIGIO = 29
+	SIGPOLL = SIGIO
+	#SIGLOST = 29
+	SIGPWR = 30
+	SIGSYS = 31
+	SIGUNUSED = 31
+end
+
+module Ragweed::Wraptux::Wait
+    NOHANG = 1
+    UNTRACED = 2
+    EXITED = 4
+    STOPPED = 8
+    CONTINUED = 10
+    NOWWAIT = 20
+end
+
+module Ragweed::Wraptux::PagePermissions
+    PROT_NONE  = 0x0
+    PROT_READ  = 0x1
+    PROT_WRITE = 0x2
+    PROT_EXEC  = 0x4
+    PROT_GROWSDOWN = 0x01000000
+    PROT_GROWSUP   = 0x02000000
+end

data/lib/ragweed/wraptux/process.rb

@@ -0,0 +1,35 @@
+class Ragweed::Process
+
+    include Ragweed
+    attr_reader :pid
+
+    def initialize(pid); @pid = pid; end
+
+    ## Read/write ranges of data or fixnums to/from the process by address.
+    def read(off, sz=4096)
+        a = []
+        while off < off+sz
+            a.push(Ragweed::Wraptux::ptrace(Ragweed::Wraptux::Ptrace::PEEK_TEXT, @pid, off, 0))
+            return a.pack('L*') if a.last == -1 and FFI.errno != 0
+            off+=4
+        end
+        a.pack('L*')
+    end
+
+    ## ptrace sucks, writing 8 or 16 bytes will probably
+    ## result in failure unless you PTRACE_POKE first and
+    ## get the rest of the original value at the address
+    def write(off, data)
+        while off < data.size
+            Ragweed::Wraptux::ptrace(Ragweed::Wraptux::Ptrace::POKE_TEXT, @pid, off, data[off,4].unpack('L').first)
+            off += 4
+        end
+    end
+
+    def read32(off); read(off, 4).unpack("L").first; end
+    def read16(off); read(off, 2).unpack("v").first; end
+    def read8(off); read(off, 1)[0]; end
+    def write32(off, v); write(off, [v].pack("L")); end
+    def write16(off, v); write(off, [v].pack("v")); end
+    def write8(off, v); write(off, v.chr); end
+end

data/lib/ragweed/wraptux/threads.rb

@@ -0,0 +1,7 @@
+## New 'ThreadInfo' sub module
+## so Wraptux matches the API 
+module Ragweed; end
+module Ragweed::Wraptux; end
+
+module Ragweed::Wraptux::ThreadInfo
+end

data/lib/ragweed/wraptux/wraptux.rb

@@ -0,0 +1,72 @@
+require 'ffi'
+
+module Ragweed::Wraptux
+  module Libc
+    extend FFI::Library
+    ffi_lib FFI::Library::LIBC
+    attach_function 'ptrace', [ :ulong, :pid_t, :ulong, :ulong ], :long
+    attach_function 'wait', [ :pointer ], :int
+    attach_function 'waitpid', [ :int, :pointer, :int ], :int
+    attach_function 'kill', [ :int, :int ], :int
+    attach_function 'malloc', [ :size_t ], :pointer
+    attach_function 'free', [ :pointer ], :void
+  end
+  
+  class PTRegs < FFI::Struct
+      include Ragweed::FFIStructInclude
+      layout :ebx, :ulong,
+      :ecx, :ulong,
+      :edx, :ulong,
+      :esi, :ulong,
+      :edi, :ulong,
+      :ebp, :ulong,
+      :eax, :ulong,
+      :xds, :ulong,
+      :xes, :ulong,
+      :xfs, :ulong,
+      :xgs, :ulong,
+      :orig_eax, :ulong,
+      :eip, :ulong,
+      :xcs, :ulong,
+      :eflags, :ulong,
+      :esp, :ulong,
+      :xss, :ulong
+  end
+
+  class << self
+    # pid_t wait(int *status);
+    def wait
+      stat = FFI::MemoryPointer.new(:int, 1)
+      FFI.errno = 0
+      pid = Libc.wait stat
+      raise SystemCallError.new "wait", FFI.errno if pid == -1
+      [pid, stat.read_pointer.get_int32]
+    end
+    
+    # pid_t waitpid(pid_t pid, int *status, int options);
+    def waitpid pid, opts = 0
+      p = FFI::MemoryPointer.new(:int, 1)
+      FFI.errno = 0
+      r = Libc.waitpid(pid,p,opts)
+      raise SystemCallError.new "waitpid", FFI.errno if r == -1
+      status = p.get_int32(0)
+      [r, status]
+    end
+
+    # int kill(pid_t pid, int sig);
+    def kill pid, sig
+      FFI.errno = 0
+      r = Libc.kill pid, sig
+      raise SystemCallError.new "waitpid", FFI.errno if r == -1
+      r
+    end
+    
+    #long ptrace(enum __ptrace_request request, pid_t pid, void *addr, void *data);
+    def ptrace req, pid, addr, data
+      FFI.errno = 0
+      r = Libc.ptrace req, pid, addr, data
+      #raise SystemCallError.new "ptrace", FFI.errno if r == -1 and !FFI.errno.zero?
+      r
+    end
+  end
+end

data/lib/ragweed/wraptux.rb

@@ -0,0 +1,57 @@
+# Dir[File.expand_path("#{File.dirname(__FILE__)}/wraptux/*.rb")].each do |file|
+#   require file
+# end
+
+module Ragweed; end
+module Ragweed::Wraptux
+  # :stopdoc:
+  VERSION = File.read(File.join(File.dirname(__FILE__),"..","..","VERSION")).strip
+  LIBPATH = ::File.expand_path(::File.dirname(__FILE__)) + ::File::SEPARATOR
+  PATH = ::File.dirname(LIBPATH) + ::File::SEPARATOR
+  # :startdoc:
+
+  # Returns the version string for the library.
+  #
+  def self.version
+    VERSION
+  end
+
+  # Returns the library path for the module. If any arguments are given,
+  # they will be joined to the end of the libray path using
+  # <tt>File.join</tt>.
+  #
+  def self.libpath( *args )
+    args.empty? ? LIBPATH : ::File.join(LIBPATH, args.flatten)
+  end
+
+  # Returns the lpath for the module. If any arguments are given,
+  # they will be joined to the end of the path using
+  # <tt>File.join</tt>.
+  #
+  def self.path( *args )
+    args.empty? ? PATH : ::File.join(PATH, args.flatten)
+  end
+
+  # Utility function to load utility classes and extensions
+  def self.require_utils
+    %w{utils}.each{|r| require self.libpath(r)+'.rb'}
+  end
+
+  # Utility method used to require all files ending in .rb that lie in the
+  # directory below this file that has the same name as the filename passed
+  # in. Optionally, a specific _directory_ name can be passed in such that
+  # the _filename_ does not have to be equivalent to the directory.
+  #
+  def self.require_all_libs_relative_to( fname, dir = nil )
+    self.require_utils
+    dir ||= ::File.basename(fname, '.*')
+    search_me = ::File.expand_path(
+        ::File.join(::File.dirname(fname), dir, '**', '*.rb'))
+    Dir.glob(search_me).sort.each {|rb| require rb }
+    # require File.dirname(File.basename(__FILE__)) + "/#{x}"
+  end
+end  # module Ragweed::Wraptux
+
+Ragweed::Wraptux.require_all_libs_relative_to(__FILE__)
+
+# EOF

data/lib/ragweed.rb

@@ -0,0 +1,112 @@
+require 'ffi'
+
+module Ragweed
+
+  # :stopdoc:
+  VERSION = File.read(File.join(File.dirname(__FILE__),"..","VERSION")).strip
+  LIBPATH = ::File.expand_path(::File.dirname(__FILE__)) + ::File::SEPARATOR
+  PATH = ::File.dirname(LIBPATH) + ::File::SEPARATOR
+  # :startdoc:
+
+  # Returns the version string for the library.
+  #
+  def self.version
+    VERSION
+  end
+
+  # Returns the library path for the module. If any arguments are given,
+  # they will be joined to the end of the libray path using
+  # <tt>File.join</tt>.
+  #
+  def self.libpath( *args )
+    args.empty? ? LIBPATH : ::File.join(LIBPATH, args.flatten)
+  end
+
+  # Returns the lpath for the module. If any arguments are given,
+  # they will be joined to the end of the path using
+  # <tt>File.join</tt>.
+  #
+  def self.path( *args )
+    args.empty? ? PATH : ::File.join(PATH, args.flatten)
+  end
+
+  # Utility method used to require all files ending in .rb that lie in the
+  # directory below this file that has the same name as the filename passed
+  # in. Optionally, a specific _directory_ name can be passed in such that
+  # the _filename_ does not have to be equivalent to the directory.
+  #
+  def self.require_all_libs_relative_to( fname, dir = nil )
+    dir ||= ::File.basename(fname, '.*')
+    search_me = ::File.expand_path(
+        ::File.join(::File.dirname(fname), dir, '**', '*.rb'))
+    # Don't want to load wrapper or debugger here.
+    Dir.glob(search_me).sort.reject{|rb| rb =~ /(wrap|debugger|rasm[^\.])/}.each {|rb| require rb}
+    # require File.dirname(File.basename(__FILE__)) + "/#{x}"d
+  end
+
+  def self.require_os_libs_relative_to( fname, dir= nil )
+    dir ||= ::File.basename(fname, '.*')
+    pkgs = ""
+    dbg = ""
+
+    case
+    when ::FFI::Platform.windows?
+      pkgs = '32'
+    when ::FFI::Platform.mac?
+      pkgs = 'osx'
+    # coming soon
+    # when ::FFI::Platform.bsd?
+    #   pkgs = "bsd"
+    when ::FFI::Platform.unix? && ! ::FFI::Platform.bsd?
+      # FFI doesn't specifically detect linux so... we punt
+      pkgs = 'tux'
+    else
+      warn "Platform not supported no wrapper libraries loaded."
+    end
+    
+    if not pkgs.empty?
+      search_me = File.expand_path(File.join(File.dirname(fname), dir, "*#{pkgs}.rb"))
+      Dir.glob(search_me).sort.reverse.each {|rb| require rb}
+    end
+  end
+end  # module Ragweed
+
+## FFI Struct Accessor Methods
+module Ragweed::FFIStructInclude
+  if RUBY_VERSION < "1.9"
+    def methods regular=true
+      (super + self.members.map{|x| [x.to_s, x.to_s+"="]}).flatten
+    end
+  else
+    def methods regular=true
+      (super + self.members.map{|x| [x, (x.to_s+"=").intern]}).flatten
+    end
+  end
+
+  def method_missing meth, *args
+    super unless self.respond_to? meth
+    if meth.to_s =~ /=$/
+      self.__send__(:[]=, meth.to_s.gsub(/=$/,'').intern, *args)
+    else
+      self.__send__(:[], meth, *args)
+    end
+  end
+
+  def respond_to? meth, include_priv=false
+    # mth = meth.to_s.gsub(/=$/,'')
+    !((self.methods & [meth, meth.to_s]).empty?) || super
+  end
+end
+
+# pkgs = %w[arena sbuf ptr process event rasm blocks detour trampoline device debugger hooks]
+# pkgs << 'wrap32' if RUBY_PLATFORM =~ /win(dows|32)/i
+# pkgs << 'wraposx' if RUBY_PLATFORM =~ /darwin/i
+# pkgs << 'wraptux' if RUBY_PLATFORM =~ /linux/i
+# pkgs.each do |x|
+#   require File.dirname(__FILE__) + "/#{x}"
+# end
+
+
+Ragweed.require_os_libs_relative_to(__FILE__)
+Ragweed.require_all_libs_relative_to(__FILE__)
+# EOF

data/ragweed.gemspec

@@ -0,0 +1,102 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{ragweed}
+  s.version = "0.2.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["tduehr", "struct", "tqbf"]
+  s.date = %q{2011-04-12}
+  s.description = %q{General debugging tool written in Ruby for OSX/Win32/Linux}
+  s.email = %q{td@matasano.com}
+  s.extra_rdoc_files = [
+    "README.rdoc",
+    "README.txt"
+  ]
+  s.files = [
+    "History.txt",
+    "README.rdoc",
+    "README.txt",
+    "Rakefile",
+    "VERSION",
+    "examples/hittracertux.rb",
+    "examples/hittracerx.rb",
+    "examples/hook_notepad.rb",
+    "examples/snicker.rb",
+    "examples/tux-example.rb",
+    "lib/ragweed.rb",
+    "lib/ragweed/arena.rb",
+    "lib/ragweed/blocks.rb",
+    "lib/ragweed/debugger32.rb",
+    "lib/ragweed/debuggerosx.rb",
+    "lib/ragweed/debuggertux.rb",
+    "lib/ragweed/detour.rb",
+    "lib/ragweed/ptr.rb",
+    "lib/ragweed/rasm.rb",
+    "lib/ragweed/rasm/bblock.rb",
+    "lib/ragweed/rasm/isa.rb",
+    "lib/ragweed/sbuf.rb",
+    "lib/ragweed/trampoline.rb",
+    "lib/ragweed/utils.rb",
+    "lib/ragweed/wrap32.rb",
+    "lib/ragweed/wrap32/debugging.rb",
+    "lib/ragweed/wrap32/device.rb",
+    "lib/ragweed/wrap32/event.rb",
+    "lib/ragweed/wrap32/hooks.rb",
+    "lib/ragweed/wrap32/overlapped.rb",
+    "lib/ragweed/wrap32/process.rb",
+    "lib/ragweed/wrap32/process_token.rb",
+    "lib/ragweed/wrap32/thread_context.rb",
+    "lib/ragweed/wrap32/winx.rb",
+    "lib/ragweed/wrap32/wrap32.rb",
+    "lib/ragweed/wraposx.rb",
+    "lib/ragweed/wraposx/constants.rb",
+    "lib/ragweed/wraposx/kernelerrorx.rb",
+    "lib/ragweed/wraposx/region_info.rb",
+    "lib/ragweed/wraposx/structs.rb",
+    "lib/ragweed/wraposx/thread_context.rb",
+    "lib/ragweed/wraposx/thread_info.rb",
+    "lib/ragweed/wraposx/thread_info.rb.old",
+    "lib/ragweed/wraposx/wraposx.rb",
+    "lib/ragweed/wraptux.rb",
+    "lib/ragweed/wraptux/constants.rb",
+    "lib/ragweed/wraptux/process.rb",
+    "lib/ragweed/wraptux/threads.rb",
+    "lib/ragweed/wraptux/wraptux.rb",
+    "ragweed.gemspec",
+    "spec/ragweed_spec.rb",
+    "spec/spec_helper.rb",
+    "test/test_ragweed.rb"
+  ]
+  s.homepage = %q{http://github.com/tduehr/ragweed}
+  s.rdoc_options = ["--inline-source", "--line-numbers", "--main", "README.rdoc"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.5.2}
+  s.summary = %q{Scriptable debugger}
+  s.test_files = [
+    "examples/hittracertux.rb",
+    "examples/hittracerx.rb",
+    "examples/hook_notepad.rb",
+    "examples/snicker.rb",
+    "examples/tux-example.rb",
+    "spec/ragweed_spec.rb",
+    "spec/spec_helper.rb",
+    "test/test_ragweed.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<ffi>, ["~> 1.0"])
+    else
+      s.add_dependency(%q<ffi>, ["~> 1.0"])
+    end
+  else
+    s.add_dependency(%q<ffi>, ["~> 1.0"])
+  end
+end
+

data/spec/ragweed_spec.rb

@@ -0,0 +1,7 @@
+
+require File.join(File.dirname(__FILE__), %w[spec_helper])
+
+describe Ragweed do
+end
+
+# EOF

data/spec/spec_helper.rb

@@ -0,0 +1,16 @@
+
+require File.expand_path(
+    File.join(File.dirname(__FILE__), %w[.. lib ragweed]))
+
+Spec::Runner.configure do |config|
+  # == Mock Framework
+  #
+  # RSpec uses it's own mocking framework by default. If you prefer to
+  # use mocha, flexmock or RR, uncomment the appropriate line:
+  #
+  # config.mock_with :mocha
+  # config.mock_with :flexmock
+  # config.mock_with :rr
+end
+
+# EOF

metadata

@@ -0,0 +1,121 @@
+--- !ruby/object:Gem::Specification 
+name: ragweed
+version: !ruby/object:Gem::Version 
+  prerelease: 
+  version: 0.2.0
+platform: java
+authors: 
+  - tduehr
+  - struct
+  - tqbf
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-04-12 00:00:00 -05:00
+default_executable: 
+dependencies: []
+
+description: General debugging tool written in Ruby for OSX/Win32/Linux
+email: td@matasano.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+  - README.rdoc
+  - README.txt
+files: 
+  - History.txt
+  - README.rdoc
+  - README.txt
+  - Rakefile
+  - VERSION
+  - examples/hittracertux.rb
+  - examples/hittracerx.rb
+  - examples/hook_notepad.rb
+  - examples/snicker.rb
+  - examples/tux-example.rb
+  - lib/ragweed.rb
+  - lib/ragweed/arena.rb
+  - lib/ragweed/blocks.rb
+  - lib/ragweed/debugger32.rb
+  - lib/ragweed/debuggerosx.rb
+  - lib/ragweed/debuggertux.rb
+  - lib/ragweed/detour.rb
+  - lib/ragweed/ptr.rb
+  - lib/ragweed/rasm.rb
+  - lib/ragweed/rasm/bblock.rb
+  - lib/ragweed/rasm/isa.rb
+  - lib/ragweed/sbuf.rb
+  - lib/ragweed/trampoline.rb
+  - lib/ragweed/utils.rb
+  - lib/ragweed/wrap32.rb
+  - lib/ragweed/wrap32/debugging.rb
+  - lib/ragweed/wrap32/device.rb
+  - lib/ragweed/wrap32/event.rb
+  - lib/ragweed/wrap32/hooks.rb
+  - lib/ragweed/wrap32/overlapped.rb
+  - lib/ragweed/wrap32/process.rb
+  - lib/ragweed/wrap32/process_token.rb
+  - lib/ragweed/wrap32/thread_context.rb
+  - lib/ragweed/wrap32/winx.rb
+  - lib/ragweed/wrap32/wrap32.rb
+  - lib/ragweed/wraposx.rb
+  - lib/ragweed/wraposx/constants.rb
+  - lib/ragweed/wraposx/kernelerrorx.rb
+  - lib/ragweed/wraposx/region_info.rb
+  - lib/ragweed/wraposx/structs.rb
+  - lib/ragweed/wraposx/thread_context.rb
+  - lib/ragweed/wraposx/thread_info.rb
+  - lib/ragweed/wraposx/thread_info.rb.old
+  - lib/ragweed/wraposx/wraposx.rb
+  - lib/ragweed/wraptux.rb
+  - lib/ragweed/wraptux/constants.rb
+  - lib/ragweed/wraptux/process.rb
+  - lib/ragweed/wraptux/threads.rb
+  - lib/ragweed/wraptux/wraptux.rb
+  - ragweed.gemspec
+  - spec/ragweed_spec.rb
+  - spec/spec_helper.rb
+  - test/test_ragweed.rb
+has_rdoc: true
+homepage: http://github.com/tduehr/ragweed
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+  - --inline-source
+  - --line-numbers
+  - --main
+  - README.rdoc
+require_paths: 
+  - lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.5.1
+signing_key: 
+specification_version: 3
+summary: Scriptable debugger
+test_files: 
+  - examples/hittracertux.rb
+  - examples/hittracerx.rb
+  - examples/hook_notepad.rb
+  - examples/snicker.rb
+  - examples/tux-example.rb
+  - spec/ragweed_spec.rb
+  - spec/spec_helper.rb
+  - test/test_ragweed.rb