ronin-exploits 0.2.1 → 0.3.0

data/Rakefile

@@ -4,12 +4,23 @@ require 'rubygems'
 require 'hoe'
 require 'hoe/signing'
 require './tasks/spec.rb'
+require './tasks/yard.rb'
 
 Hoe.spec('ronin-exploits') do
   self.rubyforge_name = 'ronin'
   self.developer('Postmodern', 'postmodern.mod3@gmail.com')
   self.remote_rdoc_dir = 'docs/ronin-exploits'
-  self.extra_deps = [['ronin', '>=0.2.4']]
+  self.extra_deps = [
+    ['ronin', '>=0.3.0'],
+    ['ronin-gen', '>=0.2.0']
+  ]
+
+  self.extra_dev_deps = [
+    ['rspec', '>=1.2.8'],
+    ['yard', '>=0.2.3.5']
+  ]
+
+  self.spec_extras = {:has_rdoc => 'yard'}
 end
 
 # vim: syntax=Ruby

data/bin/ronin-exploit

@@ -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/ui/command_line/commands/exploit'
+
+Ronin::UI::CommandLine::Commands::Exploit.start

data/bin/ronin-exploits

@@ -9,4 +9,4 @@ end
 
 require 'ronin/ui/command_line/commands/exploits'
 
-Ronin::UI::CommandLine::Commands::Exploits.run(*ARGV)
+Ronin::UI::CommandLine::Commands::Exploits.start

data/bin/ronin-gen-binary-payload

@@ -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/ui/command_line/commands/gen_binary_payload'
+
+Ronin::UI::CommandLine::Commands::GenBinaryPayload.start

data/bin/ronin-gen-exploit

@@ -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/ui/command_line/commands/gen_exploit'
+
+Ronin::UI::CommandLine::Commands::GenExploit.start

data/bin/ronin-gen-ftp-exploit

@@ -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/ui/command_line/commands/gen_ftp_exploit'
+
+Ronin::UI::CommandLine::Commands::GenFtpExploit.start

data/bin/ronin-gen-http-exploit

@@ -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/ui/command_line/commands/gen_http_exploit'
+
+Ronin::UI::CommandLine::Commands::GenHttpExploit.start

data/bin/ronin-gen-local-exploit

@@ -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/ui/command_line/commands/gen_local_exploit'
+
+Ronin::UI::CommandLine::Commands::GenLocalExploit.start

data/bin/ronin-gen-nops

@@ -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/ui/command_line/commands/gen_nops'
+
+Ronin::UI::CommandLine::Commands::GenNops.start

data/bin/ronin-gen-payload

@@ -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/ui/command_line/commands/gen_payload'
+
+Ronin::UI::CommandLine::Commands::GenPayload.start

data/bin/ronin-gen-remote-exploit

@@ -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/ui/command_line/commands/gen_remote_exploit'
+
+Ronin::UI::CommandLine::Commands::GenRemoteExploit.start

data/bin/ronin-gen-remote-tcp-exploit

@@ -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/ui/command_line/commands/gen_remote_tcp_exploit'
+
+Ronin::UI::CommandLine::Commands::GenRemoteTcpExploit.start

data/bin/ronin-gen-remote-udp-exploit

@@ -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/ui/command_line/commands/gen_remote_udp_exploit'
+
+Ronin::UI::CommandLine::Commands::GenRemoteUdpExploit.start

data/bin/ronin-gen-shellcode

@@ -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/ui/command_line/commands/gen_shellcode'
+
+Ronin::UI::CommandLine::Commands::GenShellcode.start

data/bin/ronin-gen-web-exploit

@@ -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/ui/command_line/commands/gen_web_exploit'
+
+Ronin::UI::CommandLine::Commands::GenWebExploit.start

data/bin/ronin-payload

@@ -9,4 +9,4 @@ end
 
 require 'ronin/ui/command_line/commands/payload'
 
-Ronin::UI::CommandLine::Commands::Payload.run(*ARGV)
+Ronin::UI::CommandLine::Commands::Payload.start

data/bin/ronin-payloads

@@ -9,4 +9,4 @@ end
 
 require 'ronin/ui/command_line/commands/payloads'
 
-Ronin::UI::CommandLine::Commands::Payloads.run(*ARGV)
+Ronin::UI::CommandLine::Commands::Payloads.start

data/lib/ronin/controls.rb

@@ -0,0 +1,23 @@
+#
+# Ronin Exploits - A Ruby library for Ronin that provides exploitation and
+# payload crafting functionality.
+#
+# Copyright (c) 2007-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/controls/exceptions'
+require 'ronin/controls/behaviors'

data/lib/ronin/controls/behaviors.rb

@@ -0,0 +1,133 @@
+#
+# Ronin Exploits - A Ruby library for Ronin that provides exploitation and
+# payload crafting functionality.
+#
+# Copyright (c) 2007-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/vuln/behavior'
+
+module Ronin
+  module Controls
+    module Behaviors
+      #
+      # Attempts to load and extend the control module defined in
+      # Ronin::Controls::Helpers.
+      #
+      # @param [Symbol, String] name
+      #   The snake-case name of the control helper module to load.
+      #
+      # @return [Boolean]
+      #   Specifies whether the control helper module was successfully
+      #   loaded.
+      #
+      # @example
+      #   control_helper :file_read
+      #
+      # @since 0.3.0
+      #
+      def control_helper(name)
+        name = name.to_s
+        module_name = name.to_const_string
+
+        begin
+          require_within File.join('ronin','controls','helpers'), name
+        rescue Gem::LoadError => e
+          raise(e)
+        rescue ::LoadError
+          return false
+        end
+
+        unless Ronin::Controls::Helpers.const_defined?(module_name)
+          return false
+        end
+
+        control_module = Ronin::Controls::Helpers.const_get(module_name)
+
+        unless control_module.kind_of?(Module)
+          return false
+        end
+
+        extend control_module
+        return true
+      end
+
+      #
+      # @return [Model]
+      #   The model used by the +controls+ relationship.
+      #
+      # @since 0.3.0
+      #
+      def control_model
+        self.class.relationships[:controls].child_model
+      end
+
+      #
+      # Adds new behaviors to the model which are to be controlled.
+      #
+      # @param [Array<Symbol>] behaviors
+      #   The list of behaviors to be controlled.
+      #
+      # @example
+      #   control :code_exec,
+      #           :file_read,
+      #           :file_write,
+      #           :file_create
+      #
+      # @since 0.3.0
+      #
+      def control(*behaviors)
+        behaviors.each do |behavior|
+          self.controls << control_model.new(
+            :behavior => Vuln::Behavior[behavior]
+          )
+
+          control_helper(behavior)
+        end
+      end
+
+      #
+      # Lists the behaviors to be controlled.
+      #
+      # @return [Array<Symbol>]
+      #   The behaviors controlled by the model.
+      #
+      # @example
+      #   behaviors
+      #   # => [:code_exec, :file_read, :file_write, :file_create]
+      #
+      def behaviors
+        self.controls.map { |control| control.behavior.name.to_sym }
+      end
+
+      #
+      # Load the code from the cached file for the object. Will also
+      # attempt to load and extend any control modules for the controlled
+      # behaviors.
+      #
+      # @since 0.3.0
+      #
+      def load_original!
+        unless original_loaded?
+          self.behaviors.each { |name| control_helper name }
+        end
+
+        super
+      end
+    end
+  end
+end

data/lib/ronin/{payloads/helpers → controls}/exceptions.rb

@@ -1,5 +1,4 @@
 #
-#--
 # Ronin Exploits - A Ruby library for Ronin that provides exploitation and
 # payload crafting functionality.
 #
@@ -18,8 +17,7 @@
 # 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/payloads/exceptions/not_implemented'
-require 'ronin/payloads/exceptions/program_not_found'
+require 'ronin/controls/exceptions/not_implemented'
+require 'ronin/controls/exceptions/program_not_found'

data/lib/ronin/{payloads/arch.rb → controls/exceptions/not_implemented.rb}

@@ -1,5 +1,4 @@
 #
-#--
 # Ronin Exploits - A Ruby library for Ronin that provides exploitation and
 # payload crafting functionality.
 #
@@ -18,15 +17,11 @@
 # 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
-#++
 #
 
 module Ronin
-  class Arch
-
-    # The payloads which target the Arch
-    has n, :payloads,
-           :class_name => 'Ronin::Payloads::Payload'
-
+  module Controls
+    class NotImplemented < RuntimeError
+    end
   end
 end

data/lib/ronin/controls/exceptions/program_not_found.rb

@@ -0,0 +1,27 @@
+#
+# Ronin Exploits - A Ruby library for Ronin that provides exploitation and
+# payload crafting functionality.
+#
+# Copyright (c) 2007-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
+#
+
+module Ronin
+  module Controls
+    class ProgramNotFound < RuntimeError
+    end
+  end
+end