NAME

Unix::Conf::Bind8 - Front end for a suite of classes for manipulating a Bind8 conf and associated zone record files.

SYNOPSIS

    use Unix::Conf::Bind8;
    my ($conf, $ret);

    # get a new Bind8::Conf object. If one exists with the same 
    # name it is parsed.
    $conf = Unix::Conf::Bind8->new_conf (
        FILE => 'named.conf', 
        SECURE_OPEN => 1
    ) or $conf->die ('could not open \'named.conf\'');

    $db = Unix::Conf::Bind8->new_db (
        FILE    => '/etc/namedb/db.extremix.net', 
        ORIGIN  => 'extremix.net',
        CLASS   => 'IN',
        SECURE_OPEN     => 0,
    ) or $db->die ("couldn't create db");

METHODS

new_conf ()

 Arguments
 FILE        => PATHNAME,
 SECURE_OPEN => 1/0,       # default 1 (enabled)

Class Method Read Bind8 configuration file PATHNAME or create one if none exists. Returns a Bind8::Conf object in case of success or an Err object in case of failure. Refer to docs for Bind8::Conf for further information.

new_db ()

 Arguments
 FILE        => PATHNAME,        # pathname of the records file
 ORIGIN      => ZONE_ORIGIN, # from the zone statement
 CLASS       => ZONE_CLASS,      # from the zone statement
 SECURE_OPEN => 1/0,         # default 1 (enabled)

Class method. Read a zone records file PATHNAME or create one if none exists. Returns a Bind8::DB object in case of success or an Err object in case of failure. Do not use this method. Use Unix::Conf::Bind8::Conf::Zone::get_db (), or better still, Unix::Conf::Bind8::Conf::get_db () instead. Refer to docs for Bind8::DB for further information.

STATUS

Beta. Needs extensive testing.

AVAILABILITY

This module is available from http://www.cpan.org/modules/by-authors/id/K/KA/KARTHIKK/ http://www.extremix.net/UnixConf/

LICENCE

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with the program; if not, write to the Free Software Foundation, Inc. :

59 Temple Place, Suite 330, Boston, MA 02111-1307

COPYRIGHT

Copyright (c) 2002, Karthik Krishnamurthy <karthik.k@extremix.net>.