ronin-support 0.1.0.pre1

data/lib/ronin/network/smtp.rb

@@ -0,0 +1,24 @@
+#
+# Ronin - A Ruby platform for exploit development and security research.
+#
+# Copyright (c) 2006-2010 Hal Brodigan (postmodern.mod3 at gmail.com)
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library 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
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin Street, Fifth Floor,
+# Boston, MA  02110-1301  USA
+#
+
+require 'ronin/network/smtp/email'
+require 'ronin/network/smtp/smtp'
+require 'ronin/network/extensions/smtp'

data/lib/ronin/network/smtp/email.rb

@@ -0,0 +1,143 @@
+#
+# Ronin - A Ruby platform for exploit development and security research.
+#
+# Copyright (c) 2006-2010 Hal Brodigan (postmodern.mod3 at gmail.com)
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library 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
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin Street, Fifth Floor,
+# Boston, MA  02110-1301  USA
+#
+
+module Ronin
+  module Network
+    module SMTP
+      class Email
+
+        # Sender of the email
+        attr_accessor :from
+
+        # Recipient of the email
+        attr_accessor :to
+
+        # Subject of the email
+        attr_accessor :subject
+
+        # Date of the email
+        attr_accessor :date
+
+        # Unique message-id string
+        attr_accessor :message_id
+
+        # Body of the email
+        attr_accessor :body
+
+        #
+        # Creates a new Email object.
+        #
+        # @param [Hash] options
+        #   Additional options.
+        #
+        # @option options [String] :from
+        #   The address the email is from.
+        #
+        # @option options [String] :to
+        #   The address that the email should be sent to.
+        #
+        # @option options [String] :subject
+        #   The subject of the email.
+        #
+        # @option options [String] :message_id
+        #   Message-ID of the email.
+        #
+        # @option options [String, Time] :date (Time.now)
+        #   The date the email was sent on.
+        #
+        # @option options [String, Array<String>] :body
+        #   The body of the email.
+        #
+        # @yield [email]
+        #   If a block is given, it will be passed the newly created email
+        #   object.
+        #
+        # @yieldparam [Email] email
+        #   The newly created email object.
+        #
+        def initialize(options={})
+          @from = options[:from]
+          @to = options[:to]
+          @subject = options[:subject]
+          @date = options[:date] || Time.now
+          @message_id = options[:message_id]
+          @body = []
+
+          if options[:body].kind_of?(Array)
+            @body += options[:body]
+          else
+            @body << options[:body]
+          end
+
+          yield self if block_given?
+        end
+
+        #
+        # Formats the email into a SMTP message.
+        #
+        # @return [String]
+        #   Properly formatted SMTP message.
+        #
+        # @see http://www.ruby-doc.org/stdlib/libdoc/net/smtp/rdoc/classes/Net/SMTP.html
+        #
+        def to_s
+          address = lambda { |info|
+            if info.kind_of?(Array)
+              return "#{info[0]} <#{info[1]}>"
+            elsif info.kind_of?(Hash)
+              return "#{info[:name]} <#{info[:email]}>"
+            else
+              return info
+            end
+          }
+
+          message = []
+
+          if @from
+            message << "From: #{address.call(@from)}"
+          end
+
+          if @to
+            message << "To: #{address.call(@to)}"
+          end
+
+          if @subject
+            message << "Subject: #{@subject}"
+          end
+
+          if @date
+            message << "Date: #{@date}"
+          end
+
+          if @message_id
+            message << "Message-Id: <#{@message_id}>"
+          end
+
+          message << ''
+          message += @body
+
+          return message.join("\n")
+        end
+
+      end
+    end
+  end
+end

data/lib/ronin/network/smtp/smtp.rb

@@ -0,0 +1,68 @@
+#
+# Ronin - A Ruby platform for exploit development and security research.
+#
+# Copyright (c) 2006-2010 Hal Brodigan (postmodern.mod3 at gmail.com)
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library 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
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin Street, Fifth Floor,
+# Boston, MA  02110-1301  USA
+#
+
+require 'ronin/network/smtp/email'
+
+module Ronin
+  module Network
+    module SMTP
+      # Default smtp port
+      DEFAULT_PORT = 25
+
+      #
+      # @return [Integer]
+      #   The default Ronin SMTP port.
+      #
+      def SMTP.default_port
+        @default_port ||= DEFAULT_PORT
+      end
+
+      #
+      # Sets the default Ronin SMTP port.
+      #
+      # @param [Integer] port
+      #   The new default Ronin SMTP port.
+      #
+      def SMTP.default_port=(port)
+        @default_port = port
+      end
+
+      #
+      # Creates a properly formatted email.
+      #
+      # @yield [email]
+      #   If a block is given, it will be passed the newly created Email
+      #   object.
+      #
+      # @yieldparam [Ronin::Network::Email::SMTP] email
+      #   The new Email object.
+      #
+      # @return [String]
+      #   Formatted SMTP email.
+      #
+      # @see Ronin::Network::SMTP::Email
+      #
+      def SMTP.message(options={},&block)
+        Email.new(options,&block).to_s
+      end
+    end
+  end
+end

data/lib/ronin/network/ssl.rb

@@ -0,0 +1,47 @@
+#
+# Ronin - A Ruby platform for exploit development and security research.
+#
+# Copyright (c) 2006-2010 Hal Brodigan (postmodern.mod3 at gmail.com)
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library 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
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin Street, Fifth Floor,
+# Boston, MA  02110-1301  USA
+#
+
+require 'ronin/network/extensions/ssl'
+
+module Ronin
+  module Network
+    module SSL
+      #
+      # Returns the OpenSSL verify mode.
+      #
+      # @param [Symbol, String] mode
+      #   The name of the verify mode.
+      #
+      # @return [Integer]
+      #   The verify mode number used by OpenSSL.
+      #
+      def SSL.verify(mode=nil)
+        verify_mode = 'VERIFY_' + (mode || :none).to_s.upcase
+
+        unless OpenSSL::SSL.const_defined?(verify_mode)
+          raise(RuntimeError,"unknown verify mode #{mode}")
+        end
+
+        return OpenSSL::SSL.const_get(verify_mode)
+      end
+    end
+  end
+end

data/lib/ronin/network/tcp.rb

@@ -0,0 +1,22 @@
+#
+# Ronin - A Ruby platform for exploit development and security research.
+#
+# Copyright (c) 2006-2010 Hal Brodigan (postmodern.mod3 at gmail.com)
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library 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
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin Street, Fifth Floor,
+# Boston, MA  02110-1301  USA
+#
+
+require 'ronin/network/extensions/tcp'

data/lib/ronin/network/telnet.rb

@@ -0,0 +1,109 @@
+#
+# Ronin - A Ruby platform for exploit development and security research.
+#
+# Copyright (c) 2006-2010 Hal Brodigan (postmodern.mod3 at gmail.com)
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library 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
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin Street, Fifth Floor,
+# Boston, MA  02110-1301  USA
+#
+
+require 'ronin/network/extensions/telnet'
+
+module Ronin
+  module Network
+    module Telnet
+      # Default telnet port
+      DEFAULT_PORT = 23
+
+      # The default prompt regular expression
+      DEFAULT_PROMPT = /[$%#>] \z/n
+
+      # The default timeout
+      DEFAULT_TIMEOUT = 10
+
+      #
+      # @return [Integer]
+      #   The default Ronin Telnet port.
+      #
+      def Telnet.default_port
+        @default_port ||= DEFAULT_PORT
+      end
+
+      #
+      # Sets the default Ronin Telnet port.
+      #
+      # @param [Integer] port
+      #   The new default Ronin Telnet port.
+      #
+      def Telnet.default_port=(port)
+        @default_port = port
+      end
+
+      #
+      # @return [Regexp]
+      #   The default Ronin Telnet prompt pattern.
+      #
+      def Telnet.default_prompt
+        @default_prompt ||= DEFAULT_PROMPT
+      end
+
+      #
+      # Sets the default Ronin Telnet prompt pattern.
+      #
+      # @param [Regexp] prompt
+      #   The new default Ronin Telnet prompt pattern.
+      #
+      def Telnet.default_prompt=(prompt)
+        @default_prompt = prompt
+      end
+
+      #
+      # @return [Integer]
+      #   The default Ronin Telnet timeout.
+      #
+      def Telnet.default_timeout
+        @default_timeout ||= DEFAULT_TIMEOUT
+      end
+
+      #
+      # Sets the default Ronin Telnet timeout.
+      #
+      # @param [Integer] timeout
+      #   The new default Ronin Telnet timeout.
+      #
+      def Telnet.default_timeout=(timeout)
+        @default_timeout = timeout
+      end
+
+      #
+      # @return [Telnet, IO, nil]
+      #   The Ronin Telnet proxy.
+      #
+      def Telnet.proxy
+        @proxy ||= nil
+      end
+
+      #
+      # Sets the Ronin Telnet proxy.
+      #
+      # @param [Telnet, IO, nil] new_proxy
+      #   The new Ronin Telnet proxy.
+      #
+      def Telnet.proxy=(new_proxy)
+        @proxy = new_proxy
+      end
+    end
+  end
+end

data/lib/ronin/network/udp.rb

@@ -0,0 +1,22 @@
+#
+# Ronin - A Ruby platform for exploit development and security research.
+#
+# Copyright (c) 2006-2010 Hal Brodigan (postmodern.mod3 at gmail.com)
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library 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
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin Street, Fifth Floor,
+# Boston, MA  02110-1301  USA
+#
+
+require 'ronin/network/extensions/udp'

data/lib/ronin/path.rb

@@ -0,0 +1,132 @@
+#
+# Ronin - A Ruby platform for exploit development and security research.
+#
+# Copyright (c) 2006-2010 Hal Brodigan (postmodern.mod3 at gmail.com)
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library 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
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin Street, Fifth Floor,
+# Boston, MA  02110-1301  USA
+#
+
+require 'pathname'
+
+module Ronin
+  #
+  # The {Path} class extends `Pathname` to allow representing directory
+  # traversal paths.
+  #
+  class Path < Pathname
+
+    # The separator to join paths together with
+    attr_accessor :separator
+
+    def initialize(path)
+      @separator = File::SEPARATOR
+
+      super(path)
+    end
+
+    #
+    # The root path.
+    #
+    # @return [Path]
+    #   The root path.
+    #
+    def Path.root
+      Path.new('/')
+    end
+
+    #
+    # Creates a new path object for upward directory traversal.
+    #
+    # @param [Integer, Array, Range] n
+    #   The number of directories to go up.
+    #
+    # @param [String] separator
+    #   Path separator.
+    #
+    # @return [Path]
+    #   The new path object.
+    #
+    # @raise [ArgumentError]
+    #   A negative number was given as the first argument.
+    #
+    # @example Generate a relative path that goes up 7 directories.
+    #   Path.up(7)
+    #   # => #<Ronin::Path:../../../../../../..>
+    #
+    # @example Generate multiple relative paths, going up 1 to 3 directories.
+    #   Path.up(1..3)
+    #   # => [#<Ronin::Path:..>, #<Ronin::Path:../..>,
+    #   #<Ronin::Path:../../..>]
+    #
+    def self.up(n,separator=File::SEPARATOR)
+      if n.kind_of?(Integer)
+        if n == 0
+          return separator
+        elsif n < 0
+          raise(ArgumentError,"negative argument")
+        end
+
+        path = self.new('..')
+        path.separator = separator
+
+        dirs = (['..'] * (n-1))
+
+        return Path.new(path.join(*dirs))
+      elsif n.kind_of?(Enumerable)
+        return n.map { |i| self.up(i) }
+      else
+        raise(ArgumentError,"The first argument of Path.up must be either an Integer or Enumerable")
+      end
+    end
+
+    #
+    # Joins directory names together with the path, but does not resolve
+    # the resulting path.
+    #
+    # @param [Array] names
+    #   The names to join together.
+    #
+    # @return [Path]
+    #   The joined path.
+    #
+    # @example
+    #   Path.up(7).join('etc/passwd')
+    #   # => #<Ronin::Path:../../../../../../../etc/passwd>
+    #
+    def join(*names)
+      sub_dirs = names.map { |name| name.to_s }
+
+      # filter out errant directory separators
+      sub_dirs.reject! { |dir| dir == @separator }
+
+      # join the path
+      sub_path = sub_dirs.join(@separator)
+
+      path = if self.root?
+               # prefix the root dir
+               self.to_s + sub_path
+             else
+               # join the path with the sub-path
+               [self.to_s, sub_path].join(@separator)
+             end
+
+      return self.class.new(path)
+    end
+
+    alias / join
+
+  end
+end