ronin-exploits 0.2.1 → 0.3.0

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

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

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

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

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

@@ -0,0 +1,53 @@
+#
+# 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 FileOwnership
+        include FileSystem
+
+        #
+        # Changes the ownership of the file at the specified _path_, to
+        # that of the specified _user_.
+        #
+        # @since 0.3.0
+        #
+        def chown(path,user)
+          raise(NotImplemented,"the chown method has not been implemented",caller)
+        end
+
+        #
+        # Changes the group ownership of the file at the specified _path_,
+        # to that of the specified _group_.
+        #
+        # @since 0.3.0
+        #
+        def chgrp(path,group)
+          raise(NotImplemented,"the chgrp method has not been implemented",caller)
+        end
+      end
+    end
+  end
+end

data/lib/ronin/controls/helpers/file_read.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 FileRead
+        include FileSystem
+
+        #
+        # Returns +true+ if the specified _path_ exists, returns +false+
+        # otherwise.
+        #
+        # @since 0.3.0
+        #
+        def exists?(path)
+          raise(NotImplemented,"the exists? method has not been implemented",caller)
+        end
+
+        #
+        # Returns +true+ if the specified _path_ is a file, returns +false+
+        # otherwise.
+        #
+        # @since 0.3.0
+        #
+        def file?(path)
+          raise(NotImplemented,"the file? method has not been implemented",caller)
+        end
+
+        #
+        # Returns the contents of the file at the specified _path_.
+        #
+        # @since 0.3.0
+        #
+        def read_file(path)
+          raise(NotImplemented,"the read_file method has not been implemented",caller)
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,51 @@
+#
+# 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 FileRemove
+        include FileSystem
+
+        #
+        # Removes the file at the specified _path_.
+        #
+        # @since 0.3.0
+        #
+        def rm(path)
+          raise(NotImplemented,"the rm method has not been implemented",caller)
+        end
+
+        #
+        # Recursively removes the file or directory at the specified _path_.
+        #
+        # @since 0.3.0
+        #
+        def rm_r(path)
+          raise(NotImplemented,"the rm_r method has not been implemented",caller)
+        end
+      end
+    end
+  end
+end

data/lib/ronin/controls/helpers/file_write.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 FileWrite
+        include FileSystem
+
+        #
+        # Writes the specified _contents_ to the file at the specified
+        # _path_.
+        #
+        # @since 0.3.0
+        #
+        def write_file(path,contents)
+          raise(NotImplemented,"the write_file method has not been implemented",caller)
+        end
+
+        #
+        # Appends the specified _contents_ to the file at the specified
+        # _path_.
+        #
+        # @since 0.3.0
+        #
+        def append_file(path,contents)
+          raise(NotImplemented,"the append_file method has not been implemented",caller)
+        end
+
+        #
+        # Touches the file at the specified _path_.
+        #
+        # @since 0.3.0
+        #
+        def touch(path)
+          write_file(path,'')
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,39 @@
+#
+# 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'
+
+module Ronin
+  module Controls
+    module Helpers
+      module MemoryRead
+        #
+        # Reads _n_ bytes of memory at the specified _address_.
+        #
+        # @since 0.3.0
+        #
+        def read_memory(address,n=1)
+          raise(NotImplemented,"the read_memory method has not been implemented",caller)
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,39 @@
+#
+# 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'
+
+module Ronin
+  module Controls
+    module Helpers
+      module MemoryWrite
+        #
+        # Writes the specified _data_ to the specified _address_ in memory.
+        #
+        # @since 0.3.0
+        #
+        def write_memory(address,data)
+          raise(NotImplemented,"the write_memory method has not been implemented",caller)
+        end
+      end
+    end
+  end
+end

data/lib/ronin/exploits.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 'ronin/exploits/targets'

data/lib/ronin/exploits/{allow.rb → control.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 'ronin/vuln/behavior'
@@ -28,19 +26,17 @@ require 'ronin/model'
 
 module Ronin
   module Exploits
-    class Allow
+    class Control
 
       include Model
 
-      # The primary key of the allowance
+      # The primary key of the control
       property :id, Serial
 
-      # The behavior which is allowed
-      belongs_to :behavior,
-                 :child_key => [:behavior_id],
-                 :class_name => 'Ronin::Vuln::Behavior'
+      # The behavior which is controlled
+      belongs_to :behavior, :model => 'Ronin::Vuln::Behavior'
 
-      # The exploit which facilitates the behavior
+      # The exploit which provides the control
       belongs_to :exploit
 
       # Validates