summaryrefslogtreecommitdiff
path: root/lib/ping.rb
blob: d742a50f99831d4563c2168d97d421eb4e4fb034 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
#
# ping.rb -- check a host for upness
#
#= SYNOPSIS
#
#   require 'ping'
#    print "'jimmy' is alive and kicking\n" if Ping.pingecho('jimmy', 10) ;
#
#= DESCRIPTION
#
# This module contains routines to test for the reachability of remote hosts.
# Currently the only routine implemented is pingecho(). 
#
# pingecho() uses a TCP echo (I<not> an ICMP one) to determine if the
# remote host is reachable. This is usually adequate to tell that a remote
# host is available to rsh(1), ftp(1), or telnet(1) onto.
#
#== Parameters
#
#  : hostname
#
#    The remote host to check, specified either as a hostname or as an
#    IP address.
#
#  : timeout
#
#    The timeout in seconds. If not specified it will default to 5 seconds.
#
#= WARNING
#
# pingecho() uses user-level thread to implement the timeout, so it may block
# for long period if named does not respond for some reason.
#
#=end

module Ping
  require "socket"
  def pingecho(host, timeout=5)
    begin
      x = Thread.current
      y = Thread.start {
	sleep timeout
	x.raise RuntimeError if x.status
      }
      s = TCPsocket.new(host, "echo")
      s.close
      return TRUE
    rescue
      return FALSE;
    ensure
      Thread.kill y if y.status
    end
  end
  module_function "pingecho"
end