Unix::Conf::Bind8::Conf::Server - Class for handling Bind8 configuration


Unix-Conf-Bind8 documentation  | view source Contained in the Unix-Conf-Bind8 distribution.

Index


NAME

Top

Unix::Conf::Bind8::Conf::Server - Class for handling Bind8 configuration directive `server'

SYNOPSIS

Top

    use Unix::Conf::Bind8;

    my ($conf, $server, $ret);

    $conf = Unix::Conf::Bind8->new_conf (
        FILE        => '/etc/named.conf',
        SECURE_OPEN => 1,
    ) or $conf->die ("couldn't open `named.conf'");

    #
    # Ways to get a server object.
    #

    $server = $conf->new_server (
        NAME	=> '192.168.1.1',
        BOGUS	=> 'yes',
    ) or $server->die ("couldn't create server `192.168.1.1'");

    # OR

    $server = $conf->get_server ('10.0.0.1')
        or $server->die ("couldn't get server `10.0.0.1'");

    # 
    # Operations that can be performed on a server object.	
    # 

    $ret = $server->bogus ('no') 
        or $ret->die ("couldn't set attribute");

    $ret = $server->keys (qw (extremix-slaves.key sample_key));

    # get attributes
    $ret = $server->keys ()
        or $ret->die ("couldn't get keys");
    local $" = "\n";
    printf "Keys defined:\n@$ret\n";

    # delete attribute
    $ret = $server->delete_transfer_format ()
        or $ret->die ("couldn't delete attribute");

METHODS

Top

new ()
 Arguments
 NAME			=> scalar,
 BOGUS			=> scalar,	# Optional
 TRANSFERS		=> scalar,	# Optional
 SUPPORT-IXFR	=> scalar,
 TRANSFER-FORMAT
 				=> scalar,	# Optional
 KEYS			=> [elements ],	# Optional
 WHERE  		=> 'FIRST'|'LAST'|'BEFORE'|'AFTER'
 WARG   => Unix::Conf::Bind8::Conf::Directive subclass object
                        # WARG is to be provided only in case WHERE eq 'BEFORE 
                        # or WHERE eq 'AFTER'
 PARENT			=> reference,
                        # to the Conf object datastructure.

Class constructor. Creates a new Unix::Conf::Bind8::Conf::Server object, and returns it, on success, an Err object otherwise. Do not call this constructor directly. Use Unix::Conf::Bind8::Conf::new_server () instead.

name ()
 Arguments
 value		# optional

Object method. Get/set the name attribute in the invocant. Returns the attribute value or true on success, an Err object otherwise.

bogus ()
 Arguments
 value		# optional

Object method. Get/set the name attribute in the invocant. Returns the attribute value or true on success, an Err object otherwise.

delete_bogus ()

Object method. Deletes the corresponding attribute, if defined, and returns true, an Err object otherwise.

support_ixfr ()
 Arguments
 value		# optional

Object method. Get/set the name attribute in the invocant. Returns the attribute value or true on success, an Err object otherwise.

delete_support_ixfr ()

Object method. Deletes the corresponding attribute, if defined, and returns true, an Err object otherwise.

transfers ()
 Arguments
 value	# number, optional

Object method. Get/set the name attribute in the invocant. Returns the attribute value or true on success, an Err object otherwise.

delete_transfers ()

Object method. Deletes the corresponding attribute, if defined, and returns true, an Err object otherwise.

transfer_format ()
 Arguments
 value	# 'one-answer'|'many-answers', optional

Object method. Get/set the name attribute in the invocant. Returns the attribute value or true on success, an Err object otherwise.

delete_transfer_format ()

Object method. Deletes the corresponding attribute, if defined, and returns true, an Err object otherwise.

keys ()
 Arguments
 LIST	# name, optional
 or
 [ LIST ]

Object method. Get/set the name attribute in the invocant. Returns the attribute value or true on success, an Err object otherwise.

delete_keys ()

Object method. Deletes the corresponding attribute, if defined, and returns true, an Err object otherwise.


Unix-Conf-Bind8 documentation  | view source Contained in the Unix-Conf-Bind8 distribution.