ronin-exploits 0.1.1 → 0.2.0

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

@@ -0,0 +1,24 @@
+#
+#--
+# 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/exceptions/unimplemented'

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

@@ -0,0 +1,31 @@
+#
+#--
+# 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 Payloads
+    module Helpers
+      class ProgramNotFound < RuntimeError
+      end
+    end
+  end
+end

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

@@ -0,0 +1,31 @@
+#
+#--
+# 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 Payloads
+    module Helpers
+      class Unimplemented < RuntimeError
+      end
+    end
+  end
+end

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

@@ -0,0 +1,187 @@
+#
+#--
+# 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/helpers/exceptions/unimplemented'
+
+module Ronin
+  module Payloads
+    module Helpers
+      module FileSystem
+        #
+        # Returns +true+ if the specified _path_ exists, returns +false+
+        # otherwise.
+        #
+        def exists?(path)
+          raise(Unimplemented,"the exists? method has not been implemented",caller)
+        end
+
+        #
+        # Returns +true+ if the specified _path_ is a file, returns +false+
+        # otherwise.
+        #
+        def file?(path)
+          raise(Unimplemented,"the file? method has not been implemented",caller)
+        end
+
+        #
+        # Returns +true+ if the specified _path_ is a directory, returns
+        # +false+ otherwise.
+        #
+        def dir?(path)
+          raise(Unimplemented,"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)
+        end
+
+        #
+        # Returns all the paths matching the specified globbed _pattern_.
+        #
+        def glob(pattern)
+          raise(Unimplemented,"the glob method has not been implemented",caller)
+        end
+
+        #
+        # Returns the current working directory.
+        #
+        def cwd
+          @cwd ||= ''
+        end
+
+        #
+        # Changes the current working directory to the specified _path_.
+        #
+        def chdir(path)
+          @cwd = path
+        end
+
+        #
+        # Goes up one directory.
+        #
+        def updir!
+          chdir(join_paths(cwd,'..'))
+        end
+
+        #
+        # 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)
+        end
+
+        #
+        # Writes the specified _contents_ to the file at the specified
+        # _path_.
+        #
+        def write_file(path,contents)
+          raise(Unimplemented,"the write_file method has not been implemented",caller)
+        end
+
+        #
+        # Appends the specified _contents_ to the file at the specified
+        # _path_.
+        #
+        def append_file(path,contents)
+          raise(Unimplemented,"the append_file method has not been implemented",caller)
+        end
+
+        #
+        # Touches the file at the specified _path_.
+        #
+        def touch(path)
+          write_file(path,'')
+        end
+
+        #
+        # Removes the file at the specified _path_.
+        #
+        def rm(path)
+          raise(Unimplemented,"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)
+        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)
+        end
+
+        protected
+
+        #
+        # Returns the File name separator to use.
+        #
+        def path_separator
+          File::SEPARATOR
+        end
+
+        #
+        # Joins the given _paths_ with the path_separator.
+        #
+        def join_paths(*paths)
+          paths.join(path_separator)
+        end
+
+        #
+        # Expands the specified _path_ to it's absolute form.
+        #
+        def expand_path(path)
+          File.expand_path(path)
+        end
+
+        #
+        # Converts the specified _sub_path_ to an absolute path, only if it
+        # is a realitive path.
+        #
+        def absolute_path(sub_path)
+          if sub_path[0..0] == path_separator
+            return sub_path
+          else
+            return expand_path(join_paths(cwd,sub_path))
+          end
+        end
+
+        #
+        # Raises an <tt>Errno::ENOENT</tt> exception if the specified
+        # _path_ cannot be found.
+        #
+        def file_not_found!(path)
+          path = path.to_s
+
+          raise(Errno::ENOENT,"No such file or directory - #{path.dump}",caller)
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,83 @@
+#
+#--
+# 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/helpers/exceptions/unimplemented'
+
+module Ronin
+  module Payloads
+    module Helpers
+      module RPC
+        def self.included(base)
+          base.module_eval do
+            #
+            # Exposes the method with the specified _name_.
+            #
+            def self.expose_method(name)
+              define_method(name) do |*arguments|
+                call(name,*arguments)
+              end
+            end
+          end
+        end
+
+        #
+        # 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)
+        end
+
+        #
+        # Evaluates the specified _code_.
+        #
+        def eval(code)
+          call(:eval,code)
+        end
+
+        #
+        # Exits with the given _status_.
+        #
+        def exit(status=0)
+          call(:exit,status)
+        end
+
+        protected
+
+        #
+        # Provides transparent access to remote methods using the
+        # specified _name_ and given _arguments_.
+        #
+        def method_missing(name,*arguments,&block)
+          name = name.to_s
+
+          if (name[-1..-1] != '=' && block.nil?)
+            return call(name,*arguments)
+          end
+
+          return super(name,*arguments,&block)
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,91 @@
+#
+#--
+# 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/helpers/exceptions/unimplemented'
+require 'ronin/payloads/helpers/exceptions/program_not_found'
+
+module Ronin
+  module Payloads
+    module Helpers
+      module Shell
+        #
+        # Returns the +Hash+ of environment variables to use for the
+        # shell.
+        #
+        def env
+          @env ||= {}
+        end
+
+        #
+        # Executes the specified _command_ with the given _arguments_.
+        #
+        def exec(command,*arguments)
+          raise(Unimplemented,"the exec method has not been implemented",caller)
+        end
+
+        #
+        # Executes the specified _command_ with the given _arguments_,
+        # and prints the output of the command.
+        #
+        def sh(command,*args)
+          puts exec(command,*args)
+        end
+
+        #
+        # Changes the current working directory of the shell to the
+        # specified _path_.
+        #
+        def cd(path)
+          exec('cd',path)
+          return path
+        end
+
+        #
+        # Returns the current working directory of the shell.
+        #
+        def pwd
+          exec('pwd').chomp
+        end
+
+        #
+        # Returns the listed files or directories using the given _arguments_.
+        #
+        def ls(*arguments)
+          exec('dir',*arguments).split(/\n\r?/)
+        end
+
+        protected
+
+        #
+        # Raises a ProgramNotFound exception if the program with the
+        # specified _name_ was not found.
+        #
+        def program_not_found!(name)
+          name = name.to_s
+
+          raise(ProgramNotFound,"the program #{name.dump} was not found",caller)
+        end
+      end
+    end
+  end
+end