bluemonk-net-dns 0.5.0

data/AUTHORS

@@ -0,0 +1,10 @@
+#	$Id: AUTHORS,v 1.2 2005/06/17 10:09:57 bluemonk Exp $	
+
+
+AUTHORS
+
+Net::DNS core development:
+	Marco Ceresa <ceresa@ieee.org>
+
+Beta testing:
+	

data/CHANGELOG

@@ -0,0 +1,7 @@
+net-dns 0.4
+ - many bug fixes (thanks guys!)
+ - a whole new class Net::DNS::Header::RCode
+ - new methods in Net::DNS::Resolver class to 
+   do AXFR queries
+ - a new SRV resource record written by Dan Janowski
+ - more documentation written and corrected 

data/INSTALL

@@ -0,0 +1,8 @@
+If you didn't install this from gem, you can do a 
+
+# ruby setup.rb
+
+or, from normal user (with sudo)
+
+$ rake install
+

data/README.rdoc

@@ -0,0 +1,150 @@
+= Net::DNS
+
+Net::DNS is a DNS library written in pure Ruby. It started as a port of Perl Net::DNS module, but it evolved in time into a full Ruby library.  
+
+Features:
+
+- Complete OO interface
+- Clean and intuitive API
+- Modular and flexible
+
+== Install
+
+Just use Rubygems:
+     
+     $ sudo gem install net-dns
+
+If you want to install from source, you can use Rake:
+   
+   $ rake install
+
+Or directly from install.rb
+
+   $ sudo ruby install.rb
+
+== API Documentation
+
+Visit the page http://marcoceresa.com/net-dns
+
+== Trivial resolver
+
+The simplest way to use the library is to invoke the Resolver() method:
+
+    require 'net/dns/resolver'
+    p Resolver("www.google.com")
+
+The output is compatible with BIND zone files and it's the same you would get with the dig utility.
+
+    ;; Answer received from localhost:53 (212 bytes)
+    ;;
+    ;; HEADER SECTION
+    ;; id = 64075
+    ;; qr = 1       opCode: QUERY   aa = 0  tc = 0  rd = 1
+    ;; ra = 1       ad = 0  cd = 0  rcode = NoError
+    ;; qdCount = 1  anCount = 3     nsCount = 4     arCount = 4
+    
+    ;; QUESTION SECTION (1 record):
+    ;; google.com.                  IN      A
+    
+    ;; ANSWER SECTION (3 records):
+    google.com.             212     IN      A       74.125.45.100
+    google.com.             212     IN      A       74.125.67.100
+    google.com.             212     IN      A       209.85.171.100
+    
+    ;; AUTHORITY SECTION (4 records):
+    google.com.             345512  IN      NS      ns1.google.com.
+    google.com.             345512  IN      NS      ns4.google.com.
+    google.com.             345512  IN      NS      ns2.google.com.
+    google.com.             345512  IN      NS      ns3.google.com.
+    
+    ;; ADDITIONAL SECTION (4 records):
+    ns1.google.com.         170275  IN      A       216.239.32.10
+    ns2.google.com.         170275  IN      A       216.239.34.10
+    ns3.google.com.         170275  IN      A       216.239.36.10
+    ns4.google.com.         170275  IN      A       216.239.38.10
+
+
+An optional block can be passed yielding the Net::DNS::Packet object
+
+   Resolver("www.google.com") {|packet| puts packet.size + " bytes"}
+     #=> 484 bytes
+
+Same for Net::DNS::Resolver.start():
+
+    Net::DNS::Resolver.start("google.com").answer.size
+      #=> 5
+
+As optionals parameters, +TYPE+ and +CLASS+ can be specified.
+
+   p Net::DNS::Resolver.start("google.com", Net::DNS::MX)
+
+   ;; Answer received from localhost:53 (316 bytes)
+   ;;
+   ;; HEADER SECTION
+   ;; id = 59980
+   ;; qr = 1       opCode: QUERY   aa = 0  tc = 0  rd = 1
+   ;; ra = 1       ad = 0  cd = 0  rcode = NoError
+   ;; qdCount = 1  anCount = 4     nsCount = 4     arCount = 8
+   
+   ;; QUESTION SECTION (1 record):
+   ;; google.com.                  IN      MX
+   
+   ;; ANSWER SECTION (4 records):
+   google.com.             10800   IN      MX      10 smtp2.google.com.
+   google.com.             10800   IN      MX      10 smtp3.google.com.
+   google.com.             10800   IN      MX      10 smtp4.google.com.
+   google.com.             10800   IN      MX      10 smtp1.google.com.
+
+== Handling the response packet
+
+The method Net::DNS::Resolver.start is a wrapper around Resolver.new. It returns a new Net::DNS::Packet object.
+
+A DNS packet is divided into 5 sections:
+
+- header section # => a Net::DNS::Header object
+- question section # => a Net::DNS::Question object
+- answer section # => an Array of Net::DNS::RR objects
+- authority section # => an Array of Net::DNS::RR objects
+- additional section # => an Array of Net::DNS::RR objects
+
+You can access each section by calling the attribute with the same name on a Packet object:
+
+    packet = Net::DNS::Resolver.start("google.com")
+    
+    header = packet.header
+    answer = packet.answer
+    
+    puts "The packet is #{packet.data.size} bytes"
+    puts "It contains #{header.anCount} answer entries"
+    
+    answer.any? {|ans| p ans}
+    
+The output is 
+
+    The packet is 378 bytes
+    It contains 3 answer entries
+    google.com.             244     IN      A       74.125.45.100
+    google.com.             244     IN      A       74.125.67.100
+    google.com.             244     IN      A       209.85.171.100
+
+A better way to handle the answer section is to use the iterators directly on a Packet object:
+
+    packet.each_address do |ip|
+      puts "#{ip} is alive" if Ping.pingecho(ip.to_s, 10, 80)
+    end
+
+Gives:
+
+    74.125.45.100 is alive
+    74.125.67.100 is alive
+    209.85.171.100 is alive
+	
+
+== Licence
+
+Net::DNS is distributed under the same license Ruby is.
+
+== Author
+
+(c) Marco Ceresa 2006   
+      

data/Rakefile

@@ -0,0 +1,93 @@
+require 'rubygems'
+require 'rake'
+
+#
+# Gem specifications
+#
+SPEC = Gem::Specification.new do |s|
+  s.name      = "net-dns"
+  s.authors   = ["Marco Ceresa"]
+  s.email     = "ceresa@gmail.com"
+  s.homepage  = "http://github.com/bluemonk/net-dns"
+  s.platform  = Gem::Platform::RUBY
+  s.summary   = "Pure Ruby DNS library"
+  s.has_rdoc         = true
+  s.extra_rdoc_files = ["README.rdoc","AUTHORS","INSTALL", "THANKS"]
+  s.description = "Net::DNS is a pure Ruby DNS library, with a clean OO interface and an extensible API"
+end
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new(SPEC)
+rescue LoadError
+  puts "Jeweler not available."
+end
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/*_test.rb'
+  test.verbose = true
+end
+
+begin
+  require 'rcov/rcovtask'
+  Rcov::RcovTask.new do |test|
+    test.libs << 'test'
+    test.pattern = 'test/**/*_test.rb'
+    test.verbose = true
+  end
+rescue LoadError
+  task :rcov do
+    abort "RCov is not available. In order to run rcov, you must: sudo gem install spicycode-rcov"
+  end
+end
+
+task :default => :test
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  if File.exist?('VERSION.yml')
+    config = YAML.load(File.read('VERSION.yml'))
+    version = "#{config[:major]}.#{config[:minor]}.#{config[:patch]}"
+  else
+    puts "Not found!"
+    version = ""
+  end
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "net-dns #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+desc "Upload project on RubyForge"
+task :upload do
+  rubyforge = Rake::RubyForgePublisher.new("net-dns","bluemonk")
+  rubyforge.upload
+end
+
+
+def egrep(pattern)
+  Dir['**/*.rb'].each do |fn|
+    count = 0
+    open(fn) do |f|
+      while line = f.gets
+        count += 1
+        if line =~ pattern
+          puts "#{fn}:#{count}:#{line}"
+        end
+      end
+    end
+  end
+end
+
+desc "Look for TODO and FIXME tags in the code"
+task :todo do
+  egrep /(FIXME|TODO|TBD)/
+end
+
+
+
+
+

data/THANKS

@@ -0,0 +1,24 @@
+Many thanks to these wonderful people:
+
+- Paul Barry for his excellent article on May07 issue of LinuxJournal, for the kind words and for bug reports
+- Dan Janowski (and his SRV RR)
+- Joshua Abraham
+- Ben April
+- Gene Rogers
+- Nicholas Veeser
+- Gildas Cherruel
+- Alex Dalitz
+- Cory Wright
+- Nicolas Pugnant
+- Andrea Peltrin
+- Giovanni Corriga
+- Luca Russo
+- Pierguido Lambri
+- Andrea Pampuri
+- _koo_
+- Oyku Gencay
+- Eric Liedtke
+- Justin Mercier
+- Daniel Berger
+and all #ruby-lang people
+

data/VERSION.yml

@@ -0,0 +1,4 @@
+---
+:minor: 5
+:patch: 0
+:major: 0

data/demo/check_soa.rb

@@ -0,0 +1,120 @@
+#!/usr/bin/env ruby 
+
+# 	$Id: check_soa.rb,v 1.7 2006/07/30 16:53:57 bluemonk Exp $	
+
+
+require 'rubygems' if "#{RUBY_VERSION}" < "1.9.0"
+require 'net/dns/resolver'
+
+#------------------------------------------------------------------------------
+# Get the domain from the command line.
+#------------------------------------------------------------------------------
+
+raise ArgumentError, "Usage: check_soa.rb domain\n" unless ARGV.size == 1
+
+domain = ARGV[0]
+
+#------------------------------------------------------------------------------
+# Find all the nameservers for the domain.
+#------------------------------------------------------------------------------
+
+res = Net::DNS::Resolver.new(:defname => false, :retry => 2)
+
+#res.defname=false
+#res.retry=2
+
+
+ns_req = res.query(domain, Net::DNS::NS);
+raise ArgumentError, "No nameservers found for domain: " + res.errorstring + 
+  "\n"	unless ns_req and ns_req.header.anCount > 0
+
+
+# Send out non-recursive queries
+res.recurse=false
+# Do not buffer standard out
+#| = 1;
+
+
+#------------------------------------------------------------------------------
+# Check the SOA record on each nameserver.
+#------------------------------------------------------------------------------
+
+ns_req.each_nameserver do |ns|
+  
+  #----------------------------------------------------------------------
+  # Set the resolver to query this nameserver.
+  #----------------------------------------------------------------------
+  
+  # In order to lookup the IP(s) of the nameserver, we need a Resolver
+  # object that is set to our local, recursive nameserver.  So we create
+  # a new object just to do that.
+  
+  local_res = Net::DNS::Resolver.new
+  
+  a_req = local_res.query(ns, Net::DNS::A)
+  
+  
+  unless a_req 
+    puts "Can not find address for ns: " + res.errorstring + "\n"
+    next
+  end
+  
+  
+  a_req.each_address do |ip|
+
+    #----------------------------------------------------------------------
+    # Ask this IP.
+    #----------------------------------------------------------------------
+    res.nameservers=ip	
+    
+    print "#{ns} (#{ip}): "
+    
+    #----------------------------------------------------------------------
+    # Get the SOA record.
+    #----------------------------------------------------------------------
+    
+    soa_req = res.send(domain, Net::DNS::SOA, Net::DNS::IN)
+    
+    if soa_req == nil
+      puts res.errorstring, "\n"
+      next
+    end
+    
+    #----------------------------------------------------------------------
+    # Is this nameserver authoritative for the domain?
+    #----------------------------------------------------------------------
+    
+    unless soa_req.header.auth? 
+      print "isn't authoritative for domain\n"
+      next
+    end
+    
+    #----------------------------------------------------------------------
+    # We should have received exactly one answer.
+    #----------------------------------------------------------------------
+    
+    unless soa_req.header.anCount == 1 
+      print "expected 1 answer, got " + soa_req.header.anCount.to_s + "\n"
+      next
+    end
+    
+    #----------------------------------------------------------------------
+    # Did we receive an SOA record?
+    #----------------------------------------------------------------------
+    
+    unless soa_req.answer[0].class == Net::DNS::RR::SOA
+      print "expected SOA, got " + Net::DNS::RR::RRTypes.to_str(soa_req.answer[0].type) + "\n"
+      next
+    end
+    
+    #----------------------------------------------------------------------
+    # Print the serial number.
+    #----------------------------------------------------------------------
+    
+    print "has serial number " + soa_req.answer[0].serial.to_s + "\n"
+    
+  end
+end
+
+
+

data/demo/threads.rb

@@ -0,0 +1,22 @@
+require 'rubygems' if "#{RUBY_VERSION}" < "1.9.0"
+require 'net/dns/resolver'
+
+a = ["ibm.com", "sun.com", "redhat.com"]
+
+threads = []
+
+for dom in a
+  threads << Thread.new(dom) do |domain|
+    res = Net::DNS::Resolver.new
+    res.query(domain, Net::DNS::NS).each_nameserver do |ns|
+      puts "Domain #{domain} has nameserver #{ns}"
+    end
+    puts ""
+  end
+end
+
+threads.each do |t|
+  t.join
+end
+
+

data/lib/net/dns/dns.rb

@@ -0,0 +1,117 @@
+##
+#
+# dns.rb
+#
+# $id$
+#
+##
+
+module Net # :nodoc:
+  module DNS
+    
+    # Version of the library
+    VERSION = "0.4"
+  
+    # Packet size in bytes
+    PACKETSZ = 512
+    
+    # Size of the header 
+    HFIXEDSZ = 12
+    
+    # Size of the question portion (type and class)
+    QFIXEDSZ = 4
+    
+    # Size of an RR portion (type,class,lenght and ttl)
+    RRFIXEDSZ = 10
+    
+    # Size of an int 32 bit
+    INT32SZ = 4
+    
+    # Size of a short int
+    INT16SZ = 2
+
+    module QueryTypes
+    
+      SIGZERO   = 0
+      A         = 1
+      NS        = 2
+      MD        = 3
+      MF        = 4
+      CNAME     = 5
+      SOA       = 6
+      MB        = 7
+      MG        = 8
+      MR        = 9
+      NULL      = 10
+      WKS       = 11
+      PTR       = 12
+      HINFO     = 13
+      MINFO     = 14
+      MX        = 15
+      TXT       = 16
+      RP        = 17
+      AFSDB     = 18
+      X25       = 19
+      ISDN      = 20
+      RT        = 21
+      NSAP      = 22
+      NSAPPTR   = 23
+      SIG       = 24
+      KEY       = 25
+      PX        = 26
+      GPOS      = 27
+      AAAA      = 28
+      LOC       = 29
+      NXT       = 30
+      EID       = 31
+      NIMLOC    = 32
+      SRV       = 33
+      ATMA      = 34
+      NAPTR     = 35
+      KX        = 36
+      CERT      = 37
+      DNAME     = 39
+      OPT       = 41
+      DS        = 43
+      SSHFP     = 44
+      RRSIG     = 46
+      NSEC      = 47
+      DNSKEY    = 48
+      UINFO     = 100
+      UID       = 101
+      GID       = 102
+      UNSPEC    = 103
+      TKEY      = 249
+      TSIG      = 250
+      IXFR      = 251
+      AXFR      = 252
+      MAILB     = 253
+      MAILA     = 254
+      ANY       = 255
+
+    end
+    
+    module QueryClasses
+    
+      # Internet class
+      IN        = 1
+      
+      # Chaos class
+      CH        = 3
+    
+      # Hesiod class
+      HS        = 4
+      
+      # None class
+      NONE      = 254
+      
+      # Any class
+      ANY       = 255
+      
+    end
+    
+    include QueryTypes
+    include QueryClasses
+
+  end # module DNS
+end # module Net