1BootStrap(3)          User Contributed Perl Documentation         BootStrap(3)
2
3
4

NAME

6       Net::DNS::SEC::Tools::BootStrap - Optional loading of Perl modules
7

SYNOPSIS

9         use Net::DNS::SEC::Tools::BootStrap;
10
11         dnssec_tools_load_mods(
12            PerlModule => 'Additional help/error text'
13         );
14

DESCRIPTION

16       The DNSSEC-Tools package requires a number of Perl modules that are
17       only needed by some of the tools.  This module helps determine at run-
18       time, rather than at installation time, if the right tools are
19       available on the system.  If any module fails to load,
20       dnssec_tools_load_mods() will display an error message and calls
21       exit().  The error message describes how to install a module via CPAN.
22
23       The arguments to dnssec_tools_load_mods() are given in pairs.  Each
24       pair is a module to try to load (and import) and a supplemental error
25       message.  If the module fails to load, the supplemental error message
26       will be displayed along with the installation-via-CPAN message.  If the
27       error message consists of the string "noerror", then no error message
28       will be displayed before the function exits.
29

CAVEATS

31       The module will try to import any exported subroutines from the module
32       into the main namespace.  This means that the BootStrap.pm module is
33       likely to not be useful for importing symbols into other modules.
34       Work-arounds for this are:
35
36       - import the symbols by hand
37             dnssec_tools_load_mods(
38                PerlModule => 'Additional help/error text'
39             );
40
41             import PerlModule qw(func1 func2);
42
43             func1(arg1, arg2);
44
45       - call the fully qualified function name
46             dnssec_tools_load_mods(
47                PerlModule => 'Additional help/error text'
48             );
49
50             PerlModule::func1(arg1, arg2);
51

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

AUTHOR

57       Wes Hardaker <hardaker@users.sourceforge.net>
58

SEE ALSO

60       http://www.dnssec-tools.org/
61
62
63
64perl v5.36.0                      2022-07-21                      BootStrap(3)
Impressum