Zonemaster::LDNS(3pm)

💖 NAME 💖

Zonemaster::LDNS — it's a Perl wrapper for the ldns DNS library, bestie. That's the whole vibe. 💅

---

✨ SYNOPSIS ✨

okay so here's the teeny tiny taste of what using this looks like:

my $resolver = Zonemaster::LDNS->new('8.8.8.8');
my $packet   = $resolver->query('www.iis.se');
say $packet->string;

literally three lines and you're already slaying ✨

---

🦋 DESCRIPTION 🦋

Zonemaster::LDNS represents a resolver — and a resolver is, like, the part of your system whose whole job is sending queries out into the world and receiving the answers back. That's it. That's the errand. 🫶

---

🎀 EXPORTABLE FUNCTIONS 🎀

these are the little helpers you can pull into your own namespace. not all of them jump in automatically — iykyk.

lib_version()

Hands you back the ldns version string. that's it, that's the whole function, no notes. 💜

to_idn($name, ...)

Feed it a bunch of domain names (as strings, bestie) and it gives them back with all labels converted to A-labels — unless they're already in ASCII, in which case it leaves them alone. ✨

It assumes the strings have already been converted to Perl's internal encoding before you call it. Rude of it? maybe. True? yes.

It can be exported, but it is not exported by default. 🎀

⚠️ this one needs GNU libidn2 to have been present back when Zonemaster::LDNS was compiled. If it wasn't? Calling to_idn will throw an exception straight at your face. no cap. 💀

has_idn()

Takes no arguments. Returns true if libidn2 was present at compilation, false if it was not. quick vibe check. 🧚

has_gost()

Takes no arguments. Returns true if GOST support was present at compilation, false if it was not. 🍓

load_zonefile($filename)

Loads all the resource records in a zone file and returns them as a list. all of them. every last one. obsessed. 👑

---

👑 CLASS METHOD 👑

new($addr,...)

Creates a brand new resolver object — the main character. 🌈 Here's the breakdown:

• Give it no arguments and it'll pick up nameserver addresses from the system configuration (/etc/resolv.conf or equivalent).
• Give it a single argument that is undef and it will not know of any nameservers at all — and every attempt to send a query will throw an exception. 💀
• Give it one or more arguments that are not undef and it'll attempt to parse them as IPv4 and IPv6 addresses. If that succeeds, congrats, you've got yourself a list of servers to send queries to. 🎉
• If an argument cannot be parsed as an IP address, an exception gets thrown. periodt.

---

💅 INSTANCE METHODS 💅

query($name, $type, $class)

Sends a query for that triple. If type or class aren't provided, they default to A and IN, respectively. Returns a Zonemaster::LDNS::Packet or undef. 🦋

query_with_pkt($packet)

Sends a Zonemaster::LDNS::Packet. Returns a Zonemaster::LDNS::Packet or undef. (yes the packet goes in and a packet comes out, iconic behaviour honestly) 💖

name2addr($name)

Asks this resolver to look up A and AAAA records for the given name, and returns a list of the IP addresses (as strings). In scalar context, it returns the number of addresses found instead. ⭐

addr2name($addr)

Takes an IP address, asks the resolver to do PTR lookups, and returns the names found. In scalar context, it returns the number of names found. 🎀

recurse($flag)

Returns the setting of the recursion flag. If you give it an argument, it treats that as a boolean and sets the flag accordingly. 🧚

debug($flag)

Gets and optionally sets the debug flag. 🙈

dnssec($flag)

Gets and optionally sets the DNSSEC flag. 🔥

cd($flag)

Gets and optionally sets the CD flag. 💜

igntc($flag)

Gets and optionally sets the igntc flag. 🌸

fallback($flag)

Gets and optionally sets the fallback flag. 🌈

usevc($flag)

Gets and optionally sets the usevc flag. ✨

retry($count)

Gets and optionally sets the number of retries. 🔁

retrans($seconds)

Gets and optionally sets the number of seconds between retries. ⏳

port($port)

Gets and optionally sets the destination port for requests. 🚪

edns_size($size)

Gets and optionally sets the EDNS0 UDP maximum size. 📏

axfr( $domain, $callback, $class )

Performs an AXFR operation. Let's talk details because there are details:

$callback must be a code reference. It gets called once for every received resource record, with the RR object as its one and only argument. After every single one of those calls, the return value of the callback gets examined — and if that value is false, the AXFR process gets aborted. 😭

The return value of the axfr() method itself will be true if the transfer completed normally, and false if it was aborted because the callback returned a false value.

⚠️ if anything goes wrong during the process, an exception will be thrown.

As an example, saving all the RRs received from an AXFR can be done like this:

my @rrs;
$resolver->axfr( $domain, sub { my ($rr) = @_; push @rrs, $rr; return 1;} );

axfr_start($domain,$class)

🚫 Deprecated. Use axfr() instead.

Sets this resolver object up for a zone transfer of the specified domain. If $class isn't given, it defaults to IN. 👑

axfr_next()

🚫 Deprecated. Use axfr() instead.

Gets the next RR in the zone transfer. axfr_start() must have been done before you call this, and after you call it you should use axfr_complete() to check if there are more records to get. If there's any problem, an exception will be thrown. 💀 Basically, the sequence should be something like:

$res->axfr_start('example.org');
do {
    push @rrlist, $res->axfr_next;
} until $res->axfr_complete;

axfr_complete()

🚫 Deprecated. Use axfr() instead.

Returns false if there's a started zone transfer with more records to get, and true if the started transfer has completed. ✅

axfr_last_packet()

🚫 Deprecated. Use axfr() instead.

If axfr_next() threw an exception, this method returns the Zonemaster::LDNS::Packet that made it do so. That packet's RCODE is likely to say what the problem was — for example, NOTAUTH or NXDOMAIN. 🔍

timeout($time)

Gets and/or sets the socket timeout for the resolver. ⏰

source($addr)

Gets and/or sets the IP address the resolver should try to send its queries from. 📮

---

🫶 AUTHORS 🫶

give it up for the legends who made this happen:

• Mattias P <mattias.paivarinta@iis.se> — Current maintainer 👑
• Calle Dybedahl <calle@init.se> — Original author 💖

---

🌈 LICENSE 🌈

This is free software under a 2-clause BSD license. The full text of the license lives in the LICENSE file included with this distribution. go read it, bestie, it's short and it ate. 💅✨

---

and that's the whole page, no cap 🎀 — signing off from the User Contributed Perl Documentation, running on perl v5.42.3, dated 2026-08-19. stay slaying, Zonemaster::LDNS(3pm) besties 🦋💖