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>