NAME
    Net::Nslookup - Provide nslookup(1)-like capabilities

ABSTRACT
    Net::Nslookup provides the capabilities of the standard UNIX command
    line tool nslookup(1). Net::DNS is a wonderful and full featured module,
    but quite often, all you need is `nslookup $host`. This module provides
    that functionality.

SYNOPSIS
      use Net::Nslookup;
      my @addrs = nslookup $host;

      my @mx = nslookup(qtype => "MX", domain => "perl.org");

DESCRIPTION
    Net::Nslookup exports a single function, called nslookup. nslookup can
    be used to retrieve A, PTR, CNAME, MX, and NS records.

      my $a  = nslookup(host => "use.perl.org", type => "A");

      my @mx = nslookup(domain => "perl.org", type => "MX");

      my @ns = nslookup(domain => "perl.org", type => "NS");

    nslookup takes a hash of options, one of which should be ``term'', and
    performs a DNS lookup on that term. The type of lookup is determined by
    the ``type'' (or ``qtype'') argument.

    If only a single argument is passed in, the type defaults to ``A'', that
    is, a normal A record lookup.

    If nslookup is called in a list context, and there is more than one
    address, an array is returned. If nslookup is called in a scalar
    context, and there is more than one address, nslookup returns the first
    address. If there is only one address returned (as is usually the case),
    then, naturally, it will be the only one returned, regardless of the
    calling context.

    ``domain'' and ``host'' are synonyms for ``term'', and can be used to
    make client code more readable. For example, use ``domain'' when getting
    NS records, and use ``host'' for A records; both do the same thing.

DEBUGGING
    Set $Net::Nslookup::DEBUG to a true value to get debugging messages
    carped to STDERR.

FUTURE DIRECTIONS
    Eventually, this module should be able to work without having Net::DNS
    installed; currently, Net::Nslookup's functionality is dependent upon
    that module.

TODO
    *   Support for TXT and SOA records.

AUTHOR
    darren chamberlain <darren@cpan.org>

