ronin 0.0.9

data/README.txt

@@ -0,0 +1,131 @@
+= Ronin
+
+* http://ronin.rubyforge.org/
+* Postmodern Modulus III
+
+== DESCRIPTION:
+
+Ronin is a Ruby platform designed for information security and data
+exploration tasks. Ronin allows for the rapid development and distribution
+of code over many of the common Source-Code-Management (SCM) systems.
+
+=== Free
+
+All source code within Ronin is licensed under the GPL-2, therefore no user
+will ever have to pay for Ronin or updates to Ronin. Not only is the
+source code free, the Ronin project will not sell enterprise grade security
+snake-oil solutions, give private training classes or later turn Ronin into
+commercial software.
+
+=== Modular
+
+Ronin was not designed as one monolithic library but instead as a collection
+of libraries which can be individually installed. This allows users to pick
+and choose what functionality they want in Ronin.
+
+=== Decentralized
+
+Ronin does not have a central repository of exploits and payloads which
+all developers contribute to. Instead Ronin has Overlays, repositories of
+code that can be hosted on any CVS/SVN/Git/Rsync server. Users can then use
+Ronin to quickly install or update Overlays. This allows developers and
+users to form their own communities, independent of the main developers
+of Ronin.
+
+== FEATURES:
+
+* Supports installing/updating/uninstalling of Overlays.
+  * Supports accessing Overlays from various media types:
+    * CVS
+    * Subversion (SVN)
+    * Git
+    * Rsync
+    * Darcs
+* Allows for the loading of Extensions from one or more Overlays.
+* Provides persistent storage of objects using DataMapper.
+* Caches and mirrors objects stored in Overlays using DataMapper.
+* Provides convenience methods for:
+  * Formatting data:
+    * Binary
+    * HTTP
+    * URIs
+    * HTML
+  * Generating random text.
+  * Networking:
+    * TCP
+    * UDP
+    * SMTP
+    * POP
+    * Imap
+    * Telnet
+    * HTTP
+  * Web access (utilizing Mechanize and Hpricot).
+* Provides an IRB styled console with:
+  * Tab-completion enabled.
+  * Auto-indentation enabled.
+  * Pretty-Print loaded.
+
+== SYNOPSIS:
+
+* List installed Overlays:
+
+    $ ronin ls
+
+* Install an Overlay:
+
+    $ ronin install svn://example.com/var/svn/overlay
+
+* Update all installed Overlays:
+
+    $ ronin up
+
+* Update a specific Overlay:
+
+    $ ronin up overlay-name
+
+* Uninstall an Overlay:
+
+    $ ronin uninstall overlay-name
+
+* Start the Ronin console:
+
+    $ ronin
+
+== REQUIREMENTS:
+
+* Hpricot
+* Mechanize
+* DataMapper:
+  * dm-core
+  * data_objects
+  * do_sqlite3
+  * dm-types
+  * dm-serializer
+  * dm-aggregates
+* reverserequire
+* R'epertoire
+
+== INSTALL:
+
+  $ sudo gem install ronin
+
+== LICENSE:
+
+Ronin - A Ruby platform designed for information security and data
+exploration tasks.
+
+Copyright (c) 2006-2008 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

data/Rakefile

@@ -0,0 +1,23 @@
+# -*- ruby -*-
+
+require 'rubygems'
+require 'hoe'
+require './tasks/spec.rb'
+require './lib/ronin/version.rb'
+
+Hoe.new('ronin', Ronin::VERSION) do |p|
+  p.rubyforge_name = 'ronin'
+  p.developer('Postmodern Modulus III','postmodern.mod3@gmail.com')
+  p.extra_deps = ['hpricot',
+                  'mechanize',
+                  ['dm-core', '>=0.9.3'],
+                  ['data_objects', '>=0.9.3'],
+                  ['do_sqlite3', '>=0.9.3'],
+                  ['dm-types', '>=0.9.3'],
+                  ['dm-serializer', '>=0.9.3'],
+                  ['dm-aggregates', '>=0.9.3'],
+                  ['reverserequire', '>=0.1.0'],
+                  ['repertoire', '>=0.1.2']]
+end
+
+# vim: syntax=Ruby

data/TODO.txt

@@ -0,0 +1,6 @@
+== Ronin 0.1.0:
+
+* Create an IO proxy class and RPC Service for proxying io.
+* Create a module for pivoting.
+* Process user-requests and bug-fixes
+

data/bin/ronin

@@ -0,0 +1,12 @@
+#!/usr/bin/env ruby
+
+require 'rubygems'
+
+lib_dir = File.expand_path(File.join(File.dirname(__FILE__),'..','lib'))
+unless $LOAD_PATH.include?(lib_dir)
+  $LOAD_PATH << lib_dir
+end
+
+require 'ronin/runner/program'
+
+Ronin::Runner.program(ARGV)

data/lib/ronin.rb

@@ -0,0 +1,35 @@
+#
+#--
+# Ronin - A Ruby platform designed for information security and data
+# exploration tasks.
+#
+# Copyright (c) 2006-2008 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/extensions'
+require 'ronin/environment'
+require 'ronin/formatting'
+require 'ronin/chars'
+require 'ronin/path'
+require 'ronin/network'
+require 'ronin/web'
+require 'ronin/persistence'
+require 'ronin/ronin'
+require 'ronin/version'
+
+Ronin::Environment.load

data/lib/ronin/arch.rb

@@ -0,0 +1,86 @@
+#
+#--
+# Ronin - A Ruby platform designed for information security and data
+# exploration tasks.
+#
+# Copyright (c) 2006-2008 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/extensions/meta'
+require 'ronin/extensions/string'
+require 'ronin/model'
+
+module Ronin
+  class Arch
+
+    include Model
+
+    property :id, Serial
+
+    # Name of the architecture
+    property :name, String
+
+    # Endianness of the architecture
+    property :endian, String
+
+    # Address length of the architecture
+    property :address_length, Integer
+
+    #
+    # Returns the name of the arch as a String.
+    #
+    def to_s
+      @name.to_s
+    end
+
+    #
+    # Defines a new builtin Arch with the specified _name_ and the given
+    # _opts_. If _block_ is given, it will be passed the newly created
+    # Arch.
+    #
+    def Arch.define(name,options={})
+      name = name.to_s
+      endian = options[:endian].to_s
+      address_length = options[:address_length].to_i
+
+      meta_def(name.to_method_name) do
+        Arch.first_or_create(:name => name,
+                             :endian => endian,
+                             :address_length => address_length)
+      end
+
+      return nil
+    end
+
+    define :i386, :endian => :little, :address_length => 4
+    define :i486, :endian => :little, :address_length => 4
+    define :i686, :endian => :little, :address_length => 4
+    define :i986, :endian => :little, :address_length => 4
+    define :x86_64, :endian => :little, :address_length => 8
+    define :ia64, :endian => :little, :address_length => 8
+    define :ppc, :endian => :big, :address_length => 4
+    define :ppc64, :endian => :big, :address_length => 8
+    define :sparc, :endian => :big, :address_length => 4
+    define :sparc64, :endian => :big, :address_length => 8
+    define :mips_le, :endian => :little, :address_length => 4
+    define :mips_be, :endian => :big, :address_length => 4
+    define :arm_le, :endian => :little, :address_length => 4
+    define :arm_be, :endian => :big, :address_length => 4
+
+  end
+end

data/lib/ronin/author.rb

@@ -0,0 +1,88 @@
+#
+#--
+# Ronin - A Ruby platform designed for information security and data
+# exploration tasks.
+#
+# Copyright (c) 2006-2008 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/model'
+
+require 'rexml/document'
+require 'uri'
+
+module Ronin
+  class Author
+
+    include Model
+
+    # Anonymouse author name.
+    ANONYMOUSE = 'anonymous'
+
+    property :id, Serial
+
+    # Name of author
+    property :name, String
+
+    # Author's associated group
+    property :organization, String
+
+    # Author's PGP signature
+    property :pgp_signature, Text
+
+    # Author's email
+    property :email, String
+
+    # Author's site
+    property :site, String
+
+    # Author's biography
+    property :biography, Text
+
+    #
+    # Creates a new Author object with the given _name_ and _info_. The
+    # _name_ defaults to ANONYMOUSE. If _block_ is given, it will be passed
+    # the newly created Author object.
+    #
+    # _info_ may contain the following keys:
+    # <tt>:organization</tt>:: The organization of the author.
+    # <tt>:pgp_signature</tt>:: The PGP signature of the author.
+    # <tt>:email</tt>:: The email address of the author.
+    # <tt>:url</tt>:: The URL for the author.
+    # <tt>:biography</tt>:: The biography of the author.
+    #
+    def initialize(name=ANONYMOUSE,info={},&block)
+      @name = name
+      @organization= info[:organization]
+      @pgp_signature = info[:pgp_signature]
+      @email = info[:email]
+      @url = info[:url]
+      @biography = info[:biography]
+
+      block.call(self) if block
+    end
+
+    #
+    # Returns the name of the author.
+    #
+    def to_s
+      @name.to_s
+    end
+
+  end
+end

data/lib/ronin/cache.rb

@@ -0,0 +1,27 @@
+#
+#--
+# Ronin - A Ruby platform designed for information security and data
+# exploration tasks.
+#
+# Copyright (c) 2006-2008 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/cache/exceptions'
+require 'ronin/cache/extension'
+require 'ronin/cache/overlay'
+require 'ronin/cache/ronin'

data/lib/ronin/cache/config.rb

@@ -0,0 +1,34 @@
+#
+#--
+# Ronin - A Ruby platform designed for information security and data
+# exploration tasks.
+#
+# Copyright (c) 2006-2008 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/config'
+
+module Ronin
+  module Config
+    # Path to overlays directory
+    OVERLAY_DIR = File.join(Config::PATH,'overlays')
+
+    # Path to overlays cache file
+    OVERLAY_CACHE_PATH = File.join(Config::PATH,'overlays.yaml')
+  end
+end