/ 
Mojolicious-1.55
River stage four • 995 direct dependents • 1115 total dependents
/ Mojo::Resolver

NAME

Mojo::Resolver - Async IO DNS Resolver

SYNOPSIS

use Mojo::Resolver;

DESCRIPTION

Mojo::Resolver is a minimalistic async io stub resolver. Note that this module is EXPERIMENTAL and might change without warning!

ATTRIBUTES

Mojo::Resolver implements the following attributes.

ioloop

my $ioloop = $resolver->ioloop;
$resolver  = $resolver->ioloop(Mojo::IOLoop->new);

Loop object to use for io operations, by default a Mojo::IOLoop object will be used.

timeout

my $timeout = $resolver->timeout;
$resolver   = $resolver->timeout(5);

Maximum time in seconds a DNS lookup can take, defaults to 3.

METHODS

Mojo::Resolver inherits all methods from Mojo::Base and implements the following new ones.

servers

my @all     = $resolver->servers;
my $current = $resolver->servers;
$resolver   = $resolver->servers('8.8.8.8', '8.8.4.4');

IP addresses of DNS servers used for lookups, defaults to the value of MOJO_DNS_SERVER, auto detection, 8.8.8.8 or 8.8.4.4.

lookup

$resolver = $resolver->lookup('mojolicio.us' => sub {...});

Lookup IPv4 or IPv6 address for domain.

$resolver->lookup('mojolicio.us' => sub {
  my ($loop, $address) = @_;
  print "Address: $address\n";
  Mojo::IOLoop->stop;
});
Mojo::IOLoop->start;

resolve

$resolver = $resolver->resolve('mojolicio.us', 'A', sub {...});

Resolve domain into A, AAAA, CNAME, MX, NS, PTR or TXT records, * will query for all at once. Since this is a "stub resolver" it depends on a recursive name server for DNS resolution.

DEBUGGING

You can set the MOJO_RESOLVER_DEBUG environment variable to get some advanced diagnostics information printed to STDERR.

MOJO_RESOLVER_DEBUG=1

SEE ALSO

Mojolicious, Mojolicious::Guides, http://mojolicio.us.