Class Rev::DNSResolver
In: lib/rev/dns_resolver.rb
Parent: IOWatcher

A non-blocking DNS resolver. It provides interfaces for querying both /etc/hosts and nameserves listed in /etc/resolv.conf, or nameservers of your choosing.

Presently the client only supports UDP requests against your nameservers and cannot resolve anything with records larger than 512-bytes. Also, IPv6 is not presently supported.

DNSResolver objects are one-shot. Once they resolve a domain name they automatically detach themselves from the event loop and cannot be used again.

Methods

attach   detach   hosts   new   on_failure   on_readable   on_success   on_timeout   request_message   request_question   response_address   send_request  

Classes and Modules

Class Rev::DNSResolver::Timeout

Constants

RESOLV_CONF = '/etc/resolv.conf'
HOSTS = '/etc/hosts'
DNS_PORT = 53
DATAGRAM_SIZE = 512
TIMEOUT = 3
RETRIES = 4

Public Class methods

hosts(host, hostfile = HOSTS)

Query /etc/hosts (or the specified hostfile) for the given host

new(hostname, *nameservers)

Create a new Rev::Watcher descended object to resolve the given hostname. If you so desire you can also specify a list of nameservers to query. By default the resolver will use nameservers listed in /etc/resolv.conf

Public Instance methods

attach(evloop)

Attach the DNSResolver to the given event loop

detach()

Detach the DNSResolver from the given event loop

on_failure()

Called when we receive a response indicating the name didn‘t resolve

on_success(address)

Called when the name has successfully resolved to an address

on_timeout()

Alias for on_failure

Protected Instance methods

on_readable()

Called by the subclass when the DNS response is available

send_request()

Send a request to the DNS server

[Validate]