net::dns::faq(3) [centos man page]

Net::DNS::FAQ(3)					User Contributed Perl Documentation					  Net::DNS::FAQ(3)

NAME

       Net::DNS::FAQ - Frequently Asked Net::DNS Questions

SYNOPSIS

	perldoc Net::DNS::FAQ

DESCRIPTION

       This document serves to answer the most frequently asked questions on both the Net::DNS Mailing List and those sent to the author.

       The latest version of this FAQ can be found at	   http://www.net-dns.org/docs/FAQ.html

GENERAL

   What is Net::DNS?
       Net::DNS is a perl implementation of a DNS resolver.

INSTALLATION

   Where can I find Test::More?
       Test::More is part of the Test-Simple package, by Michael G Schwern.  You should be able to find the distrubution here:

	       http://search.cpan.org/dist/Test-Simple/

USAGE

   Why does Net::DNS::Resolver::query() return undef when the ANSWER section is empty?
       The short answer is, don't use query().	Net::DNS::Resolver::send() will always return the answer packet, as long as an answer was
       received.

       The longer answer is that query() is modeled after the res_query() function from the libresolv C library, which has similar behaviors.

VERSION

	$Id: FAQ.pod 872 2011-01-10 15:45:59Z willem $

perl v5.16.3							    2012-12-28							  Net::DNS::FAQ(3)

Net::DNS::Resolver::Programmable(3)			User Contributed Perl Documentation		       Net::DNS::Resolver::Programmable(3)

NAME

       Net::DNS::Resolver::Programmable - programmable DNS resolver class for offline emulation of DNS

VERSION

       0.003

SYNOPSIS

	   use Net::DNS::Resolver::Programmable;
	   use Net::DNS::RR;

	   my $resolver = Net::DNS::Resolver::Programmable->new(
	       records	       => {
		   'example.com'     => [
		       Net::DNS::RR->new('example.com.	   NS  ns.example.org.'),
		       Net::DNS::RR->new('example.com.	   A   192.168.0.1')
		   ],
		   'ns.example.org'  => [
		       Net::DNS::RR->new('ns.example.org.  A   192.168.1.1')
		   ]
	       },

	       resolver_code   => sub {
		   my ($domain, $rr_type, $class) = @_;
		   ...
		   return ($result, $aa, @rrs);
	       }
	   );

DESCRIPTION

       Net::DNS::Resolver::Programmable is a Net::DNS::Resolver descendant class that allows a virtual DNS to be emulated instead of querying the
       real DNS.  A set of static DNS records may be supplied, or arbitrary code may be specified as a means for retrieving DNS records, or even
       generating them on the fly.

   Constructor
       The following constructor is provided:

       new(%options): returns Net::DNS::Resolver::Programmable
	   Creates a new programmed DNS resolver object.

	   %options is a list of key/value pairs representing any of the following options:

	   records
	       A reference to a hash of arrays containing a static set of Net::DNS::RR objects.  The hash entries must be indexed by fully
	       qualified domain names (lower-case, without any trailing dots), and the entries themselves must be arrays of the RR objects
	       pertaining to these domain names.  For example:

		   records => {
		       'example.com'	 => [
			   Net::DNS::RR->new('example.com.     NS  ns.example.org.'),
			   Net::DNS::RR->new('example.com.     A   192.168.0.1')
		       ],
		       'www.example.com' => [
			   Net::DNS::RR->new('www.example.com. A   192.168.0.2')
		       ],
		       'ns.example.org'  => [
			   Net::DNS::RR->new('ns.example.org.  A   192.168.1.1')
		       ]
		   }

	       If this option is specified, the resolver retrieves requested RRs from this data structure.

	   resolver_code
	       A code reference used as a call-back for dynamically retrieving requested RRs.

	       The code must take the following query parameters as arguments: the domain, RR type, and class.

	       It must return a list composed of: the response's RCODE (by name, as returned by Net::DNS::Header->rcode), the "aa" (authoritative
	       answer) flag (boolean, use undef if you don't care), and the Net::DNS::RR answer objects.  If an error string is returned instead
	       of a valid RCODE, a Net::DNS::Packet object is not constructed but an error condition for the resolver is signaled instead.

	       For example:

		   resolver_code => sub {
		       my ($domain, $rr_type, $class) = @_;
		       ...
		       return ($result, $aa, @rrs);
		   }

	       If both this and the "records" option are specified, then statically programmed records are used in addition to any that are
	       returned by the configured resolver code.

	   defnames
	   dnsrch
	   domain
	   searchlist
	   debug
	       These Net::DNS::Resolver options are also meaningful with Net::DNS::Resolver::Programmable.  See Net::DNS::Resolver for their
	       descriptions.

   Instance methods
       The following instance methods of Net::DNS::Resolver are also supported by Net::DNS::Resolver::Programmable:

       search: returns Net::DNS::Packet
       query: returns Net::DNS::Packet
       send: returns Net::DNS::Packet
	   Performs an offline DNS query, using the statically programmed DNS RRs and/or the configured dynamic resolver code.	See the "new"
	   constructor's "records" and "resolver_code" options.  See the descriptions of search, query, and send for details about the calling
	   syntax of these methods.

       print
       string: returns string
       searchlist: returns list of string
       defnames: returns boolean
       dnsrch: returns boolean
       debug: returns boolean
       errorstring: returns string
       answerfrom: returns string
       answersize: returns integer
	   See "METHODS" in Net::DNS::Resolver.

       Currently the following methods of Net::DNS::Resolver are not supported: axfr, axfr_start, axfr_next, nameservers, port, srcport, srcaddr,
       bgsend, bgread, bgisready, tsig, retrans, retry, recurse, usevc, tcp_timeout, udp_timeout, persistent_tcp, persistent_udp, igntc, dnssec,
       cdflag, udppacketsize.  The effects of using these on Net::DNS::Resolver::Programmable objects are undefined.

SEE ALSO

       Net::DNS::Resolver

       For availability, support, and license information, see the README file included with Net::DNS::Resolver::Programmable.

AUTHORS

       Julian Mehnle <julian@mehnle.net>

perl v5.16.3							    2014-06-09				       Net::DNS::Resolver::Programmable(3)