GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  NET::NSLOOKUP (3)

.ds Aq ’

NAME

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

CONTENTS

SYNOPSIS



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

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



DESCRIPTION

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.

Net::Nslookup exports a single function, called nslookup. nslookup can be used to retrieve A, PTR, CNAME, MX, NS, SOA, TXT, and SRV 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");

  my $name = nslookup(host => "206.33.105.41", type => "PTR");

  my @srv = nslookup(term => "_jabber._tcp.gmail.com", type => "SRV");



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 argument. If server is specified (it should be an IP address, or a reference to an array of IP addresses), that server(s) will be used for lookups.

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, 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.

server should be a single IP address or a reference to an array of IP addresses:



  my @a = nslookup(host => example.com, server => 4.2.2.1);

  my @a = nslookup(host => example.com, server => [ 4.2.2.1, 128.103.1.1 ])



By default, when doing CNAME, MX, and NS lookups, nslookup returns names, not addresses. This is a change from versions prior to 2.0, which always tried to resolve names to addresses. Pass the recurse => 1 flag to nslookup to have it follow CNAME, MX, and NS lookups. Note that this usage of recurse is not consistent with the official DNS meaning of recurse.



    # returns soemthing like ("mail.example.com")
    my @mx = nslookup(domain => example.com, type => MX);

    # returns soemthing like ("127.0.0.1")
    my @mx = nslookup(domain => example.com, type => MX, recurse => 1);



SOA lookups return the SOA record in the same format as the ‘host‘ tool:



    print nslookup(domain => example.com, type => SOA);
    dns1.icann.org. hostmaster.icann.org. 2011061433 7200 3600 1209600 3600



TIMEOUTS

Lookups timeout after 15 seconds by default, but this can be configured by passing timeout => X to nslookup.

DEBUGGING

Pass debug => 1 to nslookup to emit debugging messages to STDERR.

AUTHOR

darren chamberlain <darren@cpan.org>
Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 NET::NSLOOKUP (3) 2013-12-12

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.