ronin 0.3.0 → 1.0.0.pre1

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

@@ -1,285 +0,0 @@
-#
-# Ronin - A Ruby platform for exploit development and security research.
-#
-# Copyright (c) 2006-2009 Hal Brodigan (postmodern.mod3 at gmail.com)
-#
-# This program is free software; you can redistribute it and/or modify
-# it under the terms of the GNU General Public License as published by
-# the Free Software Foundation; either version 2 of the License, or
-# (at your option) any later version.
-#
-# This program 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 General Public License for more details.
-#
-# You should have received a copy of the GNU General Public License
-# along with this program; if not, write to the Free Software
-# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
-#
-
-require 'ronin/formatting/extensions/binary/integer'
-require 'ronin/formatting/extensions/text'
-require 'ronin/arch'
-
-require 'base64'
-
-class String
-
-  #
-  # Packs an Integer from a String, which was originally packed for
-  # a specific architecture and address-length.
-  #
-  # @param [Ronin::Arch] arch
-  #   The architecture that the Integer was originally packed with.
-  #
-  # @param [Integer] address_length
-  #   The number of bytes to depack.
-  #
-  # @return [Integer]
-  #   The depacked Integer.
-  #
-  # @example
-  #   0x41.pack(Arch('i686')) # => "A\000\000\000"
-  #
-  # @example
-  #   0x41.pack(Arch('ppc'),2) # => "\000A"
-  #
-  def depack(arch,address_length=arch.address_length)
-    integer = 0x0
-    byte_index = 0
-
-    if arch.endian == 'little'
-      mask = lambda { |b| b << (byte_index * 8) }
-    elsif arch.endian == 'big'
-      mask = lambda { |b|
-        b << ((address_length - byte_index - 1) * 8)
-      }
-    end
-
-    self.each_byte do |b|
-      break if byte_index >= address_length
-
-      integer |= mask.call(b)
-      byte_index += 1
-    end
-
-    return integer
-  end
-
-  #
-  # @return [String]
-  #   The hex escaped version of the String.
-  #
-  # @example
-  #   "hello".hex_escape
-  #   # => "\\x68\\x65\\x6c\\x6c\\x6f"
-  #
-  def hex_escape(options={})
-    format_bytes(options) { |b| "\\x%.2x" % b }
-  end
-
-  #
-  # @return [String]
-  #   The unescaped version of the hex escaped String.
-  #
-  # @example
-  #   "\\x68\\x65\\x6c\\x6c\\x6f".hex_unescape
-  #   # => "hello"
-  #
-  def hex_unescape
-    buffer = ''
-    hex_index = 0
-    hex_length = length
-
-    while (hex_index < hex_length)
-      hex_substring = self[hex_index..-1]
-
-      if hex_substring =~ /^\\[0-7]{3}/
-        buffer << hex_substring[0..3].to_i(8)
-        hex_index += 3
-      elsif hex_substring =~ /^\\x[0-9a-fA-F]{1,2}/
-        hex_substring[2..-1].scan(/^[0-9a-fA-F]{1,2}/) do |hex_byte|
-          buffer << hex_byte.to_i(16)
-          hex_index += (2 + hex_byte.length)
-        end
-      elsif hex_substring =~ /^\\./
-        escaped_char = hex_substring[1..1]
-
-        buffer << case escaped_char
-                  when '0'
-                    "\0"
-                  when 'a'
-                    "\a"
-                  when 'b'
-                    "\b"
-                  when 't'
-                    "\t"
-                  when 'n'
-                    "\n"
-                  when 'v'
-                    "\v"
-                  when 'f'
-                    "\f"
-                  when 'r'
-                    "\r"
-                  else
-                    escaped_char
-                  end
-        hex_index += 2
-      else
-        buffer << hex_substring[0]
-        hex_index += 1
-      end
-    end
-
-    return buffer
-  end
-
-  #
-  # XOR encodes the String.
-  #
-  # @param [Integer] key
-  #   The byte to XOR against each byte in the String.
-  #
-  # @return [String]
-  #   The XOR encoded String.
-  #
-  # @example
-  #   "hello".xor(0x41)
-  #   # => ")$--."
-  #
-  def xor(key)
-    encoded = ''
-
-    each_byte { |b| encoded << (b ^ key).chr }
-    return encoded
-  end
-
-  #
-  # Base64 encodes a string.
-  #
-  # @return [String]
-  #   The base64 encoded form of the string.
-  #
-  def base64_encode
-    Base64.encode64(self)
-  end
-
-  #
-  # Base64 decodes a string.
-  #
-  # @return [String]
-  #   The base64 decoded form of the string.
-  #
-  def base64_decode
-    Base64.decode64(self)
-  end
-
-  #
-  # Converts a multitude of hexdump formats back into the original
-  # raw-data.
-  #
-  # @param [Hash] options
-  #   Additional options.
-  #
-  # @option options [Symbol] :format
-  #   The expected format of the hexdump. Must be either +:od+ or
-  #   +:hexdump+.
-  #
-  # @option options [Symbol] :encoding
-  #   Denotes the encoding used for the bytes within the hexdump.
-  #   Must be one of the following: +:binary+, +:octal+, +:octal_bytes+
-  #   +:octal_shorts+, +:octal_ints+, :octal_quads+, +:decimal+,
-  #   +:decimal_bytes+, +:decimal_shorts+, +:decimal_ints+,
-  #   +:decimal_quads+, +:hex+ +:hex_bytes+, +:hex_shorts+, +:hex_ints+ or
-  #   +:hex_quads+.
-  #
-  # @option options [Integer] :segment (16)
-  #   The length in bytes of each segment in the hexdump.
-  #
-  # @return [String] The raw-data from the hexdump.
-  #
-  def unhexdump(options={})
-    case (format = options[:format])
-    when :od
-      address_base = base = 8
-      word_size = 2
-    when :hexdump
-      address_base = base = 16
-      word_size = 2
-    else
-      address_base = base = 16
-      word_size = 1
-    end
-
-    case options[:encoding]
-    when :binary
-      base = 2
-    when :octal, :octal_bytes, :octal_shorts, :octal_ints, :octal_quads
-      base = 8
-    when :decimal, :decimal_bytes, :decimal_shorts, :decimal_ints, :decimal_quads
-      base = 10
-    when :hex, :hex_bytes, :hex_shorts, :hex_ints, :hex_quads
-      base = 16
-    end
-
-    case options[:encoding]
-    when :binary, :octal_bytes, :decimal_bytes, :hex_bytes
-      word_size = 1
-    when :octal_shorts, :decimal_shorts, :hex_shorts
-      word_size = 2
-    when :octal_ints, :decimal_ints, :hex_ints
-      word_size = 4
-    when :octal_quads, :decimal_quads, :hex_quads
-      word_size = 8
-    end
-
-    current_addr = last_addr = first_addr = nil
-    repeated = false
-
-    segment_length = (options[:segment] || 16)
-    segment = []
-    buffer = []
-
-    each_line do |line|
-      if format == :hexdump
-        line = line.gsub(/\s+\|.+\|\s*$/,'')
-      end
-
-      words = line.split
-
-      if words.first == '*'
-        repeated = true
-      elsif words.length > 0
-        current_addr = words.shift.to_i(address_base)
-        first_addr ||= current_addr
-
-        if repeated
-          (((current_addr - last_addr) / segment.length) - 1).times do
-            buffer += segment
-          end
-
-          repeated = false
-        end
-
-        segment.clear
-
-        words.each do |word|
-          if (base != 10 && word =~ /^(\\[0abtnvfr\\]|.)$/)
-            word.hex_unescape.each_byte { |b| segment << b }
-          else
-            segment += word.to_i(base).bytes(word_size)
-          end
-        end
-
-        segment = segment[0...segment_length]
-        buffer += segment
-        last_addr = current_addr
-      end
-    end
-
-    return buffer[0...(last_addr - first_addr)]
-  end
-
-end

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

@@ -1,22 +0,0 @@
-#
-# Ronin - A Ruby platform for exploit development and security research.
-#
-# Copyright (c) 2006-2009 Hal Brodigan (postmodern.mod3 at gmail.com)
-#
-# This program is free software; you can redistribute it and/or modify
-# it under the terms of the GNU General Public License as published by
-# the Free Software Foundation; either version 2 of the License, or
-# (at your option) any later version.
-#
-# This program 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 General Public License for more details.
-#
-# You should have received a copy of the GNU General Public License
-# along with this program; if not, write to the Free Software
-# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
-#
-
-require 'ronin/formatting/extensions/binary/integer'
-require 'ronin/formatting/extensions/binary/string'

data/lib/ronin/formatting/extensions/digest/string.rb

@@ -1,87 +0,0 @@
-#
-# Ronin - A Ruby platform for exploit development and security research.
-#
-# Copyright (c) 2006-2009 Hal Brodigan (postmodern.mod3 at gmail.com)
-#
-# This program is free software; you can redistribute it and/or modify
-# it under the terms of the GNU General Public License as published by
-# the Free Software Foundation; either version 2 of the License, or
-# (at your option) any later version.
-#
-# This program 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 General Public License for more details.
-#
-# You should have received a copy of the GNU General Public License
-# along with this program; if not, write to the Free Software
-# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
-#
-
-require 'digest/md5'
-require 'digest/sha1'
-require 'digest/sha2'
-
-class String
-
-  #
-  # @return [String]
-  #   The MD5 checksum of the String.
-  #
-  # @example
-  #   "hello".md5
-  #   # => "5d41402abc4b2a76b9719d911017c592"
-  #
-  def md5
-    Digest::MD5.hexdigest(self)
-  end
-
-  #
-  # @return [String]
-  #   The SHA1 checksum of the String.
-  #
-  # @example
-  #   "hello".sha1
-  #   # => "aaf4c61ddcc5e8a2dabede0f3b482cd9aea9434d"
-  #
-  def sha1
-    Digest::SHA1.hexdigest(self)
-  end
-
-  #
-  # @return [String]
-  #   The SHA2 checksum of the String.
-  #
-  # @example
-  #   "hello".sha2
-  #   # => "2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824"
-  #
-  def sha2
-    Digest::SHA2.hexdigest(self)
-  end
-
-  #
-  # @return [String]
-  #   The SHA256 checksum of the String.
-  #
-  # @example
-  #   "hello".sha256
-  #   # => "2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824"
-  #
-  def sha256
-    Digest::SHA256.hexdigest(self)
-  end
-
-  #
-  # @return [String]
-  #   The SHA512 checksum of the String.
-  #
-  # @example
-  #   "hello".sha512
-  #   # => "9b71d224bd62f3785d96d46ad3ea3d73319bfbc2890caadae2dff72519673ca72323c3d99ba5c11d7c7acc6e14b8c5da0c4663475c2e5c3adef46f73bcdec043"
-  #
-  def sha512
-    Digest::SHA512.hexdigest(self)
-  end
-
-end

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

@@ -1,21 +0,0 @@
-#
-# Ronin - A Ruby platform for exploit development and security research.
-#
-# Copyright (c) 2006-2009 Hal Brodigan (postmodern.mod3 at gmail.com)
-#
-# This program is free software; you can redistribute it and/or modify
-# it under the terms of the GNU General Public License as published by
-# the Free Software Foundation; either version 2 of the License, or
-# (at your option) any later version.
-#
-# This program 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 General Public License for more details.
-#
-# You should have received a copy of the GNU General Public License
-# along with this program; if not, write to the Free Software
-# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
-#
-
-require 'ronin/formatting/extensions/digest/string'

data/lib/ronin/formatting/extensions/http/string.rb

@@ -1,88 +0,0 @@
-#
-# Ronin - A Ruby platform for exploit development and security research.
-#
-# Copyright (c) 2006-2009 Hal Brodigan (postmodern.mod3 at gmail.com)
-#
-# This program is free software; you can redistribute it and/or modify
-# it under the terms of the GNU General Public License as published by
-# the Free Software Foundation; either version 2 of the License, or
-# (at your option) any later version.
-#
-# This program 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 General Public License for more details.
-#
-# You should have received a copy of the GNU General Public License
-# along with this program; if not, write to the Free Software
-# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
-#
-
-require 'ronin/formatting/extensions/text'
-
-require 'uri'
-require 'cgi'
-
-class String
-
-  #
-  # @return [String]
-  #   The URI encoded form of the String.
-  #
-  # @example
-  #   "art is graffiti".uri_encode
-  #   # => "art%20is%20graffiti"
-  #
-  def uri_encode
-    URI.encode(self)
-  end
-
-  #
-  # @return [String]
-  #   The decoded URI form of the String.
-  #
-  # @example
-  #   "genre%3f".uri_decode
-  #   # => "genre?"
-  #
-  def uri_decode
-    URI.decode(self)
-  end
-
-  #
-  # @return [String]
-  #   The URI escaped form of the String.
-  #
-  # @example
-  #   "x > y".uri_escape
-  #   # => "x+%3E+y"
-  #
-  def uri_escape
-    CGI.escape(self)
-  end
-
-  #
-  # @return [String]
-  #   The unescaped URI form of the String.
-  #
-  # @example
-  #   "sweet+%26+sour".uri_unescape
-  #   # => "sweet & sour"
-  #
-  def uri_unescape
-    CGI.unescape(self)
-  end
-
-  #
-  # @return [String]
-  #   The HTTP hexidecimal encoded form of the String.
-  #
-  # @example
-  #   "hello".format_http
-  #   # => "hello"
-  #
-  def format_http(options={})
-    format_bytes(options) { |b| "%%%x" % b }
-  end
-
-end

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

@@ -1,21 +0,0 @@
-#
-# Ronin - A Ruby platform for exploit development and security research.
-#
-# Copyright (c) 2006-2009 Hal Brodigan (postmodern.mod3 at gmail.com)
-#
-# This program is free software; you can redistribute it and/or modify
-# it under the terms of the GNU General Public License as published by
-# the Free Software Foundation; either version 2 of the License, or
-# (at your option) any later version.
-#
-# This program 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 General Public License for more details.
-#
-# You should have received a copy of the GNU General Public License
-# along with this program; if not, write to the Free Software
-# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
-#
-
-require 'ronin/formatting/extensions/http/string'

data/lib/ronin/formatting/extensions/text/array.rb

@@ -1,77 +0,0 @@
-#
-# Ronin - A Ruby platform for exploit development and security research.
-#
-# Copyright (c) 2006-2009 Hal Brodigan (postmodern.mod3 at gmail.com)
-#
-# This program is free software; you can redistribute it and/or modify
-# it under the terms of the GNU General Public License as published by
-# the Free Software Foundation; either version 2 of the License, or
-# (at your option) any later version.
-#
-# This program 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 General Public License for more details.
-#
-# You should have received a copy of the GNU General Public License
-# along with this program; if not, write to the Free Software
-# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
-#
-
-class Array
-
-  #
-  # Decodes the bytes contained within the Array. The Array may contain
-  # both Integer and String objects.
-  #
-  # @return [Array]
-  #   The bytes contained in the Array.
-  #
-  # @example
-  #   [0x41, 0x41, 0x20].bytes
-  #   # => [0x41, 0x41, 0x20]
-  #
-  # @example
-  #   ['A', 'BB', 0x90].bytes
-  #   # => [0x41, 0x42, 0x42, 0x90]
-  #
-  def bytes
-    self.inject([]) do |accum,elem|
-      if elem.kind_of?(Integer)
-        accum << elem
-      else
-        elem.to_s.each_byte { |b| accum << b }
-      end
-
-      accum
-    end
-  end
-
-  #
-  # Decodes the characters contained within the Array. The Array may contain
-  # either Integer or String objects.
-  #
-  # @return [Array]
-  #   The characters generated from the array.
-  #
-  # @example
-  #   [0x41, 0x41, 0x20].chars
-  #   # => ["A", "A", " "]
-  #
-  def chars
-    self.bytes.map { |b| b.chr }
-  end
-
-  #
-  # @return [String]
-  #   The String created from the characters within the Array.
-  #
-  # @example
-  #   [0x41, 0x41, 0x20].char_string
-  #   # => "AA "
-  #
-  def char_string
-    chars.join
-  end
-
-end