DNS::LDNS::RRList(3)

💖 DNS::LDNS::RRList — a whole lil list of rrs 💖

okay bestie so this is DNS::LDNS::RRList, from the User Contributed Perl Documentation collection. it's literally just a list of rrs — a resource record list, a glow-up little container for holding a bunch of DNS records together. no cap, that's the whole vibe. 🎀

---

✨ SYNOPSIS ✨

here's the whole menu, and yes we're keeping every single line because every single line slays:

use DNS::LDNS ':all'

my l = new DNS::LDNS::RRList
my l = new DNS::LDNS::RRList(hosts_file => \*FILE)
my l = new DNS::LDNS::RRList(hosts_filename => fname)
my l2 = l->clone

l->to_string

l->print(\*FILE)
count = l->rr_count

rr = l->rr(index)
l->push(@rr)
rr = l->pop

l->push_list(l2)
l2 = l->pop_list(count)
l2 = l->pop_rrset

l->compare(l2)

l2 = l->subtype_by_rdata(rdata, pos)

bool = l->is_rrset

bool = l->contains_rr(rr)

(status, goodkeys) = l->verify(sig, keys)
(status, goodkeys) = l->verify_time(sig, keys, checktime)
(status, goodkeys) = l->verify_notime(sig, keys)
(status, goodkeys) = l->verify_rrsig_keylist(sig, keys)
(status, goodkeys) = l->verify_rrsig_keylist_time(sig, keys, checktime)
(status, goodkeys) = l->verify_rrsig_keylist_notime(sig, keys)
status = l->verify_rrsig(sig, keys)
status = l->verify_rrsig_time(sig, keys, checktime)

rr = l->create_empty_rrsig(key)
rrlist = l->sign_public(keylist)

rrlist->canonicalize
rrlist->sort
rrlist->sort_nsec3   # the list must contain only nsec3 rrs

rr = keylist->get_dnskey_for_rrsig(rrsig)
rr = keylist->get_rrsig_for_name_and_type(name, type)

so like. you can make a fresh one with new DNS::LDNS::RRList, or feed it a hosts_file as a filehandle (\*FILE), or a hosts_filename by name. you can clone it, to_string it, print it to a filehandle, count the records with rr_count, grab one by index, push and pop, and do all the list-to-list moves with push_list, pop_list(count) and pop_rrset. 🌸

then there's the DNSSEC girlies: verify, verify_time, verify_notime, the whole verify_rrsig_keylist family, plus verify_rrsig and verify_rrsig_time. you can create_empty_rrsig(key) and sign_public(keylist). and honestly? canonicalize, sort, and sort_nsec3 are the ones that put the list in order — and heads up, sort_nsec3 needs the list to contain only nsec3 rrs, that's the rule, periodt. 💅

also along for the ride: get_dnskey_for_rrsig(rrsig) and get_rrsig_for_name_and_type(name, type) off the keylist. icons only.

---

👀 SEE ALSO 👀

want the lore? it's giving official website:

• http://www.nlnetlabs.nl/projects/ldns

---

💜 AUTHOR 💜

this one was written by Erik Pihl Ostlyngen, <erik.ostlyngen@uninett.no>. shoutout, absolute legend, ate. 🫶

---

🎀 COPYRIGHT AND LICENSE 🎀

Copyright (C) 2013 by UNINETT Norid AS

and the legal bit, fr fr:

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.14.2 or, at your option, any later version of Perl 5 you may have available.

---

okay that's the whole page bestie, you're so ready for rrs now, go off 💖✨🦋

this was brought to you by perl v5.42.2 on 2026-06-11 — DNS::LDNS::RRList(3), and it devoured, no crumbs. mwah 💅🌈⭐