net-dns2 0.8.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 55bf79bac06ca433152dd87367a15b48478a79ea
+  data.tar.gz: 573df60f08c57700bb4a92b70b249233c835ebf1
+SHA512:
+  metadata.gz: 214b72d842cd77143078d03fe9c2405e5e87f4f119f0f5858a7b94263e0a6bfbd6fec54ab60eee93744a3ad2b6c1c47b3fb099ca366f6d94e67ee5f3cf4710f1
+  data.tar.gz: 9a9d7c9aa8972344907d4f92abcae0694fa16e2ee8ffee2f8e1d8b8f87445109a256ea22af74f643ecb23793bd09f8e6b2b38be29f8c247509b723b040877bc6

data/.gitignore

@@ -0,0 +1,8 @@
+# Bundler
+.bundle
+pkg/*
+Gemfile.lock
+
+# YARD
+.yardoc
+yardoc/

data/.travis.yml

@@ -0,0 +1,20 @@
+language: ruby
+
+rvm:
+  - 1.8.7
+  - 1.9.2
+  - 1.9.3
+  - 2.0.0
+  # - jruby-18mode
+  # - jruby-19mode
+  - rbx-18mode
+  # - ruby-head
+  # - jruby-head
+
+notifications:
+  recipients:
+    - weppos@weppos.net
+
+matrix:
+  allow_failures:
+    - rvm: 2.0.0

data/CHANGELOG.md

@@ -0,0 +1,105 @@
+# Changelog
+
+## Release 0.8.1
+ - First release from fork by Christopher Carpenter(mordocai@mordocai.net)
+ - FIXED: Multiple bugs with Resolver::source_address= preventing it from
+	  executing.
+ - FIXED: Implemented send_raw_tcp and send_raw_udp
+ - CHANGED: Added interface config parameter for Net::DNS::Resolver,
+            currently only used by send_raw*
+ - CHANGED: Added TODO file for known things that I need to do.
+
+## Release 0.8.0
+
+- FIXED: undefined local variable or method `source_address_inet6' (GH-40). [Thanks @simsicon]
+
+- FIXED: Fixed bug on parsing multiple nameservers on different lines (GH-45). [Thanks @nicholasren]
+
+- CHANGED: Dropped duplicate query ID filter. Query ID is now randomically generated but it's not guaranteed to be unique (GH-39). [Thanks @ebroder]
+
+- CHANGED: require 'net/dns' is now the preferred way to load the library (GH-37). [Thanks @johnroa]
+
+- CHANGED: Removed setup.rb installation script.
+
+
+## Release 0.7.1
+
+- FIXED: Invalid file permissions on several files (GH-35) [Thanks @jamespharaoh]
+
+
+## Release 0.7.0
+
+- ADDED: Added (experimental) Support for HINFO record.
+
+- FIXED: Use Net::DNS::Resolver::Error class (not ResolverError, which does not exist).
+
+- FIXED: Cleaned up require dependency and recursive require statements.
+
+- FIXED: Use RbConfig instead of obsolete and deprecated Config (GH-28, GH-33) [Thanks @shadowbq, @eik3]
+
+- FIXED: SRV record not required by Net::DNS::RR (GH-27) [Thanks @sebastian]
+
+- FIXED: Resolver now supports IPv6 (GH-32) [Thanks @jamesotron]
+
+- FIXED: Net::DNS::RR::PTR references an invalid parameter (GH-19) [Thanks @dd23]
+
+- FIXED: Net::DNS::Question changes input arguments (GH-7) [Thanks @gfarfl]
+
+- CHANGED: Refactoring unit test to follow most used Ruby conventions.
+
+- CHANGED: Rewritten and simplified Net::DNS::Classes. Improved test harness.
+
+- CHANGED: Removed Jeweler development dependency.
+
+- CHANGED: The library is now compatible with Bundler.
+
+- CHANGED: Minimum supported Ruby version changed to Ruby 1.8.7.
+
+- CHANGED: Rescue NameError so unsupported record types only result in a warning.
+
+- CHANGED: Renamed Net::DNS::Resolver#send to Net::DNS::Resolver#query to avoid overriding default meaning of send method.
+
+
+## Release 0.6.1
+
+- ADDED: Net::DNS::Packet#to_s method (alias of #inspect)
+
+- FIXED: typo in lib/net/dns/rr/ptr.rb [Thanks Chris Lundquist]
+
+- FIXED: warning: method redefined; discarding old inspect (GH-3) [Thanks Kevin Baker]
+
+- FIXED: issue with rescue ArgumentError (GH-5) and with IPAddr handling (GH-6)
+
+
+## Release 0.6.0
+
+*WARNING:- If you are upgrading from a previous minor release, check out the Compatibility issue list below.
+
+- FIXED: Added missing #to_s method to Net::DNS::Question.
+
+- FIXED: Compatibility with Ruby 1.9
+
+- FIXED: Types regexp order issue
+
+- CHANGED: Refactoring unit test to follow most used Ruby conventions
+
+- CHANGED: default timeout is now 5 seconds for both UDP and TCP
+
+- CHANGED: Moved main dns.rb file to lib/net folder as default for GEMs. In this way it can be autoloaded when the gem is required.
+
+### Compatibility issues
+
+- CHANGED: RR#set_stype scope is now private to prevent invalid usage.
+
+- CHANGED: DnsTimeout#timeout now raises LocalJumpError instead of DnsTimeoutArgumentError when block is missing.
+
+- CHANGED: Renamed Net::DNS::RR::Types::Types to Net::DNS::RR::Types::TYPES to follow Ruby coding standards.
+
+
+## Release 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/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in whois.gemspec
+gemspec

data/README.md

@@ -0,0 +1,155 @@
+# 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
+
+
+## Requirements
+
+* Ruby >= 1.8.7
+
+
+## Installation
+
+The best way to install this library is via [RubyGems](https://rubygems.org/).
+
+    $ gem install net-dns
+
+You might need administrator privileges on your system to install the gem.
+
+
+## API Documentation
+
+Visit the page http://rdoc.info/gems/net-dns
+
+
+## Trivial resolver
+
+The simplest way to use the library is to invoke the Resolver() method:
+
+    require 'rubygems' 
+    require 'net/dns'
+    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 optional 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
+
+
+## License
+
+See License
+
+## Authors
+
+- Marco Ceresa (@bluemonk)
+- Simone Carletti (@weppos)
+- Christopher Carpenter (@mordocai)

data/Rakefile

@@ -0,0 +1,94 @@
+require 'rubygems'
+require 'bundler'
+
+$:.unshift(File.dirname(__FILE__) + '/lib')
+require 'net/dns'
+
+
+# Common package properties
+PKG_NAME    = ENV['PKG_NAME']    || 'net-dns'
+PKG_VERSION = ENV['PKG_VERSION'] || Net::DNS::VERSION
+
+
+# Run test by default.
+task :default => [:test, :spec]
+
+
+spec = Gem::Specification.new do |s|
+  s.name              = PKG_NAME
+  s.version           = PKG_VERSION
+  s.summary           = "Pure Ruby DNS library."
+  s.description       = "Net::DNS is a pure Ruby DNS library, with a clean OO interface and an extensible API."
+
+  s.required_ruby_version = ">= 1.8.7"
+
+  s.authors           = ["Marco Ceresa", "Simone Carletti"]
+  s.email             = ["ceresa@gmail.com", "weppos@weppos.net"]
+  s.homepage          = "http://github.com/bluemonk/net-dns"
+  s.rubyforge_project = "net-dns"
+
+  s.add_development_dependency "rake"
+  s.add_development_dependency "rspec"
+  s.add_development_dependency "yard"
+
+  s.files             = `git ls-files`.split("\n")
+  s.test_files        = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.require_paths     = %w( lib )
+end
+
+
+require 'rubygems/package_task'
+
+Gem::PackageTask.new(spec) do |pkg|
+  pkg.gem_spec = spec
+end
+
+desc "Build the gemspec file #{spec.name}.gemspec"
+task :gemspec do
+  file = File.dirname(__FILE__) + "/#{spec.name}.gemspec"
+  File.open(file, "w") {|f| f << spec.to_ruby }
+end
+
+
+require 'rake/testtask'
+
+# Run all the tests in the /test folder
+Rake::TestTask.new do |t|
+  t.libs << "test"
+  t.test_files = FileList["test/**/*_test.rb"]
+  t.verbose = true
+end
+
+
+require 'rspec/core/rake_task'
+begin
+  require 'fuubar'
+rescue LoadError
+end
+
+RSpec::Core::RakeTask.new do |t|
+  t.verbose = !!ENV["VERBOSE"]
+  t.rspec_opts  = []
+  t.rspec_opts << ['--format', 'Fuubar'] if defined?(Fuubar)
+end
+
+
+require 'yard'
+
+YARD::Rake::YardocTask.new(:yardoc) do |y|
+  y.options = ["--output-dir", "yardoc"]
+end
+
+namespace :yardoc do
+  task :clobber do
+    rm_r "yardoc" rescue nil
+  end
+end
+
+task :clobber => "yardoc:clobber"
+
+
+desc "Open an irb session preloaded with this library"
+task :console do
+  sh "irb -rubygems -I lib -r net/dns.rb"
+end

data/THANKS.rdoc

@@ -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/demo/check_soa.rb

@@ -0,0 +1,115 @@
+#!/usr/bin/env ruby 
+
+require 'rubygems' if "#{RUBY_VERSION}" < "1.9.0"
+require 'net/dns'
+
+
+#------------------------------------------------------------------------------
+# 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)
+
+ns_req = res.query(domain, Net::DNS::NS)
+unless ns_req and ns_req.header.anCount > 0
+  raise ArgumentError, "No nameservers found for domain: #{res.errorstring}"
+end
+
+
+# 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
+
+
+