Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
Net::Nslookup(3)      User Contributed Perl Documentation     Net::Nslookup(3)

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

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>

perl v5.32.1			  2013-12-12		      Net::Nslookup(3)

NAME | SYNOPSIS | DESCRIPTION | TIMEOUTS | DEBUGGING | AUTHOR

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=Net::Nslookup&sektion=3&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help