NAME

Unix::Conf::Bind8::Conf::Options - Class for representing Bind8 options directive

SYNOPSIS

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

    # get an options object if one is defined
    $options = $conf->get_options ()
        or $options->die ("couldn't get options");
    
    # or create a new one
    $options = $conf->new_options (
        DIRECTORY  => 'db',
        VERSION    => '8.2.3-P5',
    ) or $options->die ("couldn't create options");

     
    # now enable/disable individual options using the options object.
    my $acl = $conf->new_acl (
        NAME     => 'query-acl',
           ELEMENTS => [ qw (10.0.0.1 10.0.0.2 10.0.0.3) ],
    );
    $acl->die ("couldn't create `query-acl'") unless ($acl);
    $ret = $options->allow_query ($acl) 
        or $ret->die ("couldn't set allow-query");
    $options->delete_allow_transfer ();
        

DESCRIPTION

version ()

directory ()

named_xfer ()

dump_file ()

memstatistics_file ()

pid_file ()

statistics_file ()

 Arguments
 'string',      # optional

Object method. Get/Set attributes from the invoking object. If called with a string argument, the method tries to set the corresponding attribute and returns true on success, an Err object otherwise. Returns value of the corresponding attribute if defined, an Err object otherwise.

auth_nxdomain ()

deallocate_on_exit ()

dialup ()

fake_iquery ()

fetch_glue ()

has_old_clients ()

host_statistics ()

multiple_cnames ()

notify ()

recursion ()

rcf2308_type1 ()

use_id_pool ()

treat_cr_as_space ()

also_notify ()

maintain_ixfr_base ()

 Arguments
 'string',     # Optional. allowed values are 'yes', 'no'

Object method. Get/Set attributes from the invoking object. If called with a string argument, the method tries to set the corresponding attribute and returns true on success, an Err object otherwise. Returns value of the corresponding attribute if defined, an Err object otherwise.

forward ()

 Arguments
 'string',     # optional. allowed values are 'only', 'first'

Object method. Get/Set attributes from the invoking object. If called with a string argument, the method tries to set the corresponding attribute and returns true on success, an Err object otherwise. Returns value of the corresponding attribute if defined, an Err object otherwise.

allow_query ()

allow_transfer ()

allow_recursion ()

blackhole ()

 Arguments
 object,      # Unix::Conf::Bind8::Conf::Acl object

Object method. Get/Set attributes from the invoking object. If called with a string argument, the method tries to set the corresponding attribute and returns true on success, an Err object otherwise. Returns value of the corresponding attribute if defined, an Err object otherwise.

lame_ttl ()

max_transfer_time_in ()

max_ncache_ttl ()

min_roots ()

serial_queries ()

max_serial_queries ()

transfers_in ()

transfers_out ()

transfers_per_ns ()

max_ixfr_log_size ()

cleaning_interval ()

heartbeat_interval ()

interface_interval ()

statistics_interval ()

 Arguments
 number,       # Optional

Object method. Get/Set attributes from the invoking object. If called with a string argument, the method tries to set the corresponding attribute and returns true on success, an Err object otherwise. Returns value of the corresponding attribute if defined, an Err object otherwise.

transfer_format ()

 Arguments
 'string',    # Optional. Allowed arguments are 'one-answer', 
              # 'many-answers'

Object method. Get/Set attributes from the invoking object. If called with a string argument, the method tries to set the corresponding attribute and returns true on success, an Err object otherwise. Returns value of the corresponding attribute if defined, an Err object otherwise.

valid_ipaddress ()

 Arguments
 'string',   # Optional. The argument must be an IP Address in the
             # dotted quad notation

Object method. Get/Set attributes from the invoking object. If called with a string argument, the method tries to set the corresponding attribute and returns true on success, an Err object otherwise. Returns value of the corresponding attribute if defined, an Err object otherwise.

coresize ()

datasize ()

files ()

stacksize ()

 Arguments
 'string',   # Optional. The argument must be a size spec. Refer to
             # the Bind8 manual for a definitio of size_spec.

Object method. Get/Set attributes from the invoking object. If called with a string argument, the method tries to set the corresponding attribute and returns true on success, an Err object otherwise. Returns value of the corresponding attribute if defined, an Err object otherwise.

delete_version ()

delete_directory ()

delete_named_xfer ()

delete_dump_file ()

delete_memstatistics_file ()

delete_pid_file ()

delete_statistics_file ()

delete_auth_nxdomain ()

delete_deallocate_on_exit ()

delete_dialup ()

delete_fake_iquery ()

delete_fetch_glue ()

delete_has_old_clients ()

delete_host_statistics ()

delete_multiple_cnames ()

delete_notify ()

delete_recursion ()

delete_rfc2308_type1 ()

delete_use_id_pool ()

delete_treat_cr_as_space ()

delete_also_notify ()

delete_forward ()

delete_allow_query ()

delete_allow_recursion ()

delete_allow_transfer ()

delete_blackhole ()

delete_lame_ttl ()

delete_max_transfer_time_in ()

delete_max_ncache_ttl ()

delete_min_roots ()

delete_serial_queries ()

delete_max_serial_queries ()

delete_transfer_format ()

delete_transfers_in ()

delete_transfers_out ()

delete_transfers_per_ns ()

delete_transfer_source ()

delete_maintain_ixfr_base ()

delete_max_ixfr_log_size ()

delete_coresize ()

delete_datasize ()

delete_files ()

delete_stacksize ()

delete_cleaning_interval ()

delete_heartbeat_interval ()

delete_interface_interval ()

delete_statistics_interval ()

delete_topology ()

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

delete_option ()

 Arguments
 'OPTION-NAME',

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

check_names ()

 Arguments
 'string',        # 'master'|'slave'|'response'
 'string',        # 'warn'|'fail'|'ignore'

Object method. Get/Set the 'check-name' attribute from the invoking object. If arguments are passed the method tries to set the 'check-names' attribute and return true if successful, an Err object otherwise. If no arguments are passed, then the method tries to return the value of the 'check-names' attribute if defined, an Err object otherwise.

forwarders ()

 Arguments
 [ 'IP_Address1', 'IP_Address2', ]  # the IP Addresses must be 
                                    # specified in the dotted 
                                    # quad notation.

Object method. Get/Set the 'forwarders' attribute in the invoking object. If an array ref is passed as argument, the method tries to set the 'forwarders' attribute and returns true on success, an Err object otherwise. If no arguments are passed then the method tries to return an array ref if the 'forwarders' attribute is defined, an Err object otherwise.

add_forwarders ()

 Arguments
 [ 'IP_Address1', 'IP_Address2', ]  # the IP Addresses must be 
                                    # specified in the dotted 
                                    # quad notation.

Object method. Add the elements of the argument, to the 'forwarders' attribute. Return true on success, an Err object otherwise.

options

Object method. Iterates through the list of defined options returning their name one at a time in a scalar context, or a list of all defined option names in list context.

new ()

 Arguments
 OPTION-NAME   => value,      # the value type is dependant on the option

Class Constructor. Create a new Unix::Conf::Bind8::Conf::Options object and return it if successful, or an Err object otherwise. Direct use of this method is deprecated. Use Unix::Conf::Bind8::Conf::new_options () instead.