ronin-support 0.1.0.pre1

data/ChangeLog.md

@@ -0,0 +1,4 @@
+## 0.1.0 / 2010-01-01
+
+* Initial release.
+

data/Gemfile

@@ -0,0 +1,23 @@
+source 'https://rubygems.org'
+
+gemspec
+
+platforms :jruby do
+  gem 'jruby-openssl',	'~> 0.7.0'
+end
+
+group :development do
+  gem 'rake',		        '~> 0.8.7'
+
+  platforms :jruby do
+    gem 'bluecloth',    '>= 2.0.0'
+  end
+
+  platforms :ruby do
+    gem 'rdiscount',    '~> 1.6.3'
+  end
+
+  gem 'ore-core',       '~> 0.1.0'
+  gem 'ore-tasks',	    '~> 0.2.0'
+  gem 'rspec',          '~> 2.0.0'
+end

data/README.md

@@ -0,0 +1,98 @@
+# Ronin Support
+
+* [Source](http://github.com/ronin-ruby/ronin-support)
+* [Issues](http://github.com/ronin-ruby/ronin-support/issues)
+* [Documentation](http://rubydoc.info/github/ronin-ruby/ronin-support/frames)
+* [Mailing List](http://groups.google.com/group/ronin-ruby)
+* irc.freenode.net #ronin
+
+## Description
+
+Ronin Support is a support library for Ronin. Ronin Support contains many of
+the convenience methods used by Ronin and additional libraries.
+
+Ronin is a Ruby platform for exploit development and security research.
+Ronin allows for the rapid development and distribution of code, exploits
+or payloads over many common Source-Code-Management (SCM) systems.
+
+### Ruby
+
+Ronin's Ruby environment allows security researchers to leverage Ruby with
+ease. The Ruby environment contains a multitude of convenience methods
+for working with data in Ruby, a Ruby Object Database, a customized Ruby
+Console and an extendable command-line interface.
+
+### Extend
+
+Ronin's more specialized features are provided by additional Ronin
+libraries, which users can choose to install. These libraries can allow
+one to write and run Exploits and Payloads, scan for PHP vulnerabilities,
+perform Google Dorks  or run 3rd party scanners.
+
+### Publish
+
+Ronin allows users to publish and share code, exploits, payloads or other
+data via Overlays. Overlays are directories of code and data that can be
+hosted on any SVN, Hg, Git or Rsync server. Ronin makes it easy to create,
+install or update Overlays.
+
+## Features
+
+* Provides convenience methods for:
+  * Formatting data:
+    * Binary
+    * Text
+    * HTTP
+    * URIs
+  * Generating random text.
+  * Networking:
+    * TCP
+    * UDP
+    * SMTP / ESMTP
+    * POP3
+    * Imap
+    * Telnet
+    * HTTP / HTTPS
+  * Enumerating IP ranges:
+    * IPv4 / IPv6 addresses.
+    * CIDR / globbed ranges.
+  * (Un-)Hexdumping data.
+  * Handling exceptions.
+
+## Examples
+
+For examples of the convenience methods provided by ronin-support,
+please see [Everyday Ronin](http://ronin-ruby.github.com/resources/everyday_ronin.html).
+
+## Requirements
+
+* [Ruby](http://www.ruby-lang.org/) >= 1.8.7
+* [chars](http://github.com/postmodern/chars) ~> 0.1.2
+* [data_paths](http://github.com/postmodern/data_paths) ~> 0.2.0
+* [uri-query_params](http://github.com/postmodern/uri-query_params) ~> 0.5.0
+
+## Install
+
+    $ sudo gem install ronin-support
+
+## License
+
+Ronin Support - A support library for Ronin.
+
+Copyright (c) 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
+

data/Rakefile

@@ -0,0 +1,29 @@
+require 'rubygems'
+
+begin
+  require 'bundler'
+rescue LoadError => e
+  STDERR.puts e.message
+  STDERR.puts "Run `gem install bundler` to install Bundler."
+  exit e.status_code
+end
+
+begin
+  Bundler.setup(:development)
+rescue Bundler::BundlerError => e
+  STDERR.puts e.message
+  STDERR.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+
+require 'rake'
+
+require 'ore/tasks'
+Ore::Tasks.new
+
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new
+task :default => :spec
+
+require 'yard'
+YARD::Rake::YardocTask.new

data/gemspec.yml

@@ -0,0 +1,20 @@
+name: ronin-support
+summary: A support library for Ronin.
+description:
+  Ronin Support is a support library for Ronin. Ronin Support contains many
+  of the convenience methods used by Ronin and additional libraries.
+
+license: LGPL-2.1
+authors: Postmodern
+email: postmodern.mod3@gmail.com
+homepage: http://github.com/ronin-ruby/ronin-support
+has_yard: true
+
+dependencies:
+  chars: ~> 0.2.0
+  uri-query_params: ~> 0.5.2
+  data_paths: ~> 0.2.1
+
+development_dependencies:
+  bundler: ~> 1.0.0
+  yard: ~> 0.6.1

data/lib/ronin/extensions.rb

@@ -0,0 +1,28 @@
+#
+# 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'
+require 'ronin/extensions/string'
+require 'ronin/extensions/file'
+require 'ronin/extensions/ip_addr'
+require 'ronin/extensions/kernel'
+
+require 'uri/query_params'

data/lib/ronin/extensions/file.rb

@@ -0,0 +1,63 @@
+#
+# 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 File
+
+  #
+  # Writes the given data to a specified path.
+  #
+  # @param [String] path
+  #   The path of the file to write to.
+  #
+  # @param [String] data
+  #   The data to write to the file.
+  #
+  # @return [nil]
+  #
+  def File.write(path,data)
+    File.open(path,'w') { |file| file.write(data) }
+  end
+
+  #
+  # Escapes a path.
+  #
+  # @param [String] path
+  #   Unescaped path.
+  #
+  # @return [String]
+  #   The escaped path.
+  #
+  def File.escape_path(path)
+    path = path.to_s
+
+    # remove any \0 characters first
+    path.gsub!("\0",'')
+
+    # remove any home-dir expansions
+    path.gsub!("~","\\~")
+
+    path = File.expand_path(File.join('/',path))
+
+    # remove the leading slash
+    return path[1..-1]
+  end
+
+end

data/lib/ronin/extensions/ip_addr.rb

@@ -0,0 +1,220 @@
+#
+# 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 'ipaddr'
+require 'resolv'
+require 'strscan'
+
+class IPAddr
+
+  include Enumerable
+
+  # A regular expression for matching IPv4 Addresses.
+  IPV4_REGEXP = /[\d]{1,3}\.[\d]{1,3}\.[\d]{1,3}\.[\d]{1,3}/
+
+  # A regular expression for matching IPv6 Addresses.
+  IPV6_REGEXP = /:(:[0-9a-f]{1,4}){1,7}|([0-9a-f]{1,4}::?){1,7}[0-9a-f]{1,4}(:#{IPV4_REGEXP})?/
+
+  # A regular expression for matching IP Addresses.
+  REGEXP = /#{IPV4_REGEXP}|#{IPV6_REGEXP}/
+
+  #
+  # Extracts IP Addresses from text.
+  #
+  # @param [String] text
+  #   The text to scan for IP Addresses.
+  #
+  # @param [Symbol] version
+  #   The version of IP Address to scan for (`:ipv4` or `:ipv6`).
+  #
+  # @yield [ip]
+  #   The given block will be passed each extracted IP Address.
+  #
+  # @yieldparam [String] ip
+  #   An IP Address from the text.
+  #
+  # @return [Array<String>]
+  #   The IP Addresses found in the text.
+  #
+  def IPAddr.extract(text,version=nil,&block)
+    regexp = case version
+             when :ipv4
+               IPV4_REGEXP
+             when :ipv6
+               IPV6_REGEXP
+             else
+               REGEXP
+             end
+
+    parser = StringScanner.new(text)
+
+    if block_given?
+      yield parser.matched while parser.skip_until(regexp)
+      return nil
+    else
+      ips = []
+
+      ips << parser.matched while parser.skip_until(regexp)
+      return ips
+    end
+  end
+
+  #
+  # Iterates over each IP address within the IP Address range. Supports
+  # both IPv4 and IPv6 address ranges.
+  #
+  # @param [String] cidr_or_glob
+  #   The IP address range to iterate over.
+  #   May be in standard CIDR notation or globbed format.
+  #
+  # @yield [ip]
+  #   The block which will be passed each IP address contained within the
+  #   IP address range.
+  #
+  # @yieldparam [String] ip
+  #   An IP address within the IP address range.
+  #
+  # @return [nil]
+  #
+  # @example Enumerate through a CIDR range
+  #   IPAddr.each('10.1.1.1/24') do |ip|
+  #     puts ip
+  #   end
+  #
+  # @example Enumerate through a globbed IP range
+  #   IPAddr.each('10.1.1-5.*') do |ip|
+  #     puts ip
+  #   end
+  #
+  # @example Enumerate through a globbed IPv6 range
+  #   IPAddr.each('::ff::02-0a::c3') do |ip|
+  #     puts ip
+  #   end
+  #
+  def IPAddr.each(cidr_or_glob,&block)
+    unless (cidr_or_glob.include?('*') || cidr_or_glob.include?('-'))
+      return IPAddr.new(cidr_or_glob).each(&block)
+    end
+
+    return enum_for(:each,cidr_or_glob) unless block
+
+    if cidr_or_glob.include?('::')
+      prefix = if cidr_or_glob[0,2] == '::'
+                 '::'
+               else
+                 ''
+               end
+
+      separator = '::'
+      base = 16
+
+      format = lambda { |address|
+        prefix + address.map { |i| '%.2x' % i }.join('::')
+      }
+    else
+      separator = '.'
+      base = 10
+
+      format = lambda { |address| address.join('.') }
+    end
+
+    # split the address
+    ranges = cidr_or_glob.split(separator)
+    
+    # map the components of the address to numeric ranges
+    ranges.map! do |segment|
+      if segment == '*'
+        (1..254)
+      elsif segment.include?('-')
+        start, stop = segment.split('-',2).map { |i| i.to_i(base) }
+
+        (start..stop)
+      elsif !(segment.empty?)
+        segment.to_i(base)
+      end
+    end
+    ranges.compact!
+
+    expand_range = lambda { |address,remaining|
+      if remaining.empty?
+        block.call(format.call(address))
+      else
+        n = remaining.first
+        remaining = remaining[1..-1]
+
+        if n.kind_of?(Range)
+          n.each { |i| expand_range.call(address + [i], remaining) }
+        else
+          expand_range.call(address + [n], remaining)
+        end
+      end
+    }
+
+    expand_range.call([], ranges)
+    return nil
+  end
+
+  #
+  # Resolves the host-names for the IP address.
+  #
+  # @return [Array<String>]
+  #   The host-names for the IP address.
+  #
+  def lookup
+    Resolv.getnames(self.to_s)
+  end
+
+  #
+  # Iterates over each IP address that is included in the addresses
+  # netmask. Supports both IPv4 and IPv6 addresses.
+  #
+  # @yield [ip]
+  #   The block which will be passed every IP address covered be the
+  #   netmask of the IPAddr object.
+  #
+  # @yieldparam [String] ip
+  #   An IP address.
+  #
+  # @example
+  #   netblock = IPAddr.new('10.1.1.1/24')
+  #
+  #   netblock.each do |ip|
+  #     puts ip
+  #   end
+  #
+  def each
+    return enum_for(:each) unless block_given?
+
+    case @family
+    when Socket::AF_INET
+      family_mask = IN4MASK
+    when Socket::AF_INET6
+      family_mask = IN6MASK
+    end
+
+    (0..((~@mask_addr) & family_mask)).each do |i|
+      yield _to_string(@addr | i)
+    end
+
+    return self
+  end
+
+end