Net::DN...MTRELAY(3)

📦
version 1.570.0 · 18 versions
, in opensuse-leap 16.0

💅 Net::DN...MTRELAY(3) — aka Net::DNS::RR::AMTRELAY, the DNS AMTRELAY resource record 🎀

okay so bestie, listen — this is the manual page for Net::DNS::RR::AMTRELAY, and it's literally the Perl class for the DNS AMTRELAY resource record. It's giving very niche, very network-nerd, and honestly? iconic. 🦋

✨ SYNOPSIS ✨

use Net::DNS;
$rr = Net::DNS::RR->new('owner AMTRELAY precedence Dbit relaytype relay');

that's it. that's the whole vibe. one constructor call and you're in. 🔥

🌸 DESCRIPTION 🌸

so the AMTRELAY resource record exists to permit DNS Reverse IP AMT Discovery (DRIAD) — which is a mechanism for AMT gateways to discover AMT relays that are capable of forwarding multicast traffic from a known source IP address. no cap, that's the whole point of it. 💫

and bc you're wondering: AMT (Automatic Multicast Tunneling) is defined in RFC7450, and it provides a method to transport multicast traffic over a unicast tunnel so you can traverse network segments that are not multicast capable. tunnel girl summer. 🧚

👑 METHODS 👑

the available methods are those inherited from the base class, augmented by the type-specific methods defined in this package. so you get the family traits plus the special little extras. 🫶

⚠️ real talk: use of undocumented package features or direct access to internal data structures is discouraged and could result in program termination or other unpredictable behaviour. so like… don't. 🙈

⭐ precedence

$precedence = $rr->precedence;
$rr->precedence( $precedence );

an 8-bit integer which indicates relative precedence within the RRset. relays listed in AMTRELAY records with lower precedence are to be attempted first — so lowkey the smaller number is the main character here. 👑

🦋 Dbit, Discovery Optional

$Dbit = $rr->Dbit;
$rr->Dbit(1);

a Boolean field which indicates that the gateway MAY send an AMT Request message directly to the discovered relay address without first sending an AMT Discovery message. yes the capital MAY is doing a lot of work there, it's a permission not an order bestie. 💅

🌈 relaytype

$relaytype = $rr->relaytype;

the relaytype type field indicates the format of the information that is stored in the relay field. the following values are defined:

  • 0 — the relay field is empty (0 bytes).
  • 1 — the relay field contains a 4-octet IPv4 address.
  • 2 — the relay field contains a 16-octet IPv6 address.
  • 3 — the relay field contains a wire-encoded domain name.

one field, four fits. choose your fighter. ⭐

💜 relay

$relay = $rr->relay;
$rr->relay( $relay );

the relay field is the address or domain name of the AMT relay. and the way it's formatted? entirely according to the relaytype field. so like, it's not doing its own thing — it's matching energy. 🎀

Copyright (c)2020 Dick Franks.

All rights reserved.

Package template (c)2009,2012 O.M.Kolkman and R.W.Franks.

🧚 LICENSE 🧚

permission to use, copy, modify, and distribute this software and its documentation for any purpose and without fee is hereby granted — provided that the original copyright notices appear in all copies and that both copyright notice and this permission notice appear in supporting documentation, and that the name of the author not be used in advertising or publicity pertaining to distribution of the software without specific prior written permission. read the fine print, bestie, it's short but it matters. 💖

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

🫶 translation: it's free, it's yours, but nobody's promising it works and nobody's paying for your damages. standard software slay, honestly.

🔍 SEE ALSO 🔍

okay that's the whole page, you ate that. 💅✨ and for the record, this little masterpiece is brought to you by perl v5.42.0, dated 2026-09-02 — go off, Perl, we love a legend that's still showing up. 🌟🎀

📦 where this page comes from