Zonema...::Zone(3pm)

πŸ“¦ version 1.0.16, in ubuntu jammy

πŸ’– Zonemaster::Test::Zone β€” the zone content test queen πŸ’–

okay bestie, so this is Zonemaster::Test::Zone, a Perl module (that's a .3pm manpage, from the User Contributed Perl Documentation section, iykyk) and she is literally the one who runs the DNS zone content tests β€” think SOA records, MX records, all that delicious stuff. no cap. πŸŽ€


✨ NAME ✨

Zonemaster::Test::Zone β€” a module implementing tests of the zone content in DNS, such as SOA and MX records. she's giving main character energy in the DNS test suite fr fr πŸ¦‹


✨ SYNOPSIS ✨

so the vibe check to call her is literally just:

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

that's it. that's the whole entrance. πŸ’…


✨ METHODS ✨

  • all($zone) β€” runs the default set of tests and hands you back a list of log entries made by the tests. the whole squad, all at once. πŸ”₯
  • translation() β€” returns a reference to a hash with translation data. she's used by the builtin translation system, so don't come for her, she's busy. ✨
  • metadata() β€” returns a reference to a hash where the keys are the names of all the test methods in the module, and the values are references to lists with all the tags that method can use in log entries. basically the receipts for every test. πŸ“
  • version() β€” returns a version string for the module. simple, iconic, necessary. πŸ‘‘

✨ TESTS ✨

okay this is the part where it gets real. here's every single test she runs, and yes, we're doing all of them, no skipping, no summarising, that's not the vibe. 🫢

  • zone01($zone) β€” check that master nameserver in SOA is fully qualified. no half-finished names here bestie, we need the whole thing. πŸ’―
  • zone02($zone) β€” verify SOA 'refresh' minimum value. is it at least the minimum? we're checking. πŸ‘€
  • zone03($zone) β€” verify SOA 'retry' value is lower than SOA 'refresh' value. retry gotta be the little sibling here, that's the rule. πŸ“‰
  • zone04($zone) β€” verify SOA 'retry' minimum value. again with the minimums, she's thorough and we respect it. ✨
  • zone05($zone) β€” verify SOA 'expire' minimum value. expire needs to meet the minimum, periodt. ⏰
  • zone06($zone) β€” verify SOA 'minimum' (default TTL) value. that's the default TTL bestie, keep up. 🌸
  • zone07($zone) β€” verify that SOA master is not an alias (CNAME). no aliases allowed, we said what we said. 🚫
  • zone08($zone) β€” verify that MX records does not resolve to a CNAME. MX pointing at a CNAME? not on her watch. πŸ’€
  • zone09($zone) β€” verify that there is a target host (MX, A or AAAA) to deliver e-mail for the domain name. somebody's gotta be home to receive the mail fr fr πŸ“¬

ngl, if any of these come back mad, that's the test doing its job. she's not mean, she's just correct. πŸ’œ

okay that's the whole page, we ate and left no crumbs πŸ“ this was Zonemaster::Test::Zone, served up in the User Contributed Perl Documentation section, and the footer energy is: perl v5.32.0, dated 2021-01-06. bye bestie, go write some good zones πŸ’–βœ¨πŸŽ€πŸ¦‹πŸŒΈπŸ’…

πŸ“¦ where this page comes from