ronin-exploits 0.2.0 → 0.2.1

data/lib/ronin/model/has_default_port.rb

@@ -0,0 +1,54 @@
+#
+#--
+# 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 'dm-core'
+
+module Ronin
+  module Model
+    module HasDefaultPort
+      def self.included(base)
+        base.module_eval do
+          # Default port to use
+          property :default_port, Integer
+
+          validates_present :default_port
+        end
+      end
+
+      #
+      # Creates a new Model with the given _attributes_ and given _block_.
+      #
+      # _attributes_ may contain the following keys:
+      # <tt>:default_port</tt>:: The default port to use, defaults to the
+      #                          +DEFAULT_PORT+ constant.
+      #
+      def initialize(attributes={},&block)
+        if self.class.const_defined?('DEFAULT_PORT')
+          attributes = {:default_port => self.class.const_get('DEFAULT_PORT')}.merge(attributes)
+        end
+
+        super(attributes,&block)
+      end
+    end
+  end
+end

data/lib/ronin/model/targets_arch.rb

@@ -21,33 +21,31 @@
 #++
 #
 
-require 'ronin/targeted_arch'
+require 'ronin/arch'
 
 module Ronin
   module Model
     module TargetsArch
       def self.included(base)
         base.module_eval do
-          # The payloads targeted architecture
-          belongs_to :arch,
-                     :child_key => [:arch_id],
-                     :class_name => 'Ronin::TargetedArch'
+          # The targeted architecture
+          belongs_to :arch
 
           #
           # Returns the current targeted arch if no _name_ is given. If a
-          # _name_ is given, a new TargetedArch object will be created
-          # with the given _name_ and associated with the target.
+          # _name_ is given, a new Arch object will be created with the
+          # given _name_ and associated with the target.
           #
           #   target.arch
           #   # => nil
           #
           #   target.arch :i686
-          #   # => #<Ronin::TargetedArch type=Ronin::TargetedArch id=nil
-          #   # name="i686" endian="little" address_length=4>
+          #   # => #<Ronin::Arch type=Ronin::Arch id=nil name="i686"
+          #   # endian="little" address_length=4>
           #
           def arch(name=nil)
             if name
-              return self.arch = TargetedArch[name]
+              return self.arch = Arch[name]
             else
               return arch_association
             end

data/lib/ronin/model/targets_os.rb

@@ -21,33 +21,33 @@
 #++
 #
 
-require 'ronin/targeted_os'
+require 'ronin/os'
 
 module Ronin
   module Model
     module TargetsOS
       def self.included(base)
         base.module_eval do
-          # The payloads targeted OS
+          # The targeted OS
           belongs_to :os,
-                     :child_key => [:os_id],
-                     :class_name => 'Ronin::TargetedOS'
+                     :child_key => [:od_id],
+                     :class_name => 'Ronin::OS'
 
           #
           # Returns the current targeted OS if no _arguments_ are given. If
-          # _arguments_ are given, a new TargetedOS object will be created
-          # from the given _arguments_ and associated with the target.
+          # _arguments_ are given, a new OS object will be created from the
+          # given _arguments_ and associated with the target.
           #
           #   target.os
           #   # => nil
           #
           #   target.os(:name => 'FreeBSD', :version => '7.1')
-          #   # => #<Ronin::TargetedOS type=Ronin::TargetedOS id=nil
-          #   # name="FreeBSD" version="7.1">
+          #   # => #<Ronin::OS type=Ronin::OS id=nil name="FreeBSD"
+          #   # version="7.1">
           #
           def os(*arguments)
             unless arguments.empty?
-              return self.os = TargetedOS.first_or_create(*arguments)
+              return self.os = OS.first_or_create(*arguments)
             else
               return os_association
             end

data/lib/ronin/payloads.rb

@@ -24,6 +24,7 @@
 require 'ronin/payloads/encoders'
 require 'ronin/payloads/payload'
 require 'ronin/payloads/binary_payload'
+require 'ronin/payloads/asm_payload'
 require 'ronin/payloads/nops'
 require 'ronin/payloads/shellcode'
 require 'ronin/database'

data/lib/ronin/payloads/arch.rb

@@ -0,0 +1,32 @@
+#
+#--
+# 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
+  class Arch
+
+    # The payloads which target the Arch
+    has n, :payloads,
+           :class_name => 'Ronin::Payloads::Payload'
+
+  end
+end

data/lib/ronin/payloads/asm_payload.rb

@@ -0,0 +1,34 @@
+#
+#--
+# 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/payloads/binary_payload'
+
+module Ronin
+  module Payloads
+    class ASMPayload < BinaryPayload
+
+      contextify :ronin_asm_payload
+
+    end
+  end
+end

data/lib/ronin/payloads/encoder.rb

@@ -21,6 +21,8 @@
 #++
 #
 
+require 'ronin/model/has_name'
+require 'ronin/model/has_description'
 require 'ronin/model/targets_arch'
 require 'ronin/model/targets_os'
 require 'ronin/cacheable'
@@ -33,6 +35,8 @@ module Ronin
 
       include Parameters
       include Cacheable
+      include Model::HasName
+      include Model::HasDescription
       include Model::TargetsArch
       include Model::TargetsOS
 
@@ -41,36 +45,38 @@ module Ronin
       # Primary key of the payload
       property :id, Serial
 
-      # Name of the specific payload
-      property :name, String, :index => true
-
-      # Description of the payload
-      property :description, Text
+      #
+      # Creates a new Encoder object with the given _arguments_.
+      #
+      def initialize(*arguments)
+        super(*arguments)
 
-      # Validations
-      validates_present :name
+        initialize_params(*arguments)
+      end
 
       #
-      # Finds all payloads with names like the specified _name_.
+      # Default method which will encode the specified _data_.
+      # Returns the specified _data_ by default.
       #
-      def self.named(name)
-        self.all(:name.like => "%#{name}%")
+      def call(data)
+        data
       end
 
       #
-      # Finds all payloads with descriptions like the specified
-      # _description_.
+      # Returns the name of the payload encoder.
       #
-      def self.describing(description)
-        self.all(:description.like => "%#{description}%")
+      def to_s
+        self.name.to_s
       end
 
       #
-      # Default method which will encode the specified _data_.
-      # Returns the specified _data_ by default.
+      # Inspects the contents of the payload encoder.
       #
-      def call(data)
-        data
+      def inspect
+        str = "#{self.class}: #{self}"
+        str << " #{self.params.inspect}" unless self.params.empty?
+
+        return "#<#{str}>"
       end
 
     end

data/lib/ronin/payloads/helpers/exceptions.rb

@@ -21,4 +21,5 @@
 #++
 #
 
-require 'ronin/payloads/exceptions/unimplemented'
+require 'ronin/payloads/exceptions/not_implemented'
+require 'ronin/payloads/exceptions/program_not_found'

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

@@ -24,7 +24,7 @@
 module Ronin
   module Payloads
     module Helpers
-      class Unimplemented < RuntimeError
+      class NotImplemented < RuntimeError
       end
     end
   end

data/lib/ronin/payloads/helpers/file_system.rb

@@ -21,7 +21,7 @@
 #++
 #
 
-require 'ronin/payloads/helpers/exceptions/unimplemented'
+require 'ronin/payloads/helpers/exceptions/not_implemented'
 
 module Ronin
   module Payloads
@@ -32,7 +32,7 @@ module Ronin
         # otherwise.
         #
         def exists?(path)
-          raise(Unimplemented,"the exists? method has not been implemented",caller)
+          raise(NotImplemented,"the exists? method has not been implemented",caller)
         end
 
         #
@@ -40,7 +40,7 @@ module Ronin
         # otherwise.
         #
         def file?(path)
-          raise(Unimplemented,"the file? method has not been implemented",caller)
+          raise(NotImplemented,"the file? method has not been implemented",caller)
         end
 
         #
@@ -48,21 +48,21 @@ module Ronin
         # +false+ otherwise.
         #
         def dir?(path)
-          raise(Unimplemented,"the dir? method has not been implemented",caller)
+          raise(NotImplemented,"the dir? method has not been implemented",caller)
         end
 
         #
         # Returns the contents of the directory at the specified _path_.
         #
         def dir(path)
-          raise(Unimplemented,"the dir method has not been implemented",caller)
+          raise(NotImplemented,"the dir method has not been implemented",caller)
         end
 
         #
         # Returns all the paths matching the specified globbed _pattern_.
         #
         def glob(pattern)
-          raise(Unimplemented,"the glob method has not been implemented",caller)
+          raise(NotImplemented,"the glob method has not been implemented",caller)
         end
 
         #
@@ -90,7 +90,7 @@ module Ronin
         # Returns the contents of the file at the specified _path_.
         #
         def read_file(path)
-          raise(Unimplemented,"the read_file method has not been implemented",caller)
+          raise(NotImplemented,"the read_file method has not been implemented",caller)
         end
 
         #
@@ -98,7 +98,7 @@ module Ronin
         # _path_.
         #
         def write_file(path,contents)
-          raise(Unimplemented,"the write_file method has not been implemented",caller)
+          raise(NotImplemented,"the write_file method has not been implemented",caller)
         end
 
         #
@@ -106,7 +106,7 @@ module Ronin
         # _path_.
         #
         def append_file(path,contents)
-          raise(Unimplemented,"the append_file method has not been implemented",caller)
+          raise(NotImplemented,"the append_file method has not been implemented",caller)
         end
 
         #
@@ -120,21 +120,21 @@ module Ronin
         # Removes the file at the specified _path_.
         #
         def rm(path)
-          raise(Unimplemented,"the rm method has not been implemented",caller)
+          raise(NotImplemented,"the rm method has not been implemented",caller)
         end
 
         #
         # Removes the directory at the specified _path_.
         #
         def rmdir(path)
-          raise(Unimplemented,"the rmdir method has not been implemented",caller)
+          raise(NotImplemented,"the rmdir method has not been implemented",caller)
         end
 
         #
         # Recursively removes the file or directory at the specified _path_.
         #
         def rm_r(path)
-          raise(Unimplemented,"the rm_r method has not been implemented",caller)
+          raise(NotImplemented,"the rm_r method has not been implemented",caller)
         end
 
         protected

data/lib/ronin/payloads/helpers/rpc.rb

@@ -21,7 +21,7 @@
 #++
 #
 
-require 'ronin/payloads/helpers/exceptions/unimplemented'
+require 'ronin/payloads/helpers/exceptions/not_implemented'
 
 module Ronin
   module Payloads
@@ -34,7 +34,7 @@ module Ronin
             #
             def self.expose_method(name)
               define_method(name) do |*arguments|
-                call(name,*arguments)
+                call_method(name,*arguments)
               end
             end
           end
@@ -44,22 +44,22 @@ module Ronin
         # Calls the specified _method_ with the given _arguments_.
         # Returns the return-value of the method-call.
         #
-        def call(method,*arguments)
-          raise(Unimplemented,"the call method is unimplemented",caller)
+        def call_method(method,*arguments)
+          raise(NotImplemented,"the call method is unimplemented",caller)
         end
 
         #
         # Evaluates the specified _code_.
         #
         def eval(code)
-          call(:eval,code)
+          call_method(:eval,code)
         end
 
         #
         # Exits with the given _status_.
         #
         def exit(status=0)
-          call(:exit,status)
+          call_method(:exit,status)
         end
 
         protected
@@ -72,7 +72,7 @@ module Ronin
           name = name.to_s
 
           if (name[-1..-1] != '=' && block.nil?)
-            return call(name,*arguments)
+            return call_method(name,*arguments)
           end
 
           return super(name,*arguments,&block)