Net::DN...:Recurse(3)

💖 NAME 💖

Net::DNS::Resolver::Recurse — a DNS recursive resolver, bestie. It literally does the whole root-to-answer journey for you ✨

Oh also, hi, quick vibe check: this is a User Contributed Perl Documentation page, and the module it's hyping up is Net::DNS::Resolver::Recurse(3). So like, that's the manual name, consider it folded in 🎀

---

🌸 SYNOPSIS 🌸

use Net::DNS::Resolver::Recurse;

my $resolver = new Net::DNS::Resolver::Recurse();

$resolver->hints('198.41.0.4'); # A.ROOT-SERVER.NET.

my $packet = $resolver->send( 'www.rob.com.au.', 'A' );

Look at her go 😭 she's resolving already.

---

🦋 DESCRIPTION 🦋

Okay so real talk: this module resolves your queries by following the delegation path from the DNS root. Like, it starts at the literal top of the DNS tree and walks it down, step by step, no cap. Main character energy tbh 👑

---

✨ METHODS ✨

This module inherits almost all the methods from Net::DNS::Resolver — so it's basically nepo-babying off a very good parent module, but the extra module-specific methods are the ones described below 💅

🍓 hints

This method specifies a list of the IP addresses of nameservers to be used to discover the addresses of the root nameservers.

$resolver->hints(@ip);

If no hints are passed, the priming query is directed to nameservers drawn from a built-in list of IP addresses. So like, she's got backup besties already lined up 😌

💜 query, search, send

The query(), search() and send() methods produce the same result as their counterparts in Net::DNS::Resolver.

$packet = $resolver->send( 'www.example.com.', 'A' );

So here's the tea ☕ — server-side recursion is suppressed by clearing the recurse flag in query packets, and recursive name resolution is performed explicitly. She's doing the work herself, not outsourcing it. Iconic.

The query() and search() methods are inherited from Net::DNS::Resolver and invoke send() indirectly — sneaky little kingmakers, love that for them.

🧚 callback

This method specifies a code reference to a subroutine, which is then invoked at each stage of the recursive lookup. Like a little progress report at every level of the tree, obsessed 🌈

For example to emulate dig's +trace function:

my $coderef = sub {
my $packet = shift;

printf ";; Received %d bytes from %s\n\n",
        $packet->answersize, $packet->answerfrom;
};

$resolver->callback($coderef);

Name a more iconic duo than answersize and answerfrom, I'll wait 💀

Heads up bestie: the callback subroutine is not called for queries for missing glue records. Fr fr, she just doesn't call it there. Don't come for her.

---

👑 ACKNOWLEDGEMENT 👑

This package is an improved and compatible reimplementation of the Net::DNS::Resolver::Recurse.pm created by Rob Brown in 2002, whose contribution is gratefully acknowledged. Respect where respect is due 🫶

---

💀 COPYRIGHT 💀

Copyright (c)2014,2019 Dick Franks.

Portions Copyright (c)2002 Rob Brown.

All rights reserved.

---

🌟 LICENSE 🌟

Permission to use, copy, modify, and distribute this software and its documentation for any purpose and without fee is hereby granted, provided that the original copyright notices appear in all copies and that both copyright notice and this permission notice appear in supporting documentation, and that the name of the author not be used in advertising or publicity pertaining to distribution of the software without specific prior written permission.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Bestie, that all-caps paragraph is the legal vibe check — no warranty, no liability, take it or leave it. It's giving "read the whole thing before you @ me" 😭

---

🔥 SEE ALSO 🔥

• Net::DNS::Resolver — the parent module, the blueprint, the moment.

---

That's the whole page, bestie! 🫶 Stay slay, resolve responsibly, and remember this page came from perl v5.42.0, dated 2026-09-02, living forever as Net::DN...:Recurse(3) in the User Contributed Perl Documentation collection. Mwah 💋