NAME

DNS::ZoneFile - Object-Oriented Management of a Master File

SYNOPSIS

use C<DNS::ZoneFile>;

my $zone=C<DNS::ZoneFile>->new(
	$filename_or_file_as_scalar,
	ZONE_ORIGIN	=>	$ORIGIN,
	NEW_ZONE	=>	$NEW_ZONE,
	);

$zone->addRecord(
	Domain	=>	$domain,
	TTL	=>	$ttl,
	Class	=>	$class,
	Type	=>	$type,
	Data	=>	\@arr,
	);

$zone->deleteRecord(
	$domain
	);
	
$zone->deleteRecord(
	$domain,
	$type
	);

$zone->printZone();

DESCRIPTION

my $zone=DNS::ZoneFile->new($file,%params);

new() creates a new DNS::ZoneFile object. It is initialised either from the filename supplied, or, if the first argument is a reference to a scalar, then the values is read.

Params:

ZONE_ORIGIN (.)

Sets the $ORIGIN for this zone.

NEW_ZONE (false)

If unset and DNS::ZoneFile can't read any data, then return undef. Otherwise create a new SOA. (If this is set, ZONE_ORIGIN shouldn't really be set to '.')

$zone->success();

Returns true if the object was created OK, false if otherwise.

$zone->fail();

Returns the error message of a a failed object call, or false if the object was created OK.

$zone->addRecord(@RRDATA);

This will add a record to the zone (maybe that should be %RRDATA?)

$zone->deleteRecord($domain[,$type]);

This is also unwritten as yet - but I envisage this as a $zone->deleteRecord("rigel.codix.net","MX"); or $zone->deleteRecord("alioth.codix.net");

$zone->printZone();

Returns a (reference to)? a scalar which is the zone file in full. or perhaps it keeps track of the filenames to open?

COMMENTS

I have been recommended to release this bit of code unfinished onto CPAN by some people - yes Greg, you know who you are - I'm fully aware that this doesn't abstract enough yet.

Hopefully doing this will enable me to write it quicker.

Version: 0.95

AUTHOR

Matthew Byng-Maddick <matthew@codix.net>

SEE ALSO

bind(8)