ronin 0.1.2 → 0.1.3

data/lib/ronin/sessions/http.rb

@@ -3,7 +3,7 @@
 # Ronin - A ruby development platform designed for information security
 # and data exploration tasks.
 #
-# Copyright (c) 2006-2008 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2006-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

data/lib/ronin/sessions/imap.rb

@@ -3,7 +3,7 @@
 # Ronin - A ruby development platform designed for information security
 # and data exploration tasks.
 #
-# Copyright (c) 2006-2008 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2006-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
@@ -30,8 +30,8 @@ module Ronin
       include Session
 
       setup_session do
-        parameter :imap_host, :description => 'IMAP host'
-        parameter :imap_port, :description => 'IMAP port'
+        parameter :host, :description => 'IMAP host'
+        parameter :port, :description => 'IMAP port'
 
         parameter :imap_auth, :description => 'IMAP authentication mode'
         parameter :imap_user, :description => 'IMAP user'
@@ -41,16 +41,14 @@ module Ronin
       protected
 
       def imap_connect(options={},&block)
-        unless @imap_host
-          raise(ParamNotFound,"Missing parameter '#{describe_param(:imap_host)}'",caller)
-        end
+        require_params :host
 
-        options[:port] ||= @imap_port
+        options[:port] ||= @port
         options[:auth] ||= @imap_auth
         options[:user] ||= @imap_user
         options[:password] ||= @imap_password
 
-        return ::Net.imap_connect(@imap_host,options,&block)
+        return ::Net.imap_connect(@host,options,&block)
       end
 
       def imap_session(options={},&block)

data/lib/ronin/sessions/pop3.rb

@@ -3,7 +3,7 @@
 # Ronin - A ruby development platform designed for information security
 # and data exploration tasks.
 #
-# Copyright (c) 2006-2008 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2006-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
@@ -30,8 +30,8 @@ module Ronin
       include Session
 
       setup_session do
-        parameter :pop3_host, :description => 'POP3 host'
-        parameter :pop3_port, :description => 'POP3 port'
+        parameter :host, :description => 'POP3 host'
+        parameter :port, :description => 'POP3 port'
 
         parameter :pop3_user, :description => 'POP3 user'
         parameter :pop3_password, :description => 'POP3 password'
@@ -40,15 +40,13 @@ module Ronin
       protected
 
       def pop3_connect(options={},&block)
-        unless @pop3_host
-          raise(ParamNotFound,"Missing parameter #{describe_param(:pop3_host).dump}",caller)
-        end
+        require_params :host
 
-        options[:port] ||= @pop3_port
+        options[:port] ||= @port
         options[:user] ||= @pop3_user
         options[:password] ||= @pop3_password
 
-        return ::Net.pop3_connect(@pop3_host,options,&block)
+        return ::Net.pop3_connect(@host,options,&block)
       end
 
       def pop3_session(options={},&block)

data/lib/ronin/sessions/session.rb

@@ -3,7 +3,7 @@
 # Ronin - A ruby development platform designed for information security
 # and data exploration tasks.
 #
-# Copyright (c) 2006-2008 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2006-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

data/lib/ronin/sessions/smtp.rb

@@ -3,7 +3,7 @@
 # Ronin - A ruby development platform designed for information security
 # and data exploration tasks.
 #
-# Copyright (c) 2006-2008 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2006-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
@@ -30,8 +30,8 @@ module Ronin
       include Session
 
       setup_session do
-        parameter :smtp_host, :description => 'SMTP host'
-        parameter :smtp_port, :description => 'SMTP port'
+        parameter :host, :description => 'SMTP host'
+        parameter :port, :description => 'SMTP port'
 
         parameter :smtp_login, :description => 'SMTP login'
         parameter :smtp_user, :description => 'SMTP user'
@@ -45,16 +45,14 @@ module Ronin
       end
 
       def smtp_connect(options={},&block)
-        unless @smtp_host
-          raise(ParamNotFound,"Missing parameter #{describe_param(:smtp_host).dump}",caller)
-        end
+        require_params :host
 
-        options[:port] ||= @smtp_port
+        options[:port] ||= @port
         options[:login] ||= @smtp_login
         options[:user] ||= @smtp_user
         options[:password] ||= @smtp_password
 
-        return ::Net.smtp_connect(@smtp_host,options,&block)
+        return ::Net.smtp_connect(@host,options,&block)
       end
 
       def smtp_session(options={},&block)

data/lib/ronin/sessions/tcp.rb

@@ -3,7 +3,7 @@
 # Ronin - A ruby development platform designed for information security
 # and data exploration tasks.
 #
-# Copyright (c) 2006-2008 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2006-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
@@ -30,61 +30,73 @@ module Ronin
       include Session
 
       setup_session do
-        parameter :lhost, :description => 'TCP local host'
-        parameter :lport, :description => 'TCP local port'
+        parameter :local_host, :description => 'TCP local host'
+        parameter :local_port, :description => 'TCP local port'
 
-        parameter :rhost, :description => 'TCP remote host'
-        parameter :rport, :description => 'TCP remote port'
+        parameter :host, :description => 'TCP remote host'
+        parameter :port, :description => 'TCP remote port'
       end
 
       protected
 
+      #
+      # Opens a TCP connection to the host and port specified by the
+      # +host+ and +port+ parameters. If the +local_host+ and +local_port+
+      # parameters are set, they will be used for the local host and port
+      # of the TCP connection. A TCPSocket object will be returned. If
+      # a _block_ is given, it will be passed the newly created TCPSocket
+      # object.
+      #
       def tcp_connect(&block)
-        unless @rhost
-          raise(ParamNotFound,"Missing parameter '#{describe_param(:rhost)}'",caller)
-        end
+        require_params :host, :port
 
-        unless @rport
-          raise(ParamNotFound,"Missing parameter '#{describe_param(:rport)}'",caller)
-        end
-
-        return ::Net.tcp_connect(@rhost,@rport,@lhost,@lport,&block)
+        return ::Net.tcp_connect(@host,@port,@local_host,@local_port,&block)
       end
 
+      #
+      # Connects to the host and port specified by the +host+ and +port+
+      # parameters, then sends the specified _data_. If a _block_ is given,
+      # it will be passed the newly created TCPSocket object.
+      #
       def tcp_connect_and_send(data,&block)
-        unless @rhost
-          raise(ParamNotFound,"Missing parameter '#{describe_param(:rhost)}'",caller)
-        end
-
-        unless @rport
-          raise(ParamNotFound,"Missing parameter '#{describe_param(:rport)}'",caller)
-        end
+        require_params :host, :port
 
-        return ::Net.tcp_connect_and_send(data,@rhost,@rport,@lhost,@lport,&block)
+        return ::Net.tcp_connect_and_send(data,@host,@port,@local_host,@local_port,&block)
       end
 
+      #
+      # Creates a TCP session to the host and port specified by the
+      # +host+ and +port+ parameters. If a _block_ is given, it will be
+      # passed the temporary TCPSocket object. After the given _block_
+      # has returned, the TCPSocket object will be closed.
+      #
       def tcp_session(&block)
-        unless @rhost
-          raise(ParamNotFound,"Missing parameter '#{describe_param(:rhost)}'",caller)
-        end
-
-        unless @rport
-          raise(ParamNotFound,"Missing parameter '#{describe_param(:rport)}'",caller)
-        end
+        require_params :host, :port
 
-        return Net.tcp_session(@rhost,@rport,@lhost,@lport,&block)
+        return Net.tcp_session(@host,@port,@local_host,@local_port,&block)
       end
 
+      #
+      # Connects to the host and port specified by the +host+ and +port+
+      # parameters, reads the banner then closes the connection, returning
+      # the banner String. If a _block_ is given, it will be passed the
+      # banner String.
+      #
       def tcp_banner(&block)
-        unless @rhost
-          raise(ParamNotFound,"Missing parameter '#{describe_param(:rhost)}'",caller)
-        end
+        require_params :host, :port
+
+        return ::Net.tcp_banner(@host,@port,@local_host,@local_port,&block)
+      end
 
-        unless @rport
-          raise(ParamNotFound,"Missing parameter '#{describe_param(:rport)}'",caller)
-        end
+      #
+      # Connects to the host and port specified by the +host+ and +port+
+      # parameters, sends the specified _data_ and then closes the
+      # connection. Returns +true+ if the data was successfully sent.
+      #
+      def tcp_send(data)
+        require_params :host, :port
 
-        return ::Net.tcp_banner(@rhost,@rport,@lhost,@lport,&block)
+        return ::Net.tcp_send(data,@host,@port,@local_host,@local_port)
       end
     end
   end

data/lib/ronin/sessions/telnet.rb

@@ -3,7 +3,7 @@
 # Ronin - A ruby development platform designed for information security
 # and data exploration tasks.
 #
-# Copyright (c) 2006-2008 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2006-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
@@ -30,10 +30,9 @@ module Ronin
       include Session
 
       setup_session do
-        parameter :telnet_host, :description => 'Telnet host'
-        parameter :telnet_port,
-                  :value => Network::Telnet.default_port,
-                  :description => 'Telnet port'
+        parameter :host, :description => 'Telnet host'
+        parameter :port, :value => Network::Telnet.default_port,
+                         :description => 'Telnet port'
 
         parameter :telnet_user, :description => 'Telnet user'
         parameter :telnet_password, :description => 'Telnet password'
@@ -45,18 +44,16 @@ module Ronin
       protected
 
       def telnet_connect(options={},&block)
-        unless @telnet_host
-          raise(ParamNotFound,"Missing parameter '#{describe_param(:telnet_host)}'",caller)
-        end
+        require_params :host
 
-        options[:port] ||= @telnet_port
+        options[:port] ||= @port
         options[:user] ||= @telnet_user
         options[:password] ||= @telnet_password
 
         options[:proxy] ||= @telnet_proxy
         options[:ssl] ||= @telnet_ssl
 
-        return ::Net.telnet_connect(@telnet_host,options,&block)
+        return ::Net.telnet_connect(@host,options,&block)
       end
 
       def telnet_session(options={},&block)

data/lib/ronin/sessions/udp.rb

@@ -3,7 +3,7 @@
 # Ronin - A ruby development platform designed for information security
 # and data exploration tasks.
 #
-# Copyright (c) 2006-2008 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2006-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
@@ -30,49 +30,48 @@ module Ronin
       include Session
 
       setup_session do
-        parameter :lhost, :description => 'local host'
-        parameter :lport, :description => 'local port'
+        parameter :local_host, :description => 'local host'
+        parameter :local_port, :description => 'local port'
 
-        parameter :rhost, :description => 'remote host'
-        parameter :rport, :description => 'remote port'
+        parameter :host, :description => 'remote host'
+        parameter :port, :description => 'remote port'
       end
 
       protected
 
+      #
+      # Opens a UDP connection to the host and port specified by the
+      # +host+ and +port+ parameters. If the +local_host+ and +local_port+
+      # parameters are set, they will be used for the local host and port
+      # of the UDP connection. A UDPSocket object will be returned.
+      #
       def udp_connect(&block)
-        unless @rhost
-          raise(ParamNotFound,"Missing '#{describe_param(:rhost)}' parameter",caller)
-        end
+        require_params :host, :port
 
-        unless @rport
-          raise(ParamNotFound,"Missing '#{describe_param(:rport)}' parameter",caller)
-        end
-
-        return ::Net.udp_connect(@rhost,@rport,@lhost,@lport,&block)
+        return ::Net.udp_connect(@host,@port,@local_host,@local_port,&block)
       end
 
+      #
+      # Connects to the host and port specified by the +host+ and +port+
+      # parameters, then sends the specified _data_. If a _block_ is given,
+      # it will be passed the newly created UDPSocket object.
+      #
       def udp_connect_and_send(data,&block)
-        unless @rhost
-          raise(ParamNotFound,"Missing '#{describe_param(:rhost)}' parameter",caller)
-        end
-
-        unless @rport
-          raise(ParamNotFound,"Missing '#{describe_param(:rport)}' parameter",caller)
-        end
+        require_params :host, :port
 
-        return ::Net.udp_connect_and_send(data,@rhost,@rport,@lhost,@lport,&block)
+        return ::Net.udp_connect_and_send(data,@host,@port,@local_host,@local_port,&block)
       end
 
+      #
+      # Creates a UDP session to the host and port specified by the
+      # +host+ and +port+ parameters. If a _block_ is given, it will be
+      # passed the temporary UDPSocket object. After the given _block_
+      # has returned, the UDPSocket object will be closed.
+      #
       def udp_session(&block)
-        unless @rhost
-          raise(ParamNotFound,"Missing parameter '#{describe_param(:rhost)}'",caller)
-        end
-
-        unless @rport
-          raise(ParamNotFound,"Missing parameter '#{describe_param(:rport)}'",caller)
-        end
+        require_params :host, :port
 
-        return ::Net.udp_session(@rhost,@rport,@lhost,@lport,&block)
+        return ::Net.udp_session(@host,@port,@local_host,@local_port,&block)
       end
     end
   end

data/lib/ronin/sessions/web.rb

@@ -3,7 +3,7 @@
 # Ronin - A ruby development platform designed for information security
 # and data exploration tasks.
 #
-# Copyright (c) 2006-2008 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2006-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
@@ -30,13 +30,11 @@ module Ronin
       include Session
 
       setup_session do
-        parameter :web_proxy,
-                  :value => Ronin::Web.proxy,
-                  :description => 'Web Proxy'
+        parameter :web_proxy, :value => Ronin::Web.proxy,
+                              :description => 'Web Proxy'
 
-        parameter :web_user_agent,
-                  :value => Ronin::Web.user_agent,
-                  :description => 'Web User-Agent'
+        parameter :web_user_agent, :value => Ronin::Web.user_agent,
+                                   :description => 'Web User-Agent'
       end
 
       protected

data/lib/ronin/target.rb

@@ -28,6 +28,7 @@ module Ronin
 
     include Model
 
+    # Primary key
     property :id, Serial
 
     # Targeted platform

data/lib/ronin/translators/translator.rb

@@ -3,7 +3,7 @@
 # Ronin - A Ruby platform designed for information security and data
 # exploration tasks.
 #
-# Copyright (c) 2006-2008 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2006-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

data/lib/ronin/ui/command_line.rb

@@ -3,7 +3,7 @@
 # Ronin - A Ruby platform designed for information security and data
 # exploration tasks.
 #
-# Copyright (c) 2006-2008 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2006-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

data/lib/ronin/ui/command_line/command.rb

@@ -3,7 +3,7 @@
 # Ronin - A Ruby platform designed for information security and data
 # exploration tasks.
 #
-# Copyright (c) 2006-2008 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2006-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