.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "Zonemaster::Engine::TestMethodsV2 3pm"
.TH Zonemaster::Engine::TestMethodsV2 3pm 2024-04-22 "perl v5.38.2" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH NAME
Zonemaster::Engine::TestMethodsV2 \- Version 2 of Methods common to Test Specifications used in Test modules
.SH SYNOPSIS
.IX Header "SYNOPSIS"
.Vb 1
\&    my @results = Zonemaster::Engine::TestMethodsV2\->get_parent_ns_ips($zone);
.Ve
.SH METHODS
.IX Header "METHODS"
For details on what these Methods implement, see the Test Specifications document
(https://github.com/zonemaster/zonemaster/blob/v2022.2.2/docs/specifications/tests/MethodsV2.md).
.IP get_parent_ns_ips($zone) 4
.IX Item "get_parent_ns_ips($zone)"
[External]
.Sp
This Method will obtain the name servers that serves the parent zone, i.e. the zone from which the Child Zone is delegated from.
.Sp
Takes a Zonemaster::Engine::Zone object (\f(CW$zone\fR).
.Sp
Returns an arrayref of Zonemaster::Engine::Nameserver objects, or `undef` if no parent zone was found.
.ie n .IP "_get_oob_ips($zone, $ns_names_ref)" 4
.el .IP "_get_oob_ips($zone, \f(CW$ns_names_ref\fR)" 4
.IX Item "_get_oob_ips($zone, $ns_names_ref)"
[Internal]
.Sp
This Method will obtain the IP addresses of the Out-Of-Bailiwick name servers for the given zone and a given set of name server names.
.Sp
Takes a Zonemaster::Engine::Zone object (\f(CW$zone\fR) and an arrayref of Zonemaster::Engine::Nameserver objects (\f(CW$ns_names_ref\fR).
.Sp
Returns an arrayref of Zonemaster::Engine::Nameserver objects.
.IP _get_delegation($zone) 4
.IX Item "_get_delegation($zone)"
[Internal]
.Sp
This Method will obtain the name server names (from the NS records) and the IP addresses (from Glue records) from the delegation of the given zone from the parent zone.
Glue Records are address records for In-Bailiwick name server names, if any.
.Sp
Takes a Zonemaster::Engine::Zone object (\f(CW$zone\fR).
.Sp
Returns an arrayref of Zonemaster::Engine::Nameserver objects, or `undef` if no parent zone was found.
.IP get_del_ns_names_and_ips($zone) 4
.IX Item "get_del_ns_names_and_ips($zone)"
[External]
.Sp
This Method will obtain the name server names (from the NS records) and the IP addresses (from Glue Records) from the delegation of the given zone from the parent zone.
Glue Records, if any, are address records for name server names. Also obtain the IP addresses for the Out-Of-Bailiwick name server names, if any.
If the Glue Records include address records for Out-Of-Bailiwick name servers they will be included twice, unless identical.
.Sp
Takes a Zonemaster::Engine::Zone object (\f(CW$zone\fR).
.Sp
Returns an arrayref of Zonemaster::Engine::Nameserver objects, or `undef` if no parent zone was found.
.IP get_del_ns_names($zone) 4
.IX Item "get_del_ns_names($zone)"
[External]
.Sp
This Method will obtain the name server names of the given zone as defined in the delegation from parent zone.
.Sp
Takes a Zonemaster::Engine::Zone object (\f(CW$zone\fR).
.Sp
Returns an arrayref of strings, or `undef` if no parent zone was found.
.IP get_del_ns_ips($zone) 4
.IX Item "get_del_ns_ips($zone)"
[External]
.Sp
This Method will obtain the IP addresses (from Glue Records) from the delegation of the given zone from the parent zone.
Glue Records are address records for In-Bailiwick name server names, if any. Also obtain the IP addresses for the Out-Of-Bailiwick name server names, if any.
.Sp
Takes a Zonemaster::Engine::Zone object (\f(CW$zone\fR).
.Sp
Returns an arrayref of strings, or `undef` if no parent zone was found.
.IP get_zone_ns_names($zone) 4
.IX Item "get_zone_ns_names($zone)"
[External]
.Sp
This Method will obtain the names of the authoritative name servers for the given zone as defined in the NS records in the zone itself.
.Sp
Takes a Zonemaster::Engine::Zone object (\f(CW$zone\fR).
.Sp
Returns an arrayref of strings, or `undef` if no parent zone was found.
.IP _get_ib_addr_in_zone($zone) 4
.IX Item "_get_ib_addr_in_zone($zone)"
[Internal]
.Sp
This Method will obtain obtain the address records matching the In-Bailiwick name server names from the given zone.
.Sp
Takes a Zonemaster::Engine::Zone object (\f(CW$zone\fR).
.Sp
Returns an arrayref of Zonemaster::Engine::Nameserver objects, or `undef` if no parent zone was found.
.IP get_zone_ns_names_and_ips($zone) 4
.IX Item "get_zone_ns_names_and_ips($zone)"
[External]
.Sp
This Method will obtain the name server names (extracted from the NS records) from the apex of the given zone.
For the In-Bailiwick name server names obtain the IP addresses from the given zone. For the Out-Of-Bailiwick name server names obtain the IP addresses from recursive lookup.
.Sp
Takes a Zonemaster::Engine::Zone object (\f(CW$zone\fR).
.Sp
Returns an arrayref of Zonemaster::Engine::Nameserver objects, or `undef` if no parent zone was found.
.IP get_zone_ns_ips($zone) 4
.IX Item "get_zone_ns_ips($zone)"
[External]
.Sp
This Method will obtain the IP addresses of the name servers, as extracted from the NS records of apex of the given zone.
.Sp
Takes a Zonemaster::Engine::Zone object (\f(CW$zone\fR).
.Sp
Returns an arrayref of strings, or `undef` if no parent zone was found.