require 'resolv' # # The DNS-protocol test. # # This object is instantiated if the parser sees a line such as: # ### ### DNSHOSTS must run dns for bytemark.co.uk resolving NS as '80.68.80.26,85.17.170.78,80.68.80.27'. ### # # The test will fail if the results are not *exactly* as specified. i.e. If there are too # many results, or too few, we'll alert. # # module Custodian module ProtocolTest class DNSTest < TestFactory # # The line from which we were constructed. # attr_reader :line # # Name to resolve, type to resolve, and expected results # attr_reader :resolve_name, :resolve_type, :resolve_expected # # Constructor # def initialize( line ) # # Save the line # @line = line # # Is this test inverted? # if ( line =~ /must\s+not\s+run\s+/ ) @inverted = true else @inverted = false end if ( line =~ /for\s+([^\s]+)\sresolving\s([A-Z]+)\s+as\s'([^']+)'/ ) @resolve_name = $1.dup @resolve_type = $2.dup @resolve_expected = $3.dup end # # Ensure we had all the data. # raise ArgumentError, "Missing host to resolve" unless( @resolve_name ) raise ArgumentError, "Missing type of record to lookup" unless( @resolve_type ) raise ArgumentError, "Missing expected results" unless( @resolve_expected ) raise ArgumentError, "Uknown record type: #{@resolve_type}" unless( @resolve_type =~ /^(A|NS|MX|AAAA)$/ ) # # The host to query against # @host = line.split( /\s+/)[0] end # # Allow this test to be serialized. # def to_s @line end # # Run the test. # def run_test # Reset the result in case we've already run @error = nil # # Do the lookup # results = resolve_via( @host, @resolve_type, @resolve_name, 30 ) return false if ( results.nil? ) # # OK we have an array of results. If every one of the expected # results is contained in those results returned then we're good. # expected = 0 if ( results != @resolve_expected ) @error = "When resolving the name #{@resolve_name} [#{resolve_type}-record lookup] against DNS-server #{@host} we received an error. The expected result '#{@resolve_expected}' didn't match the returned results '#{results}'" return false end true end # # Resolve an IP # def resolve_via( server, ltype, name, period ) results = Array.new() begin timeout( period ) do begin Resolv::DNS.open(:nameserver=>[server]) do |dns| case ltype when /^A$/ then dns.getresources(name, Resolv::DNS::Resource::IN::A).map{ |r| results.push(r.address.to_s()) } when /^AAAA$/ then dns.getresources(name, Resolv::DNS::Resource::IN::AAAA).map{ |r| results.push( r.address.to_s()) } when /^NS$/ then dns.getresources(name, Resolv::DNS::Resource::IN::NS).map{ |r| results.push( Resolv.getaddresses(r.name.to_s())) } when /^MX$/ then dns.getresources(name, Resolv::DNS::Resource::IN::MX).map{ |r| results.push( Resolv.getaddresses(r.exchange.to_s())) } else @error = "Unknown record type to resolve: '#{ltype}'" return nil end end rescue Exception => x @error = "Exception was received when resolving : #{x}" return nil end end rescue Timeout::Error => e @error = "Timed-out performing DNS lookups #{e}" return nil end # # Flatten via a hash. # h = Hash.new() results.sort.each do |key| if ( key.kind_of? Array ) key.each do |n| h[n]=1 end else h[key]=1 end end h.keys.sort!.join( "," ) end # # If the test fails then report the error. # def error @error end register_test_type "dns" end end end