Debian Codegraph @

README

raw ◀ ▶
1 Debian patch touch this file
1 NAME
2 BIND-Conf_Parser - a module for parsing BIND version 8 named.conf files
3
4 DESCRIPTION
5 This module allows a script to understand the contents of a BIND
•6 version 8 (and sometimes version 9) named.conf file. Why would you
7 want to parse your /etc/named.conf file? Well, let's say you're a
8 sysadmin and you've gotten tired of mismatches between your DNS
9 forward and reverse zones, and you want a tool that'll check your
10 zone files for inconsistencies and typos. How's that tool going to
11 get the complete list of zone files? Tah da, enter this module, stage
12 right! The verify_zones script included with this module does
13 exactly the above, and may even work at your site.
14
15 Truth be told, finding zone files is all I currently use it for.
16 However, it handles the complete syntax, so perhaps you can think
17 of other users.
18
19 The name of this module is perhaps not the best. Suggestions
20 are welcome.
21
•22 This revision matches BIND version 8.2.2. Some capability to not
23 throw fatal exceptions when parsing version 9 configuration files
24 has been added, but it is far from complete.
25
26 THANKS
27 The design of this module was inspired by Gisle Aas's HTML::Parser
28 module.
29
30 REQUIREMENTS
31 This module is known to work with perl-5.6.0, perl-5.005_02 and
32 perl-5.005_03, and is believed to work with Perl5.004. However, it
33 is sensitive to changes in the semantics of the pos() function and
34 /\G.../g matching. Indeed, the 5.004 -> 5.005 upgrade broke an
35 earlier version of this module. You Have Been Warned.
36
37 The parse() method requires that the IO::Scalar module from the
38 IO-stringy kit be installed.
39
40 DOCUMENTATION
41 The BIND::Conf_Parser module has been PODified, but good
42 descriptions of the data structures are, well, missing. The
43 examples in the POD may be enough to get one started.
44
45 MISSING
46 An automated test suite, for starters. I 'test' this using the
47 named.conf at where I work, but the coverage of that test is pretty
48 poor.
49
50 Support for the new statements supported by BIND 9.0.0 would be
51 nice.
52
53 AVAILABILITY
54 Currently, BIND-Conf_Parser can be found under:
55 ftp://ftp.gac.edu/pub/guenther/
56
57 I.e.,
58 ftp://ftp.gac.edu/pub/guenther/BIND-Conf_Parser-0.95.tar.gz
59
60 AUTHOR
•61 BIND-Conf_Parser was created by Philip Guenther <[email protected]>.
62 Some very preliminary changes were made to parse a few version 9
63 configuration files by Ivan Kohler <[email protected]>.
64