NAME

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

SYNOPSIS

    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

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.