ronin-exploits 0.3.1 → 1.0.0.beta1

data/lib/ronin/controls/behaviors.rb

@@ -1,133 +0,0 @@
-#
-# 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/controls/exceptions/not_implemented.rb

@@ -1,27 +0,0 @@
-#
-# 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 NotImplemented < RuntimeError
-    end
-  end
-end

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

@@ -1,27 +0,0 @@
-#
-# 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

data/lib/ronin/controls/exceptions.rb

@@ -1,23 +0,0 @@
-#
-# 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'

data/lib/ronin/controls/file_system.rb

@@ -1,145 +0,0 @@
-#
-# 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/controls/helpers/command_exec.rb

@@ -1,143 +0,0 @@
-#
-# 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

@@ -1,42 +0,0 @@
-#
-# 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

@@ -1,62 +0,0 @@
-#
-# 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

@@ -1,42 +0,0 @@
-#
-# 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

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

@@ -1,52 +0,0 @@
-#
-# 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 FileCtime
-        include FileSystem
-
-        #
-        # Returns the creation time of the file at the specified _path_.
-        #
-        # @since 0.3.0
-        #
-        def file_ctime(path)
-          raise(NotImplemented,"the file_ctime method has not been implemented",caller)
-        end
-
-        #
-        # Changes the creation time of the file at the specified _path_,
-        # to that of the specified _new_time_.
-        #
-        # @since 0.3.0
-        #
-        def change_file_ctime(path,new_time)
-          raise(NotImplemented,"the change_file_ctime method has not been implemented",caller)
-        end
-      end
-    end
-  end
-end