NAME

Lim::Plugin::DNS::Server - Server class for DNS Manager Lim plugin

VERSION

See Lim::Plugin::DNS for version.

SYNOPSIS

use Lim::Plugin::DNS;

# Create a Server object
$server = Lim::Plugin::DNS->Server;

CONFIGURATION

TODO

INTERNAL METHODS

These are only internal methods and should not be used externally.

$server->_ScanZoneFile

Scan for zone files based on configuration and returns a hash reference.

$hash_ref->{<software>}->{<full path file name>} = {
    name => <full path file name>,
    software => <the software related to the zone file>,
    short => <file name>,
    write => <true if writable>,
    read => <true if readable>
};

$server->_ParseZoneFile($file, $option, $rr)

Parse a zone file and returns the content into $option and/or $rr. $option and $rr can be a hash or array reference.

# $option as an array reference
$option = [
    {
        name => <option name>,
        value => <option value>
    },
    ...
];

# $option as a hash reference
$option->{<option name>} = <option value>;

# $rr as an array reference
$rr = [
    {
        name => <rr name>,
        ttl => <rr ttl>,
        class => <rr class>,
        type => <rr type>,
        rdata => <rr rdata>
    },
    ...
];

# $rr as a hash reference
$rr->{<rr name>} = [
    {
        ttl => <rr ttl>,
        class => <rr class>,
        type => <rr type>,
        rdata => <rr rdata>
    },
    ...
];

$server->_ParseZoneContent($content, $option, $rr)

Parse a zone content from a string and returns the content into $option and/or $rr. $option and $rr can be a hash or array reference.

# $option as an array reference
$option = [
    {
        name => <option name>,
        value => <option value>
    },
    ...
];

# $option as a hash reference
$option->{<option name>} = <option value>;

# $rr as an array reference
$rr = [
    {
        name => <rr name>,
        ttl => <rr ttl>,
        class => <rr class>,
        type => <rr type>,
        rdata => <rr rdata>
    },
    ...
];

# $rr as a hash reference
$rr->{<rr name>} = [
    {
        ttl => <rr ttl>,
        class => <rr class>,
        type => <rr type>,
        rdata => <rr rdata>
    },
    ...
];

$server->_WriteZoneFile($file, $rr, $option)

Write the content of $rr and $option out to a zone file. A temporary file is used and then renamed to the specified $file once the writing is complete.

The $rr and $option needs to be in the format specified by _ParseZoneFile and _ParseZoneContent.

METHODS

These methods are called from the Lim framework and should not be used else where.

Please see Lim::Plugin::DNS for full documentation of calls.

$server->ReadZones(...)

Get a list of all zones that can be managed by the plugin.

$server->CreateZone(...)

Create a new zone file.

$server->ReadZone(...)

Returns a zone file as a content or split into option and rr.

$server->UpdateZone(...)

Update a zone file, this overwrites all zone data.

$server->DeleteZone(...)

Delete a zone file.

$server->CreateZoneOption(...)

Create a new zone option.

$server->ReadZoneOption(...)

Return zone options specified or all zone options for a zone file.

$server->UpdateZoneOption(...)

Update a zone option, this does not overwrite other zone options.

$server->DeleteZoneOption(...)

Delete a zone options.

$server->CreateZoneRr(...)

Create a new zone resource record.

$server->ReadZoneRr(...)

Return zone resource records specified or all zone resource records for a zone file.

$server->UpdateZoneRr(...)

Update a zone resource record, this does not remove other zone resource records.

$server->DeleteZoneRr(...)

Delete a zone resource records.

AUTHOR

Jerry Lundström, <lundstrom.jerry at gmail.com>

BUGS

Please report any bugs or feature requests to https://github.com/jelu/lim-plugin-dns/issues.

SUPPORT

You can find documentation for this module with the perldoc command.

perldoc Lim::Plugin::DNS

You can also look for information at:

• Lim issue tracker (report bugs here)

  https://github.com/jelu/lim-plugin-dns/issues

ACKNOWLEDGEMENTS

LICENSE AND COPYRIGHT

Copyright 2012-2013 Jerry Lundström.

This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License.

See http://dev.perl.org/licenses/ for more information.