net-ping 1.4.1-x86-mingw32 → 1.5.3-x86-mingw32

data/lib/net/ping/icmp.rb

@@ -1,168 +1,180 @@
-require File.join(File.dirname(__FILE__), 'ping')
-
-# The Net module serves as a namespace only.
-module Net
-
-   # The Net::Ping::ICMP class encapsulates an icmp ping.
-   class Ping::ICMP < Ping   
-      ICMP_ECHOREPLY = 0 # Echo reply
-      ICMP_ECHO      = 8 # Echo request
-      ICMP_SUBCODE   = 0
-      
-      # You cannot set or change the port value. A value of 0 is always
-      # used internally for ICMP pings.
-      #
-      undef_method :port=
-
-      # Returns the data size, i.e. number of bytes sent on the ping. The
-      # default size is 56.
-      #
-      attr_reader :data_size
-
-      # Creates and returns a new Ping::ICMP object.  This is similar to its
-      # superclass constructor, but must be created with root privileges (on
-      # UNIX systems), and the port value is ignored.
-      #
-      def initialize(host=nil, port=nil, timeout=5)
-         raise 'requires root privileges' if Process.euid > 0
-
-         @seq = 0
-         @bind_port = 0
-         @bind_host = nil
-         @data_size = 56
-         @data = ''
-
-         0.upto(@data_size){ |n| @data << (n % 256).chr }
-
-         @pid  = Process.pid & 0xffff
-
-         super(host, port, timeout)
-         @port = nil # This value is not used in ICMP pings.
-      end
-
-      # Sets the number of bytes sent in the ping method.
-      #
-      def data_size=(size)
-         @data_size = size
-         @data = ''
-         0.upto(size){ |n| @data << (n % 256).chr }
-      end
-
-      # Associates the local end of the socket connection with the given
-      # +host+ and +port+.  The default port is 0.
-      #
-      def bind(host, port = 0)
-         @bind_host = host
-         @bind_port = port
-      end
-      
-      # Pings the +host+ specified in this method or in the constructor.  If a
-      # host was not specified either here or in the constructor, an
-      # ArgumentError is raised.
-      #
-      def ping(host = @host)
-         super(host)
-         bool = false
-
-         socket = Socket.new(
-            Socket::PF_INET,
-            Socket::SOCK_RAW,
-            Socket::IPPROTO_ICMP
-         )
-
-         if @bind_host
-            saddr = Socket.pack_sockaddr_in(@bind_port, @bind_host)
-            socket.bind(saddr)
-         end
-         
-         @seq = (@seq + 1) % 65536
-         pstring = 'C2 n3 A' << @data_size.to_s
-         timeout = @timeout
-
-         checksum = 0
-         msg = [ICMP_ECHO, ICMP_SUBCODE, checksum, @pid, @seq, @data].pack(pstring)
-         checksum = checksum(msg)
-         msg = [ICMP_ECHO, ICMP_SUBCODE, checksum, @pid, @seq, @data].pack(pstring)
-
-         begin
-            saddr = Socket.pack_sockaddr_in(0, host)
-         rescue Exception
-            socket.close unless socket.closed?
-	         return bool
-         end
-         
-         start_time = Time.now
-
-         socket.send(msg, 0, saddr) # Send the message
-
-         begin
-            Timeout.timeout(@timeout){
-              while true
-                 io_array = select([socket], nil, nil, timeout)
-
-                 if io_array.nil? || io_array[0].empty?
-                    return false
-                 end
-
-                 pid = nil
-                 seq = nil
-
-                 data, sender  = socket.recvfrom(1500)
-                 port, host    = Socket.unpack_sockaddr_in(sender)
-                 type, subcode = data[20, 2].unpack('C2')
-
-                 case type
-                    when ICMP_ECHOREPLY
-                       if data.length >= 28
-                          pid, seq = data[24, 4].unpack('n3')
-                       end
-                    else
-                       if data.length > 56
-                          pid, seq = data[52, 4].unpack('n3')
-                       end
-                 end
-
-                 if pid == @pid && seq == @seq && type == ICMP_ECHOREPLY
-                    bool = true
-                    break
-                 end
-              end
-            }
-         rescue Exception => err
-            @exception = err
-         ensure
-            socket.close if socket
-         end
-         
-         # There is no duration if the ping failed
-         @duration = Time.now - start_time if bool
-
-         return bool
-      end
-
-      alias ping? ping
-      alias pingecho ping
-
-      private
-
-      # Perform a checksum on the message.  This is the sum of all the short
-      # words and it folds the high order bits into the low order bits.
-      #
-      def checksum(msg)
-         length    = msg.length
-         num_short = length / 2
-         check     = 0
-
-         msg.unpack("n#{num_short}").each do |short|
-            check += short
-         end
-
-         if length % 2 > 0
-            check += msg[length-1, 1].unpack('C').first << 8
-         end
-
-         check = (check >> 16) + (check & 0xffff)
-         return (~((check >> 16) + check) & 0xffff)
-      end   
-   end
-end
+require File.join(File.dirname(__FILE__), 'ping')
+
+if File::ALT_SEPARATOR
+  require 'win32/security'
+  require 'windows/system_info'
+  include Windows::SystemInfo
+end
+
+# The Net module serves as a namespace only.
+module Net
+
+  # The Net::Ping::ICMP class encapsulates an icmp ping.
+  class Ping::ICMP < Ping
+    ICMP_ECHOREPLY = 0 # Echo reply
+    ICMP_ECHO      = 8 # Echo request
+    ICMP_SUBCODE   = 0
+
+    # You cannot set or change the port value. A value of 0 is always
+    # used internally for ICMP pings.
+    #
+    undef_method :port=
+
+    # Returns the data size, i.e. number of bytes sent on the ping. The
+    # default size is 56.
+    #
+    attr_reader :data_size
+
+    # Creates and returns a new Ping::ICMP object.  This is similar to its
+    # superclass constructor, but must be created with root privileges (on
+    # UNIX systems), and the port value is ignored.
+    #
+    def initialize(host=nil, port=nil, timeout=5)
+      raise 'requires root privileges' if Process.euid > 0
+
+      if File::ALT_SEPARATOR && windows_version >= 6
+        unless Win32::Security.elevated_security?
+          raise 'requires elevated security'
+        end
+      end
+
+      @seq = 0
+      @bind_port = 0
+      @bind_host = nil
+      @data_size = 56
+      @data = ''
+
+      0.upto(@data_size){ |n| @data << (n % 256).chr }
+
+      @pid  = Process.pid & 0xffff
+
+      super(host, port, timeout)
+      @port = nil # This value is not used in ICMP pings.
+    end
+
+    # Sets the number of bytes sent in the ping method.
+    #
+    def data_size=(size)
+      @data_size = size
+      @data = ''
+      0.upto(size){ |n| @data << (n % 256).chr }
+    end
+
+    # Associates the local end of the socket connection with the given
+    # +host+ and +port+.  The default port is 0.
+    #
+    def bind(host, port = 0)
+      @bind_host = host
+      @bind_port = port
+    end
+
+    # Pings the +host+ specified in this method or in the constructor.  If a
+    # host was not specified either here or in the constructor, an
+    # ArgumentError is raised.
+    #
+    def ping(host = @host)
+      super(host)
+      bool = false
+
+      socket = Socket.new(
+        Socket::PF_INET,
+        Socket::SOCK_RAW,
+        Socket::IPPROTO_ICMP
+      )
+
+      if @bind_host
+        saddr = Socket.pack_sockaddr_in(@bind_port, @bind_host)
+        socket.bind(saddr)
+      end
+
+      @seq = (@seq + 1) % 65536
+      pstring = 'C2 n3 A' << @data_size.to_s
+      timeout = @timeout
+
+      checksum = 0
+      msg = [ICMP_ECHO, ICMP_SUBCODE, checksum, @pid, @seq, @data].pack(pstring)
+
+      checksum = checksum(msg)
+      msg = [ICMP_ECHO, ICMP_SUBCODE, checksum, @pid, @seq, @data].pack(pstring)
+
+      begin
+        saddr = Socket.pack_sockaddr_in(0, host)
+      rescue Exception
+        socket.close unless socket.closed?
+        return bool
+      end
+
+      start_time = Time.now
+
+      socket.send(msg, 0, saddr) # Send the message
+
+      begin
+        Timeout.timeout(@timeout){
+          while true
+            io_array = select([socket], nil, nil, timeout)
+
+            if io_array.nil? || io_array[0].empty?
+              return false
+            end
+
+            pid = nil
+            seq = nil
+
+            data = socket.recvfrom(1500).first
+            type = data[20, 2].unpack('C2').first
+
+            case type
+              when ICMP_ECHOREPLY
+                if data.length >= 28
+                  pid, seq = data[24, 4].unpack('n3')
+                end
+              else
+                if data.length > 56
+                  pid, seq = data[52, 4].unpack('n3')
+                end
+            end
+
+            if pid == @pid && seq == @seq && type == ICMP_ECHOREPLY
+              bool = true
+              break
+            end
+          end
+        }
+      rescue Exception => err
+        @exception = err
+      ensure
+        socket.close if socket
+      end
+
+      # There is no duration if the ping failed
+      @duration = Time.now - start_time if bool
+
+      return bool
+    end
+
+    alias ping? ping
+    alias pingecho ping
+
+    private
+
+    # Perform a checksum on the message.  This is the sum of all the short
+    # words and it folds the high order bits into the low order bits.
+    #
+    def checksum(msg)
+      length    = msg.length
+      num_short = length / 2
+      check     = 0
+
+      msg.unpack("n#{num_short}").each do |short|
+        check += short
+      end
+
+      if length % 2 > 0
+        check += msg[length-1, 1].unpack('C').first << 8
+      end
+
+      check = (check >> 16) + (check & 0xffff)
+      return (~((check >> 16) + check) & 0xffff)
+    end
+  end
+end

data/lib/net/ping/ldap.rb

@@ -0,0 +1,107 @@
+require File.join(File.dirname(__FILE__), 'ping')
+require 'net/ldap'
+require 'uri'
+
+
+# The Net module serves as a namespace only.
+module Net
+
+  # The Ping::LDAP class encapsulates methods for LDAP pings.
+  class Ping::LDAP < Ping
+
+    # uri contains the URI object for the request
+    #
+    attr_accessor :uri
+
+    # username and password may be set for ping using
+    # an authenticated LDAP bind
+    #
+    attr_accessor :username
+    attr_accessor :password
+
+    # set/get the encryption method. By default nil,
+    # but may be set to :simple_tls
+    #
+    attr_accessor :encryption
+    def encryption=(value)
+      @encryption = (value.is_a? Symbol) ? value : value.to_sym
+    end
+
+    # Creates and returns a new Ping::LDAP object.
+    # The default +timeout+ is 5 seconds.
+    #
+    # +uri+ string is expected to be a full URI with scheme (ldap/ldaps)
+    # and optionally the port (else default port is assumed) e.g.
+    #   ldap://my.ldap.host.com
+    #   ldap://my.ldap.host.com:1389
+    #   ldaps://my.ldap.host.com
+    #   ldaps://my.ldap.host.com:6636
+    #
+    # If a plain hostname is provided as the +uri+, a default port of 389 is assumed
+    #
+    def initialize(uri=nil, timeout=5)
+      host, port = decode_uri(uri)
+      super(host, port, timeout)
+    end
+
+    # method used to decode uri string
+    #
+    def decode_uri(value)
+      @uri = URI.parse(value)
+      if uri.scheme =~ /ldap/
+        p = @port = uri.port
+        h = @host = uri.host
+        @encryption = uri.scheme=='ldaps' ? :simple_tls : nil
+      else
+        h = value
+        p = 389
+      end
+      [h, p]
+    end
+
+    # constructs the LDAP configuration structure
+    #
+    def config
+      {
+        :host => uri.host,
+        :port => uri.port,
+        :encryption => encryption
+      }.merge(
+        (username && password) ?
+        { :auth => {:method => :simple, :username => username, :password => password} } :
+        { :auth => {:method => :anonymous} }
+      )
+    end
+
+    # perform ping, optionally providing the ping destination uri
+    #
+    def ping(host = nil)
+      decode_uri(host) if host
+      super(@host)
+      
+      bool = false
+
+      start_time = Time.now
+
+      begin
+        Timeout.timeout(@timeout) do
+          Net::LDAP.new( config  ).bind
+        end
+      rescue Net::LDAP::LdapError => e
+        @exception = e.message
+      rescue Exception => e
+        @exception = e.message
+      else
+        bool = true
+      end
+
+      # There is no duration if the ping failed
+      @duration = Time.now - start_time if bool
+
+      bool
+    end
+
+    alias ping? ping
+    alias pingecho ping
+  end
+end