NAME

       AnyEvent::CacheDNS - Simple DNS resolver with caching

SYNOPSIS

               use AnyEvent;
               use AnyEvent::HTTP;

               # Register our DNS resolver as the default resolver
               use AnyEvent::CacheDNS ':register';

               # Use AnyEvent as ususal
               my $cond = AnyEvent->condvar;
               http_get "http://search.cpan.org/", sub { $cond->send(); };
               $cond->recv();

DESCRIPTION

       This module provides a very simple DNS resolver that caches its results and can improve
       the connection times to remote hosts.

Import

       It's possible to register the this class as AnyEvent's main DNS resolver by passing the
       tag ":register" in the "use" statement.

METHODS

   register
       Registers a new DNS cache instance as AnyEvent's global DNS resolver.

   ENVIRONMENT
       "PERL_ANYEVENT_DNS_TTL"
           The effect of setting this variable differs depending on AnyEvent version.

           AnyEvent 5.x
               Default DNS response record cache TTL for older AnyEvent versions.  AnyEvent::DNS
               <= 6.x doesn't report record TTL and records get cached for infinite amount of
               time, therefore running programs won't detect if cached DNS records have changed.

               NOTE: Setting this variable to 0 disables purging records from cache.

           AnyEvent 6.x
               Newer versions of AnyEvent report DNS record TTL so records will be purged from
               the cache after their TTL expires. Setting this variable to any positive integer
               OVERRIDES the TTL for all records to the specified value, setting variable to 0
               disables purging records from the cache.

AUTHOR

       Emmanuel Rodriguez <potyl@cpan.org>

COPYRIGHT

       (C) 2011 Emmanuel Rodriguez - All Rights Reserved.