ronin-exploits 0.2.1 → 0.3.0

data/lib/ronin/{exploits/arch.rb → generators/exploits/static.rb}

@@ -1,5 +1,4 @@
 #
-#--
 # Ronin Exploits - A Ruby library for Ronin that provides exploitation and
 # payload crafting functionality.
 #
@@ -18,17 +17,14 @@
 # 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/arch'
+require 'ronin/static'
 
 module Ronin
-  class Arch
-
-    # The exploit targets for the Arch
-    has n, :targets,
-           :class_name => 'Ronin::Exploits::Target'
-
+  module Generators
+    module Exploits
+      Static.directory File.join(File.dirname(__FILE__),'..','..','..','..','static')
+    end
   end
 end

data/lib/ronin/generators/exploits/web.rb

@@ -0,0 +1,45 @@
+#
+# 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/generators/exploits/remote'
+
+module Ronin
+  module Generators
+    module Exploits
+      class Web < Remote
+
+        class_option :url_path, :type => :string
+        class_option :url_query, :type => :string
+
+        #
+        # Generate a Web exploit.
+        #
+        # @since 0.3.0
+        #
+        def generate
+          template File.join('ronin','generators','exploits','web.erb'),
+                   self.path
+        end
+
+      end
+    end
+  end
+end

data/lib/ronin/generators/payloads.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/generators/payloads/static'
+require 'ronin/generators/payloads/payload'

data/lib/ronin/generators/payloads/binary_payload.rb

@@ -0,0 +1,42 @@
+#
+# 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/generators/payloads/payload'
+
+module Ronin
+  module Generators
+    module Payloads
+      class BinaryPayload < Payload
+
+        #
+        # Generate a binary payload.
+        #
+        # @since 0.3.0
+        #
+        def generate
+          template File.join('ronin','generators','payloads','binary_payload.erb'),
+                   self.path
+        end
+
+      end
+    end
+  end
+end

data/lib/ronin/generators/payloads/nops.rb

@@ -0,0 +1,42 @@
+#
+# 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/generators/payloads/binary_payload'
+
+module Ronin
+  module Generators
+    module Payloads
+      class Nops < BinaryPayload
+
+        #
+        # Generate a Nops payload.
+        #
+        # @since 0.3.0
+        #
+        def generate
+          template File.join('ronin','generators','payloads','nops.erb'),
+                   self.path
+        end
+
+      end
+    end
+  end
+end

data/lib/ronin/generators/payloads/payload.rb

@@ -0,0 +1,66 @@
+#
+# 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/generators/payloads/static'
+require 'ronin/generators/generator'
+
+require 'ronin/author'
+
+module Ronin
+  module Generators
+    module Payloads
+      class Payload < Generator
+
+        # Default name to give the payload
+        DEFAULT_NAME = 'Payload'
+
+        # Default version to give the payload
+        DEFAULT_VERSION = '0.1'
+
+        # Default description to give the payload
+        DEFAULT_DESCRIPTION = %{This is a payload.}
+
+        # Default authors of the payload
+        DEFAULT_AUTHORS = [Author::ANONYMOUSE]
+
+        class_option :helpers, :type => :array, :default => []
+        class_option :name, :type => :string, :default => DEFAULT_NAME
+        class_option :version, :type => :string, :default => DEFAULT_VERSION
+        class_option :description, :type => :string, :default => DEFAULT_DESCRIPTION
+        class_option :authors, :type => :array, :default => DEFAULT_AUTHORS
+        class_option :controls, :type => :array, :default => []
+
+        argument :path, :type => :string, :require => true
+
+        #
+        # Generate a basic payload.
+        #
+        # @since 0.3.0
+        #
+        def generate
+          template File.join('ronin','generators','payloads','payload.erb'),
+                   self.path
+        end
+
+      end
+    end
+  end
+end

data/lib/ronin/generators/payloads/shellcode.rb

@@ -0,0 +1,42 @@
+#
+# 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/generators/payloads/binary_payload'
+
+module Ronin
+  module Generators
+    module Payloads
+      class Shellcode < BinaryPayload
+
+        #
+        # Generate a Shellcode payload.
+        #
+        # @since 0.3.0
+        #
+        def generate
+          template File.join('ronin','generators','payloads','shellcode.erb'),
+                   self.path
+        end
+
+      end
+    end
+  end
+end

data/lib/ronin/generators/payloads/static.rb

@@ -0,0 +1,30 @@
+#
+# 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/static'
+
+module Ronin
+  module Generators
+    module Payloads
+      Static.directory File.join(File.dirname(__FILE__),'..','..','..','..','static')
+    end
+  end
+end

data/lib/ronin/model/has_default_port.rb

@@ -1,5 +1,4 @@
 #
-#--
 # Ronin Exploits - A Ruby library for Ronin that provides exploitation and
 # payload crafting functionality.
 #
@@ -18,7 +17,6 @@
 # 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 'dm-core'
@@ -36,11 +34,13 @@ module Ronin
       end
 
       #
-      # Creates a new Model with the given _attributes_ and given _block_.
+      # Creates a new Model.
       #
-      # _attributes_ may contain the following keys:
-      # <tt>:default_port</tt>:: The default port to use, defaults to the
-      #                          +DEFAULT_PORT+ constant.
+      # @param [Hash] attributes
+      #   Additional attributes to initialize the model with.
+      #
+      # @option attributes [Integer] :default_port (DEFAULT_PORT)
+      #   The default port to connect to.
       #
       def initialize(attributes={},&block)
         if self.class.const_defined?('DEFAULT_PORT')

data/lib/ronin/model/targets_arch.rb

@@ -1,5 +1,4 @@
 #
-#--
 # Ronin Exploits - A Ruby library for Ronin that provides exploitation and
 # payload crafting functionality.
 #
@@ -18,27 +17,36 @@
 # 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/arch'
 
+require 'extlib'
+
 module Ronin
   module Model
     module TargetsArch
       def self.included(base)
         base.module_eval do
           # The targeted architecture
-          belongs_to :arch
+          belongs_to :arch,
+                     :nullable => true
 
           #
-          # Returns the current targeted arch if no _name_ is given. If a
-          # _name_ is given, a new Arch object will be created with the
-          # given _name_ and associated with the target.
+          # The targeted architecture.
+          #
+          # @param [Symbol] name
+          #   If a name is given, a new Arch with the matching name will be
+          #   targeted.
           #
+          # @return [Arch]
+          #   The architecture to target.
+          #
+          # @example Accessing the targeted architecture
           #   target.arch
           #   # => nil
           #
+          # @example Setting the targeted architecture
           #   target.arch :i686
           #   # => #<Ronin::Arch type=Ronin::Arch id=nil name="i686"
           #   # endian="little" address_length=4>
@@ -47,10 +55,13 @@ module Ronin
             if name
               return self.arch = Arch[name]
             else
-              return arch_association
+              return relationships[:arch].get(self)
             end
           end
         end
+
+        model_name = base.name.split('::').last.snake_case.plural.to_sym
+        Arch.has Arch.n, model_name, :model => base.name
       end
     end
   end

data/lib/ronin/model/targets_os.rb

@@ -1,5 +1,4 @@
 #
-#--
 # Ronin Exploits - A Ruby library for Ronin that provides exploitation and
 # payload crafting functionality.
 #
@@ -18,11 +17,12 @@
 # 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/os'
 
+require 'extlib'
+
 module Ronin
   module Model
     module TargetsOS
@@ -30,17 +30,24 @@ module Ronin
         base.module_eval do
           # The targeted OS
           belongs_to :os,
-                     :child_key => [:od_id],
-                     :class_name => 'Ronin::OS'
+                     :model => 'Ronin::OS',
+                     :nullable => true
 
           #
-          # Returns the current targeted OS if no _arguments_ are given. If
-          # _arguments_ are given, a new OS object will be created from the
-          # given _arguments_ and associated with the target.
+          # The targeted OS.
+          #
+          # @param [Array] arguments
+          #   If any arguments are given, they will be used to create a new
+          #   OS that will be targeted.
           #
+          # @return [OS]
+          #   The targeted OS.
+          #
+          # @example Accessing the targeted OS.
           #   target.os
           #   # => nil
           #
+          # @example Setting the targeted OS.
           #   target.os(:name => 'FreeBSD', :version => '7.1')
           #   # => #<Ronin::OS type=Ronin::OS id=nil name="FreeBSD"
           #   # version="7.1">
@@ -49,10 +56,13 @@ module Ronin
             unless arguments.empty?
               return self.os = OS.first_or_create(*arguments)
             else
-              return os_association
+              return relationships[:os].get(self)
             end
           end
         end
+
+        model_name = base.name.split('::').last.snake_case.plural.to_sym
+        OS.has OS.n, model_name, :model => base.name
       end
     end
   end