ronin-support 0.5.1 → 0.5.2

data/lib/ronin/network/udp/proxy.rb

@@ -1,20 +1,20 @@
 #
-# Copyright (c) 2006-2012 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2006-2021 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
-# This file is part of Ronin Support.
+# This file is part of ronin-support.
 #
-# Ronin Support is free software: you can redistribute it and/or modify
+# ronin-support 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 3 of the License, or
 # (at your option) any later version.
 #
-# Ronin Support is distributed in the hope that it will be useful,
+# ronin-support 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 Ronin Support.  If not, see <http://www.gnu.org/licenses/>.
+# along with ronin-support.  If not, see <https://www.gnu.org/licenses/>.
 #
 
 require 'ronin/network/proxy'

data/lib/ronin/network/udp/udp.rb

@@ -1,20 +1,20 @@
 #
-# Copyright (c) 2006-2012 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2006-2021 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
-# This file is part of Ronin Support.
+# This file is part of ronin-support.
 #
-# Ronin Support is free software: you can redistribute it and/or modify
+# ronin-support 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 3 of the License, or
 # (at your option) any later version.
 #
-# Ronin Support is distributed in the hope that it will be useful,
+# ronin-support 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 Ronin Support.  If not, see <http://www.gnu.org/licenses/>.
+# along with ronin-support.  If not, see <https://www.gnu.org/licenses/>.
 #
 
 require 'socket'
@@ -69,11 +69,8 @@ module Ronin
               # send an empty UDP packet, just like nmap
               socket.syswrite('')
 
-              # send junk data, to elicit an error message
-              socket.syswrite("\0" * 64)
-
-              # test if we've received any data
-              socket.sysread(1)
+              # send an empty UDP packet again, to elicit an Errno::ECONNREFUSED
+              socket.syswrite('')
             end
           end
 
@@ -118,18 +115,23 @@ module Ronin
       #     puts socket.readlines
       #   end
       #
-      # @see http://rubydoc.info/stdlib/socket/UDPSocket
+      # @see https://rubydoc.info/stdlib/socket/UDPSocket
       #
       # @api public
       #
       def udp_connect(host,port,local_host=nil,local_port=nil)
-        host       = host.to_s
-        port       = port.to_i
-        local_host = (local_host || '0.0.0.0').to_s
-        local_port = local_port.to_i
+        host = host.to_s
+        port = port.to_i
 
         socket = UDPSocket.new
-        socket.bind(local_host,local_port) if (local_host && local_port)
+
+        if local_host || local_port
+          local_host = local_host.to_s
+          local_port = local_port.to_i
+
+          socket.bind(local_host,local_port)
+        end
+
         socket.connect(host,port)
 
         yield socket if block_given?
@@ -288,10 +290,10 @@ module Ronin
       #
       # Creates a new UDPServer listening on a given host and port.
       #
-      # @param [Integer] port
+      # @param [Integer] port (nil)
       #   The local port to listen on.
       #
-      # @param [String] host ('0.0.0.0')
+      # @param [String] host (nil)
       #   The host to bind to.
       #
       # @return [UDPServer]
@@ -300,13 +302,13 @@ module Ronin
       # @example
       #   udp_server(1337)
       #
-      # @see http://rubydoc.info/stdlib/socket/UDPSocket
+      # @see https://rubydoc.info/stdlib/socket/UDPSocket
       #
       # @api public
       #
       def udp_server(port=nil,host=nil)
         port   = port.to_i
-        host   = (host || '0.0.0.0').to_s
+        host   = host.to_s
 
         server = UDPSocket.new
         server.bind(host,port)
@@ -318,10 +320,10 @@ module Ronin
       #
       # Creates a new temporary UDPServer listening on a given host and port.
       #
-      # @param [Integer] port
+      # @param [Integer] port (nil)
       #   The local port to bind to.
       #
-      # @param [String] host ('0.0.0.0')
+      # @param [String] host (nil)
       #   The host to bind to.
       #
       # @yield [server]
@@ -350,10 +352,10 @@ module Ronin
       # Creates a new UDPServer listening on a given host and port,
       # accepting messages from clients in a loop.
       #
-      # @param [Integer] port
+      # @param [Integer] port (nil)
       #   The port the UDPServer will listen on.
       #
-      # @param [String] host
+      # @param [String] host (nil)
       #   The optional host the UDPServer will bind to.
       #
       # @yield [server, (client_host, client_port), mesg]
@@ -397,10 +399,10 @@ module Ronin
       # Creates a new UDPServer listening on a given host and port,
       # accepts only one message from a client.
       #
-      # @param [Integer] port
+      # @param [Integer] port (nil)
       #   The port the UDPServer will listen on.
       #
-      # @param [String] host
+      # @param [String] host (nil)
       #   The optional host the UDPServer will bind to.
       #
       # @yield [server, (client_host, client_port), mesg]

data/lib/ronin/network/unix.rb

@@ -1,20 +1,20 @@
 #
-# Copyright (c) 2006-2012 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2006-2021 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
-# This file is part of Ronin Support.
+# This file is part of ronin-support.
 #
-# Ronin Support is free software: you can redistribute it and/or modify
+# ronin-support 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 3 of the License, or
 # (at your option) any later version.
 #
-# Ronin Support is distributed in the hope that it will be useful,
+# ronin-support 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 Ronin Support.  If not, see <http://www.gnu.org/licenses/>.
+# along with ronin-support.  If not, see <https://www.gnu.org/licenses/>.
 #
 
 require 'socket'
@@ -76,7 +76,7 @@ module Ronin
       # @example
       #   unix_connect('/tmp/haproxy.stats.socket')
       #
-      # @see http://rubydoc.info/stdlib/socket/UNIXSocket
+      # @see https://rubydoc.info/stdlib/socket/UNIXSocket
       #
       # @api public
       #
@@ -188,7 +188,7 @@ module Ronin
       # @example
       #   unix_server('/tmp/test.socket')
       #
-      # @see http://rubydoc.info/stdlib/socket/UNIXServer
+      # @see https://rubydoc.info/stdlib/socket/UNIXServer
       #
       # @api public
       #

data/lib/ronin/path.rb

@@ -1,20 +1,20 @@
 #
-# Copyright (c) 2006-2012 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2006-2021 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
-# This file is part of Ronin Support.
+# This file is part of ronin-support.
 #
-# Ronin Support is free software: you can redistribute it and/or modify
+# ronin-support 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 3 of the License, or
 # (at your option) any later version.
 #
-# Ronin Support is distributed in the hope that it will be useful,
+# ronin-support 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 Ronin Support.  If not, see <http://www.gnu.org/licenses/>.
+# along with ronin-support.  If not, see <https://www.gnu.org/licenses/>.
 #
 
 require 'pathname'
@@ -24,13 +24,24 @@ module Ronin
   # The {Path} class extends `Pathname` to allow representing directory
   # traversal paths.
   #
+  # @api public
+  #
   class Path < Pathname
 
     # The separator to join paths together with
     attr_accessor :separator
 
-    def initialize(path)
-      @separator = File::SEPARATOR
+    #
+    # Initializes a new Path.
+    #
+    # @param [String] path
+    #   The path.
+    #
+    # @param [String] separator
+    #   The directory separator to use.
+    #
+    def initialize(path,separator=File::SEPARATOR)
+      @separator = separator
 
       super(path)
     end
@@ -41,8 +52,6 @@ module Ronin
     # @return [Path]
     #   The root path.
     #
-    # @api public
-    #
     def Path.root
       Path.new('/')
     end
@@ -71,23 +80,17 @@ module Ronin
     #   # => [#<Ronin::Path:..>, #<Ronin::Path:../..>,
     #   #<Ronin::Path:../../..>]
     #
-    # @api public
-    #
     def self.up(n,separator=File::SEPARATOR)
       case n
       when Integer
         if n == 0
-          return separator
-        elsif n < 0
+          separator
+        elsif n > 0
+          path = new('..',separator)
+          path.join(*(['..'] * (n-1)))
+        else
           raise(ArgumentError,"negative argument")
         end
-
-        path = new('..')
-        path.separator = separator
-
-        dirs = (['..'] * (n-1))
-
-        Path.new(path.join(*dirs))
       when Enumerable
         n.map { |i| up(i) }
       else
@@ -109,26 +112,19 @@ module Ronin
     #   Path.up(7).join('etc/passwd')
     #   # => #<Ronin::Path:../../../../../../../etc/passwd>
     #
-    # @api public
-    #
     def join(*names)
-      names.map! { |name| name.to_s }
-
-      # filter out errant directory separators
-      names.reject! { |dir| dir == @separator }
+      joined_path = if root? then ''
+                    else          self.to_s
+                    end
 
-      # join the path
-      sub_path = names.join(@separator)
+      names.each do |name|
+        name = name.to_s
 
-      path = if 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
+        joined_path << @separator unless name.start_with?(@separator)
+        joined_path << name       unless name == @separator
+      end
 
-      return self.class.new(path)
+      return self.class.new(joined_path,@separator)
     end
 
     alias / join

data/lib/ronin/spec/ui/output.rb

@@ -1,20 +1,20 @@
 #
-# Copyright (c) 2006-2012 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2006-2021 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
-# This file is part of Ronin Support.
+# This file is part of ronin-support.
 #
-# Ronin Support is free software: you can redistribute it and/or modify
+# ronin-support 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 3 of the License, or
 # (at your option) any later version.
 #
-# Ronin Support is distributed in the hope that it will be useful,
+# ronin-support 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 Ronin Support.  If not, see <http://www.gnu.org/licenses/>.
+# along with ronin-support.  If not, see <https://www.gnu.org/licenses/>.
 #
 
 require 'ronin/ui/output'

data/lib/ronin/support.rb

@@ -1,20 +1,20 @@
 #
-# Copyright (c) 2006-2012 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2006-2021 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
-# This file is part of Ronin Support.
+# This file is part of ronin-support.
 #
-# Ronin Support is free software: you can redistribute it and/or modify
+# ronin-support 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 3 of the License, or
 # (at your option) any later version.
 #
-# Ronin Support is distributed in the hope that it will be useful,
+# ronin-support 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 Ronin Support.  If not, see <http://www.gnu.org/licenses/>.
+# along with ronin-support.  If not, see <https://www.gnu.org/licenses/>.
 #
 
 require 'ronin/extensions'

data/lib/ronin/support/inflector.rb

@@ -1,20 +1,20 @@
 #
-# Copyright (c) 2006-2012 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2006-2021 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
-# This file is part of Ronin Support.
+# This file is part of ronin-support.
 #
-# Ronin Support is free software: you can redistribute it and/or modify
+# ronin-support 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 3 of the License, or
 # (at your option) any later version.
 #
-# Ronin Support is distributed in the hope that it will be useful,
+# ronin-support 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 Ronin Support.  If not, see <http://www.gnu.org/licenses/>.
+# along with ronin-support.  If not, see <https://www.gnu.org/licenses/>.
 #
 
 module Ronin

data/lib/ronin/support/support.rb

@@ -1,20 +1,20 @@
 #
-# Copyright (c) 2006-2012 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2006-2021 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
-# This file is part of Ronin Support.
+# This file is part of ronin-support.
 #
-# Ronin Support is free software: you can redistribute it and/or modify
+# ronin-support 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 3 of the License, or
 # (at your option) any later version.
 #
-# Ronin Support is distributed in the hope that it will be useful,
+# ronin-support 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 Ronin Support.  If not, see <http://www.gnu.org/licenses/>.
+# along with ronin-support.  If not, see <https://www.gnu.org/licenses/>.
 #
 
 require 'ronin/ui/output'

data/lib/ronin/support/version.rb

@@ -1,25 +1,25 @@
 #
-# Copyright (c) 2006-2012 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2006-2021 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
-# This file is part of Ronin Support.
+# This file is part of ronin-support.
 #
-# Ronin Support is free software: you can redistribute it and/or modify
+# ronin-support 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 3 of the License, or
 # (at your option) any later version.
 #
-# Ronin Support is distributed in the hope that it will be useful,
+# ronin-support 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 Ronin Support.  If not, see <http://www.gnu.org/licenses/>.
+# along with ronin-support.  If not, see <https://www.gnu.org/licenses/>.
 #
 
 module Ronin
   module Support
     # ronin-support version
-    VERSION = '0.5.1'
+    VERSION = '0.5.2'
   end
 end