Net::DN...stAnchor(3)

🌸 NAME 🌸

Okay so this is Net::DNS::SEC::Tools::TrustAnchor — man-page header Net::DN...stAnchor(3), from the User Contributed Perl Documentation. It's the base class for multiple types of trustanchor repositories that know how to read, write, and modify trust anchor repositories. iconic behavior, honestly 💖

✨ SYNOPSIS ✨

This is a base class for multiple types of trustanchor repositories that know how to read, write, and modify trust anchor repositories.

This package serves as both a API wrapper around a set of trust anchors as well as a base class for packages that need to read/write trust anchor sets into different formats.

Trust Anchors may be either DNSKEY records or DS references.

XXX: more documentation needed — no cap, that's literally what it says 😭

💅 API 💅

Usage API defined by this module or sub-modules.

Note that:

use Net::DNS::SEC::Tools::TrustAnchor;

is assumed to have imported some of the API routines mentioned below.

• $tar = new Net::DNS::SEC::Tools::TrustAnchor(); — Initializes a new collection of trust anchors.
• $module = load_module("type"); — Dynamically attemps to load a TrustAnchor reader/writer sub-class of Net::DNS::SEC::Tools::TrustAnchor named "Type" and return an instance of it.
  • All sub-classes are assumed to contain a single letter upper-case class name followed by all lower case. Any modules otherwise named will fail to load using this routine.
• $module = parse_component("type:file"); — This parses a type and file specification consisting of type separated by a colon (':') followed by a file-name path. It will then load the type module using the load_module() rotine and return the type, the file and extra options.

alpha alert, bestie: XXX: option parsing support not yet complete and will likely change the type:file format specification; I.E. the type:file formatting specification will likely change in the future and should be considered alpha-level support. 🫶

• $tar = $module->read($location, $options); — Reads in a given TAR from a $location reference and returns a blessed copy of the Net::DNS::SEC::Tools::TrustAnchor object containing all the data.
  • This function may be over-ridden by a sub-class.
• $tar = $module->read($location, $options); — Reads in a given TAR from a $location reference and returns an unblessed hash the contents. The read() function merely wraps around this and blesses it after being returned.
  • Sub-modules must over-ride this function (and/or the read() function) if they expect the module to support loading.
• $tar->merge(@others) — Merges the @other array of trust anchors into the $tar object's own trust anchor list.

🌈 AUTHOR 🌈

Wes Hardaker <hardaker ATTA users.sourceforge DOTTTY net> 💌

🦋 SEE ALSO 🦋

convertar(1)

💀 POD ERRORS 💀

Hey! The above document had some coding errors, which are explained below:

Around line 32:

You can't have =items (as at line 45) unless the first thing after the =over is an =item

---

k bye bestie 💖 source/version is perl v5.44.0, dated 2026-10-17, and the man page is Net::DN...stAnchor(3) — stay anchored and slay 🎀✨