Dnsruby is a feature-complete DNS(SEC) client for Ruby, as used by many of the world's largest DNS registries and the OpenDNSSEC project
Clone or download
alexdalitz Merge pull request #149 from kenchan/fix-deprecation-warning
`has_rdoc=` is deprecated with no replacement
Latest commit 0630343 Oct 17, 2018

README.md

Build Status Coverage Status

Dnsruby

Dnsruby is a pure Ruby DNS client library which implements a stub resolver. It aims to comply with all DNS RFCs.

Dnsruby presents an enhanced API for DNS. It is based on Ruby's core resolv.rb Resolv API, but has been much extended to provide a complete DNS implementation.

Dnsruby runs a single I/O thread to handle all concurrent queries. It is therefore suitable for high volume DNS applications.

The following is a (non-exhaustive) list of features :

  • Implemented RRs : A, AAAA, AFSDB, ANY, CAA, CERT, CNAME, DNAME, GPOS, HINFO, ISDN, LOC, MB, MG, MINFO, MR, MX, NAPTR, NS, NSAP, NXT, OPT, PTR, PX, RP, RT, SOA, SPF, SRV, TKEY, TSIG, TXT, WKS, X25, DNSKEY, RRSIG, NSEC, NSEC3, NSEC3PARAM, DS, DLV

  • Generic RR types supported (RFC3597)

  • (Signed) Zone transfer (AXFR and IXFR) supported

  • (Signed) Dynamic updates supported

  • DNSSEC validation supported

Dependencies

Dnsruby can run with no dependencies. However, if you wish to use TSIG or DNSSEC then the OpenSSL library must be available. This is a part of the Ruby standard library, but appears not to be present on all Ruby platforms. If it is not available, then the test code will not run the tests which require it. Code which attempts to use the library (if it is not present) will raise an exception.

Demo Code

The demo folder contains some example programs using Dnsruby. These examples include a basic dig tool (rubydig) and a tool to concurrently resolve many names, amongst others.

Unit Tests

Tests require a current version of minitest (see the .gemspec file for which version is required). In order for the tests to run successfully you may need to have the bundler gem installed and run bundle or bundle install from the project root to install a suitable version of minitest.

There are "online" and "offline" tests. You can use rake to conveniently run the tests. From the project root you can run:

rake test          # run all tests
rake test_offline  # run only offline tests
rake test_online   # run only online tests

If you get the following error when running rake test tasks, then you may need to preface the command with bundle exec to ensure that the gem versions specified in Gemfile.lock are used at runtime:

bundle exec rake test

Usage Help

There are a couple of blog articles that might be helpful in understanding how to use Dnsruby. These used to be hosted by Nominet UK, however the original content has been copied to the dnsruby github wiki at :

https://github.com/alexdalitz/dnsruby/wiki

Contact/Links

Link Type Link/Text
Author Email alex@caerkettontech.com
Github https://github.com/alexdalitz/dnsruby
Google Group https://groups.google.com/forum/#!forum/dnsruby
Rubygems http://rubygems.org/gems/dnsruby/