Class: Net::Ping::External

Inherits:
Net::Ping show all
Defined in:
lib/net/ping/external.rb

Constant Summary

Constants inherited from Net::Ping

VERSION

Instance Attribute Summary

Attributes inherited from Net::Ping

#duration, #exception, #host, #port, #timeout, #warning

Instance Method Summary collapse

Methods inherited from Net::Ping

#initialize

Constructor Details

This class inherits a constructor from Net::Ping

Instance Method Details

#ping(host = @host) ⇒ Object Also known as: ping?, pingecho

Pings the host using your system’s ping utility and checks for any errors or warnings. Returns true if boolful, or false if not.

If false, then the Ping::External#exception method should contain a string indicating what went wrong. If true, the Ping::External#warning method may or may not contain a value.



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
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
 
# File 'lib/net/ping/external.rb', line 24

def ping(host = @host)
   super(host)

   input, output, error = ""
   pstring = "ping "
   bool    = false
   orig_cp = nil
   
   case RUBY_PLATFORM
      when /linux|bsd|osx|mach|darwin/i
         pstring += "-c 1 #{host}"
      when /solaris|sunos/i
         pstring += "#{host} 1"
      when /hpux/i
         pstring += "#{host} -n 1"
      when /win32|windows|mswin/i
         orig_cp = GetConsoleCP()
         SetConsoleCP(437) if orig_cp != 437 # United States
         pstring += "-n 1 #{host}"
      else
         pstring += "#{host}"
   end
   
   start_time = Time.now
   
   begin
     e = nil

     Timeout.timeout(@timeout){
        input, output, error = Open3.popen3(pstring)
        e = error.gets # Can't chomp yet, might be nil
     }

     input.close
     error.close

     if RUBY_PLATFORM.match('mswin') && GetConsoleCP() != orig_cp
        SetConsoleCP(orig_cp)
     end
  
     unless e.nil?
        if e =~ /warning/i
           @warning = e.chomp
           bool = true
        else
           @exception = e.chomp
        end
     # The "no answer" response goes to stdout, not stderr, so check it
     else
        lines = output.readlines
        output.close
        if lines.nil? || lines.empty?
           bool = true
        else
           regexp = /
              no\ answer|
              host\ unreachable|
              could\ not\ find\ host|
              request\ timed\ out|
              100%\ packet\ loss
           /ix
           lines.each{ |line|
              if regexp.match(line)
                 @exception = line.chomp
                 break
              end
           }
           bool = true unless @exception
        end
     end
   rescue Exception => err
     @exception = err.message 
   ensure
     input.close if input && !input.closed?
     error.close if error && !error.closed?
     output.close if output && !output.closed?
   end

   # There is no duration if the ping failed
   @duration = Time.now - start_time if bool

   bool
end