ronin-exploits 0.2.1 → 0.3.0

data/lib/ronin/controls/file_system.rb

@@ -0,0 +1,145 @@
+#
+# 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
+    module FileSystem
+      #
+      # The current working directory, all file-system actions will
+      # be performed relative to.
+      #
+      # @return [String]
+      #   The current working directory.
+      #
+      # @since 0.3.0
+      #
+      def cwd
+        @cwd ||= ''
+      end
+
+      #
+      # Changes the current working directory.
+      #
+      # @param [String] path
+      #   The new current working directory.
+      #
+      # @return [String]
+      #   The new current working directory.
+      #
+      # @since 0.3.0
+      #
+      def chdir(path)
+        @cwd = path
+      end
+
+      #
+      # Goes up one directory.
+      #
+      # @return [String]
+      #   The new current working directory.
+      #
+      # @since 0.3.0
+      #
+      def updir!
+        chdir(join_paths(cwd,'..'))
+      end
+
+      protected
+
+      #
+      # @return [String]
+      #   The File name separator to use.
+      #
+      # @since 0.3.0
+      #
+      def path_separator
+        File::SEPARATOR
+      end
+
+      #
+      # Joins multiple paths with the path_separator.
+      #
+      # @param [Array] paths
+      #   The paths to be joined.
+      #
+      # @return [String]
+      #   The joined paths.
+      #
+      # @since 0.3.0
+      #
+      def join_paths(*paths)
+        paths.join(path_separator)
+      end
+
+      #
+      # Expands a path into it's absolute form.
+      #
+      # @param [String] path
+      #   The path to be expanded.
+      #
+      # @return [String]
+      #   The expanded path.
+      #
+      # @since 0.3.0
+      #
+      def expand_path(path)
+        File.expand_path(path)
+      end
+
+      #
+      # Converts a sub-path to an absolute path, but only if it is a
+      # realitive path.
+      #
+      # @param [String] sub_path
+      #   The sub-path to expand.
+      #
+      # @return [String]
+      #   An absolute path.
+      #
+      # @since 0.3.0
+      #
+      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
+
+      #
+      # Specifies that the path could not be found.
+      #
+      # @param [String] path
+      #   The path which could not be found.
+      #
+      # @raise [Errno::ENOENT]
+      #   The file could not be found.
+      #
+      # @since 0.3.0
+      #
+      def file_not_found!(path)
+        path = path.to_s
+
+        raise(Errno::ENOENT,"No such file or directory - #{path.dump}",caller)
+      end
+    end
+  end
+end

data/lib/ronin/{exploits/os.rb → controls/helpers.rb}

@@ -1,5 +1,4 @@
 #
-#--
 # Ronin Exploits - A Ruby library for Ronin that provides exploitation and
 # payload crafting functionality.
 #
@@ -18,17 +17,17 @@
 # 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'
-
-module Ronin
-  class OS
-
-    # The exploit targets for the OS
-    has n, :targets,
-           :class_name => 'Ronin::Exploits::Target'
-
-  end
-end
+require 'ronin/controls/helpers/memory_read'
+require 'ronin/controls/helpers/memory_write'
+require 'ronin/controls/helpers/file_read'
+require 'ronin/controls/helpers/file_write'
+require 'ronin/controls/helpers/file_remove'
+require 'ronin/controls/helpers/file_ownership'
+require 'ronin/controls/helpers/file_mtime'
+require 'ronin/controls/helpers/file_ctime'
+require 'ronin/controls/helpers/dir_create'
+require 'ronin/controls/helpers/dir_listing'
+require 'ronin/controls/helpers/dir_remove'
+require 'ronin/controls/helpers/command_exec'

data/lib/ronin/controls/helpers/command_exec.rb

@@ -0,0 +1,143 @@
+#
+# 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/not_implemented'
+require 'ronin/controls/exceptions/program_not_found'
+require 'ronin/ui/shell'
+
+module Ronin
+  module Controls
+    module Helpers
+      module CommandExec
+        #
+        # @return [Hash]
+        #   The environment variables to use in the shell.
+        #
+        # @since 0.3.0
+        #
+        def env
+          @env ||= {}
+        end
+
+        #
+        # Execute a given command with optional arguments.
+        #
+        # @param [String] command
+        #   The command to execute.
+        #
+        # @param [Array<String>] arguments
+        #   The additional command-line arguments to use with the command.
+        #
+        # @since 0.3.0
+        #
+        def exec(command,*arguments)
+          raise(NotImplemented,"the exec method has not been implemented",caller)
+        end
+
+        #
+        # Executes the specified _command_ with the given _arguments_,
+        # and prints the output of the command.
+        #
+        # @param [String] command
+        #   The command to execute.
+        #
+        # @param [Array<String>] arguments
+        #   The additional command-line arguments to use with the command.
+        #
+        # @return [nil]
+        #
+        # @since 0.3.0
+        #
+        def sh(command,*args)
+          puts exec(command,*args)
+        end
+
+        #
+        # Changes the current working directory of the shell.
+        #
+        # @param [String] path
+        #   The new current directory to use.
+        #
+        # @return [String]
+        #   The new current directory.
+        #
+        # @since 0.3.0
+        #
+        def cd(path)
+          exec('cd',path)
+          return path
+        end
+
+        #
+        # @return [String]
+        #   The current working directory of the shell.
+        #
+        # @since 0.3.0
+        #
+        def pwd
+          exec('pwd').chomp
+        end
+
+        #
+        # Lists the contents of a given directory or the current working
+        # directory.
+        #
+        # @param [Array] arguments
+        #   Additional command-line arguments.
+        #
+        # @return [Array]
+        #   The contents of a directory.
+        #
+        # @since 0.3.0
+        #
+        def ls(*arguments)
+          exec('dir',*arguments).split(/\n\r?/)
+        end
+
+        #
+        # Starts an interactive shell for running commands.
+        #
+        def shell
+          UI::Shell.start(:prompt => '$') do |shell,line|
+            sh(line)
+          end
+        end
+
+        protected
+
+        #
+        # Raises a ProgramNotFound exception if a program could not be
+        # found.
+        #
+        # @param [String, Symbol] name
+        #   The name of the program which could not be found.
+        #
+        # @since 0.3.0
+        #
+        def program_not_found!(name)
+          name = name.to_s
+
+          raise(ProgramNotFound,"the program #{name.dump} was not found",caller)
+        end
+      end
+    end
+  end
+end

data/lib/ronin/controls/helpers/dir_create.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/controls/exceptions/not_implemented'
+require 'ronin/controls/file_system'
+
+module Ronin
+  module Controls
+    module Helpers
+      module DirCreate
+        include FileSystem
+
+        #
+        # Creates a new directory at the specified _path_.
+        #
+        # @since 0.3.0
+        #
+        def mkdir(path)
+          raise(NotImplemented,"the mkdir method has not been implemented",caller)
+        end
+      end
+    end
+  end
+end

data/lib/ronin/controls/helpers/dir_listing.rb

@@ -0,0 +1,62 @@
+#
+# 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/not_implemented'
+require 'ronin/controls/file_system'
+
+module Ronin
+  module Controls
+    module Helpers
+      module DirListing
+        include FileSystem
+
+        #
+        # Returns +true+ if the specified _path_ is a directory, returns
+        # +false+ otherwise.
+        #
+        # @since 0.3.0
+        #
+        def dir?(path)
+          raise(NotImplemented,"the dir? method has not been implemented",caller)
+        end
+
+        #
+        # Returns the contents of the directory at the specified _path_.
+        #
+        # @since 0.3.0
+        #
+        def dir(path)
+          raise(NotImplemented,"the dir method has not been implemented",caller)
+        end
+
+        #
+        # Returns all the paths matching the specified globbed _pattern_.
+        #
+        # @since 0.3.0
+        #
+        def glob(pattern)
+          raise(NotImplemented,"the glob method has not been implemented",caller)
+        end
+
+      end
+    end
+  end
+end

data/lib/ronin/controls/helpers/dir_remove.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/controls/exceptions/not_implemented'
+require 'ronin/controls/file_system'
+
+module Ronin
+  module Controls
+    module Helpers
+      module DirRemove
+        include FileSystem
+
+        #
+        # Removes the directory at the specified _path_.
+        #
+        # @since 0.3.0
+        #
+        def rmdir(path)
+          raise(NotImplemented,"the rmdir method has not been implemented",caller)
+        end
+      end
+    end
+  end
+end