NAME

       Zonemaster::Engine::Test::Consistency - Module implementing tests focused on name servers responses
       consistency

SYNOPSIS

           my @results = Zonemaster::Engine::Test::Consistency->all( $zone );

METHODS

       all()
               my @logentry_array = all( $zone );

           Runs the default set of tests for that module, i.e. six tests.

           Takes a Zonemaster::Engine::Zone object.

           Returns a list of Zonemaster::Engine::Logger::Entry objects.

       metadata()
               my $hash_ref = metadata();

           Returns  a  reference to a hash, the keys of which are the names of all Test Cases in the module, and
           the corresponding values are references to an array containing all the message  tags  that  the  Test
           Case can use in log entries.

       tag_descriptions()
               my $hash_ref = tag_descriptions();

           Used by the built-in translation system.

           Returns  a  reference  to a hash, the keys of which are the message tags and the corresponding values
           are strings (message ids).

       version()
               my $version_string = version();

           Returns a string containing the version of the current module.

INTERNAL METHODS

       _emit_log()
               my $log_entry = _emit_log( $message_tag_string, $hash_ref );

           Adds a message to the logger for this  module.   See  "add($tag,  $argref,  $module,  $testcase)"  in
           Zonemaster::Engine::Logger::Entry for more details.

           Takes a string (message tag) and a reference to a hash (arguments).

           Returns a Zonemaster::Engine::Logger::Entry object.

       _ip_disabled_message()
               my $bool = _ip_disabled_message( $logentry_array_ref, $ns, @query_type_array );

           Checks  if  the IP version of a given name server is allowed to be queried. If not, it adds a logging
           message and returns true. Else, it returns false.

           Takes   a   reference   to    an    array    of    Zonemaster::Engine::Logger::Entry    objects,    a
           Zonemaster::Engine::Nameserver object and an array of strings (query type).

           Returns a boolean.

       _get_addr_rrs()
               my ( $logentry, @rrs_array ) = _get_addr_rrs( $ns, $zone_name, $query_type_string );

           Queries  a  given  name server for resource records of the given type. Used as an helper function for
           Test Case Consistency05.

           Takes a Zonemaster::Engine::Nameserver object, a  Zonemaster::Engine::DNSName  object  and  a  string
           (query type).

           Returns  a  Zonemaster::Engine::Logger::entry object (which could be "undef") and an optional list of
           Zonemaster::LDNS::RR objects.

TESTS

       consistency01()
               my @logentry_array = consistency01( $zone );

           Runs                  the                  Consistency01                  Test                   Case
           <https://github.com/zonemaster/zonemaster/blob/master/docs/public/specifications/tests/Consistency-
           TP/consistency01.md>.

           Takes a Zonemaster::Engine::Zone object.

           Returns a list of Zonemaster::Engine::Logger::Entry objects.

       consistency02()
               my @logentry_array = consistency02( $zone );

           Runs                   the                  Consistency02                  Test                  Case
           <https://github.com/zonemaster/zonemaster/blob/master/docs/public/specifications/tests/Consistency-
           TP/consistency02.md>.

           Takes a Zonemaster::Engine::Zone object.

           Returns a list of Zonemaster::Engine::Logger::Entry objects.

       consistency03()
               my @logentry_array = consistency03( $zone );

           Runs                  the                  Consistency03                  Test                   Case
           <https://github.com/zonemaster/zonemaster/blob/master/docs/public/specifications/tests/Consistency-
           TP/consistency03.md>.

           Takes a Zonemaster::Engine::Zone object.

           Returns a list of Zonemaster::Engine::Logger::Entry objects.

       consistency04()
               my @logentry_array = consistency04( $zone );

           Runs                   the                  Consistency04                  Test                  Case
           <https://github.com/zonemaster/zonemaster/blob/master/docs/public/specifications/tests/Consistency-
           TP/consistency04.md>.

           Takes a Zonemaster::Engine::Zone object.

           Returns a list of Zonemaster::Engine::Logger::Entry objects.

       consistency05()
               my @logentry_array = consistency05( $zone );

           Runs                  the                  Consistency05                  Test                   Case
           <https://github.com/zonemaster/zonemaster/blob/master/docs/public/specifications/tests/Consistency-
           TP/consistency05.md>.

           Takes a Zonemaster::Engine::Zone object.

           Returns a list of Zonemaster::Engine::Logger::Entry objects.

       consistency06()
               my @logentry_array = consistency06( $zone );

           Runs                   the                  Consistency06                  Test                  Case
           <https://github.com/zonemaster/zonemaster/blob/master/docs/public/specifications/tests/Consistency-
           TP/consistency06.md>.

           Takes a Zonemaster::Engine::Zone object.

           Returns a list of Zonemaster::Engine::Logger::Entry objects.

perl v5.40.1                                       2025-03-21              Zonemaster::En...st::Consistency(3pm)