BootStrap(3)

📦
version 2.2.3 · 3 versions
, in arch rolling

💖 NAME 💖

okay bestie, welcome to BootStrap(3) — the User Contributed Perl Documentation page that's basically the optional-module bouncer for Perl. This is all about Net::DNS::SEC::Tools::BootStrap — optional loading of Perl modules, and yes, it's lowkey iconic. 💅

✨ SYNOPSIS ✨

use Net::DNS::SEC::Tools::BootStrap;

dnssec_tools_load_mods(
   PerlModule => 'Additional help/error text'
);

🌸 DESCRIPTION 🌸

So the DNSSEC-Tools package needs a whole bunch of Perl modules, but plot twist: only some of the tools actually need them. This module is the bestie that helps figure out at run-time — not at installation time — whether the right tools are available on the system. Run-time vibe check, basically. 🫶

If any module fails to load, dnssec_tools_load_mods() will display an error message and call exit(). The error message describes how to install a module via CPAN. It's not subtle, but it is helpful. 😭

The arguments to dnssec_tools_load_mods() are given in pairs. Each pair is a module to try to load (and import) plus a supplemental error message. If the module fails to load, that supplemental error message gets displayed along with the installation-via-CPAN message.

⚠️ special-case energy: if the error message consists of the string "noerror", then no error message will be displayed before the function exits. Silent exit, no drama. 💀

🦋 CAVEATS 🦋

The module will try to import any exported subroutines from the module into the main namespace. This means the BootStrap.pm module is likely to not be useful for importing symbols into other modules. Not me explaining namespace chaos, but here we are. 🙈

Work-arounds for this are:

  • import the symbols by hand — manual import era:
dnssec_tools_load_mods(
   PerlModule => 'Additional help/error text'
);

import PerlModule qw(func1 func2);

func1(arg1, arg2);
  • call the fully qualified function name — no import, just full-name main character energy:
dnssec_tools_load_mods(
   PerlModule => 'Additional help/error text'
);

PerlModule::func1(arg1, arg2);

Copyright 2006-2014 SPARTA, Inc. All rights reserved. See the COPYING file included with the DNSSEC-Tools package for details.

🌈 AUTHOR 🌈

Wes Hardaker <hardaker@users.sourceforge.net>

👑 SEE ALSO 👑

http://www.dnssec-tools.org/

✨ okay that's the whole page: perl v5.44.0, dated 2026-10-17, and the manual is BootStrap(3). mwah 💋🫶

📦 where this page comes from