Module Ping
In: ping.rb

Ping contains routines to test for the reachability of remote hosts. Currently the only routine implemented is pingecho().

Ping.pingecho uses a TCP echo (not an ICMP echo) to determine if the remote host is reachable. This is usually adequate to tell that a remote host is available to telnet, ftp, or ssh to.

Warning: Ping.pingecho may block for a long time if DNS resolution is slow. Requiring ‘resolv-replace’ allows non-blocking name resolution.

Usage: 

  require 'ping'

  puts "'jimmy' is alive and kicking" if Ping.pingecho('jimmy', 10)

Methods

pingecho  

Public Instance methods

pingecho(host, timeout=5, service="echo")

Return true if we can open a connection to the hostname or IP address host on port service (which defaults to the "echo" port) waiting up to timeout seconds.

Example: 

  require 'ping'

  Ping.pingecho "google.com", 10, 80

[Source]

# File ping.rb, line 44
  def pingecho(host, timeout=5, service="echo")
    begin
      timeout(timeout) do
        s = TCPSocket.new(host, service)
        s.close
      end
    rescue Errno::ECONNREFUSED
      return true
    rescue Timeout::Error, StandardError
      return false
    end
    return true
  end

[Validate]

ruby-doc.org is a community service provided by Happy Camper Studios, a Phoenix, Arizona, Ruby application development company.

Documentation content on ruby-doc.org is provided by remarkable members of the Ruby community.

For more information on the Ruby programming language, visit ruby-lang.org.

Want to help improve Ruby's API docs? See Ruby Documentation Guidelines.