ronin-support 0.1.0.pre1

data/lib/ronin/extensions/kernel.rb

@@ -0,0 +1,45 @@
+#
+# Ronin - A Ruby platform for exploit development and security research.
+#
+# Copyright (c) 2006-2010 Hal Brodigan (postmodern.mod3 at gmail.com)
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin Street, Fifth Floor,
+# Boston, MA  02110-1301  USA
+#
+
+module Kernel
+  #
+  # Calls the given block and ignores any raised exceptions.
+  #
+  # @yield []
+  #   The block to be called.
+  #
+  # @return [Object, nil]
+  #   The return-value of the given block. If `nil` is returned, an
+  #   exception occurred and was ignored.
+  #
+  # @example
+  #   attempt do
+  #     Resolv.getaddress('might.not.exist.com')
+  #   end
+  #
+  def attempt
+    begin
+      yield() if block_given?
+    rescue Exception
+      return nil
+    end
+  end
+end

data/lib/ronin/extensions/meta.rb

@@ -0,0 +1,22 @@
+#
+# Ronin - A Ruby platform for exploit development and security research.
+#
+# Copyright (c) 2006-2010 Hal Brodigan (postmodern.mod3 at gmail.com)
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin Street, Fifth Floor,
+# Boston, MA  02110-1301  USA
+#
+
+require 'ronin/extensions/meta/object'

data/lib/ronin/extensions/meta/object.rb

@@ -0,0 +1,24 @@
+# metaprogramming assistant -- metaid.rb
+class Object # :nodoc:
+  # The hidden singleton lurks behind everyone
+  def metaclass; class << self; self; end; end
+  def meta_eval(&blk); metaclass.instance_eval(&blk); end
+
+  # A class_eval version of meta_eval
+  def metaclass_eval(&blk); metaclass.class_eval(&blk); end
+
+  # A class_def version of meta_def
+  def metaclass_def(name, &blk)
+    metaclass_eval { define_method(name, &blk) }
+  end
+  
+  # Adds methods to a metaclass
+  def meta_def(name, &blk)
+    meta_eval { define_method(name, &blk) }
+  end
+  
+  # Defines an instance method within a class
+  def class_def(name, &blk)
+    class_eval { define_method(name, &blk) }
+  end
+end

data/lib/ronin/extensions/string.rb

@@ -0,0 +1,200 @@
+#
+# Ronin - A Ruby platform for exploit development and security research.
+#
+# Copyright (c) 2006-2010 Hal Brodigan (postmodern.mod3 at gmail.com)
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin Street, Fifth Floor,
+# Boston, MA  02110-1301  USA
+#
+
+class String
+
+  #
+  # Enumerates over every sub-string within the string.
+  #
+  # @param [Integer] min
+  #   Minimum length of each sub-string.
+  #
+  # @yield [substring,(index)]
+  #   The given block will receive every sub-string contained within the
+  #   string. If the block accepts two arguments, then the index of
+  #   the sub-string will also be passed in.
+  #
+  # @yieldparam [String] substring
+  #   A sub-string from the string.
+  #
+  # @yieldparam [Integer] index
+  #   The optional index of the sub-string.
+  #
+  # @return [String]
+  #   The original string
+  #
+  def each_substring(min=0,&block)
+    return enum_for(:each_substring,min) unless block
+
+    (0..(self.length - min)).each do |i|
+      ((i + min)..self.length).each do |j|
+        sub_string = self[i...j]
+
+        if block.arity == 2
+          block.call(sub_string,i)
+        else
+          block.call(sub_string)
+        end
+      end
+    end
+
+    return self
+  end
+
+  #
+  # Enumerates over the unique sub-strings contained in the string.
+  #
+  # @param [Integer] min
+  #   Minimum length of each unique sub-string.
+  #
+  # @yield [substring,(index)]
+  #   The given block will receive every unique sub-string contained
+  #   within the string. If the block accepts two arguments, then the
+  #   index of the unique sub-string will also be passed in.
+  #
+  # @yieldparam [String] substring
+  #   A unique sub-string from the string.
+  #
+  # @yieldparam [Integer] index
+  #   The optional index of the unique sub-string.
+  #
+  # @return [String]
+  #   The original string
+  #
+  # @see each_substring
+  #
+  def each_unique_substring(min=0,&block)
+    return enum_for(:each_unique_substring,min) unless block
+
+    unique_strings = {}
+
+    each_substring(min) do |sub_string,index|
+      unless unique_strings.has_key?(sub_string)
+        unique_strings[sub_string] = index
+
+        if block.arity == 2
+          block.call(sub_string,index)
+        else
+          block.call(sub_string)
+        end
+      end
+    end
+
+    return self
+  end
+
+  #
+  # Returns the common prefix of the string and the specified other
+  # string. If no common prefix can be found an empty string will be
+  # returned.
+  #
+  def common_prefix(other)
+    min_length = [length, other.length].min
+
+    min_length.times do |i|
+      if self[i] != other[i]
+        return self[0...i]
+      end
+    end
+
+    return self[0...min_length]
+  end
+
+  #
+  # Returns the common postfix of the string and the specified other
+  # string. If no common postfix can be found an empty string will be
+  # returned.
+  #
+  def common_postfix(other)
+    min_length = [length, other.length].min
+
+    (min_length - 1).times do |i|
+      index = (length - i - 1)
+      other_index = (other.length - i - 1)
+
+      if self[index] != other[other_index]
+        return self[(index + 1)..-1]
+      end
+    end
+
+    return ''
+  end
+
+  #
+  # Returns the uncommon substring within the specified other string,
+  # which does not occur within the string. If no uncommon substring can be
+  # found, an empty string will be returned.
+  #
+  def uncommon_substring(other)
+    prefix = common_prefix(other)
+    postfix = self[prefix.length..-1].common_postfix(other[prefix.length..-1])
+
+    return self[prefix.length...(length - postfix.length)]
+  end
+
+  #
+  # Dumps the string as a C-style string.
+  #
+  # @return [String]
+  #   The C-style encoded version of the String.
+  #
+  # @example
+  #   "hello\x00\073\x90\r\n".dump
+  #   # => "hello\0;\x90\r\n"
+  #
+  def dump
+    c_string = ''
+
+    each_byte do |b|
+      c_string << case b
+                  when 0x00
+                    "\\0"
+                  when 0x07
+                    "\\a"
+                  when 0x08
+                    "\\b"
+                  when 0x09
+                    "\\t"
+                  when 0x0a
+                    "\\n"
+                  when 0x0b
+                    "\\v"
+                  when 0x0c
+                    "\\f"
+                  when 0x0d
+                    "\\r"
+                  when 0x22
+                    "\\\""
+                  when 0x5c
+                    "\\\\"
+                  when (0x20..0x7e)
+                    b.chr
+                  else
+                    ("\\x%.2x" % b)
+                  end
+    end
+
+    return "\"#{c_string}\""
+  end
+
+  alias inspect dump
+
+end

data/lib/ronin/formatting.rb

@@ -0,0 +1,26 @@
+#
+# Ronin - A Ruby platform for exploit development and security research.
+#
+# Copyright (c) 2006-2010 Hal Brodigan (postmodern.mod3 at gmail.com)
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin Street, Fifth Floor,
+# Boston, MA  02110-1301  USA
+#
+
+require 'ronin/formatting/extensions'
+require 'ronin/formatting/digest'
+require 'ronin/formatting/binary'
+require 'ronin/formatting/text'
+require 'ronin/formatting/http'

data/lib/ronin/formatting/binary.rb

@@ -0,0 +1,22 @@
+#
+# Ronin - A Ruby platform for exploit development and security research.
+#
+# Copyright (c) 2006-2010 Hal Brodigan (postmodern.mod3 at gmail.com)
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin Street, Fifth Floor,
+# Boston, MA  02110-1301  USA
+#
+
+require 'ronin/formatting/extensions/binary'

data/lib/ronin/formatting/digest.rb

@@ -0,0 +1,22 @@
+#
+# Ronin - A Ruby platform for exploit development and security research.
+#
+# Copyright (c) 2006-2010 Hal Brodigan (postmodern.mod3 at gmail.com)
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin Street, Fifth Floor,
+# Boston, MA  02110-1301  USA
+#
+
+require 'ronin/formatting/extensions/digest'

data/lib/ronin/formatting/extensions.rb

@@ -0,0 +1,25 @@
+#
+# Ronin - A Ruby platform for exploit development and security research.
+#
+# Copyright (c) 2006-2010 Hal Brodigan (postmodern.mod3 at gmail.com)
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin Street, Fifth Floor,
+# Boston, MA  02110-1301  USA
+#
+
+require 'ronin/formatting/extensions/binary'
+require 'ronin/formatting/extensions/text'
+require 'ronin/formatting/extensions/digest'
+require 'ronin/formatting/extensions/http'

data/lib/ronin/formatting/extensions/binary.rb

@@ -0,0 +1,24 @@
+#
+# Ronin - A Ruby platform for exploit development and security research.
+#
+# Copyright (c) 2006-2010 Hal Brodigan (postmodern.mod3 at gmail.com)
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin Street, Fifth Floor,
+# Boston, MA  02110-1301  USA
+#
+
+require 'ronin/formatting/extensions/binary/integer'
+require 'ronin/formatting/extensions/binary/string'
+require 'ronin/formatting/extensions/binary/file'

data/lib/ronin/formatting/extensions/binary/file.rb

@@ -0,0 +1,35 @@
+#
+# Ronin - A Ruby platform for exploit development and security research.
+#
+# Copyright (c) 2006-2010 Hal Brodigan (postmodern.mod3 at gmail.com)
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin Street, Fifth Floor,
+# Boston, MA  02110-1301  USA
+#
+
+require 'ronin/formatting/extensions/binary/string'
+
+class File
+
+  #
+  # Converts the hexdump at the given path back into raw-data.
+  #
+  # @see String#unhexdump.
+  #
+  def File.unhexdump(path,options={})
+    File.read(path).unhexdump(options)
+  end
+
+end