Net::DNS::RR::HIP(3)

πŸ’… Net::DNS::RR::HIP(3) β€” the DNS HIP resource record, bestie edition

okay so this is a page from the User Contributed Perl Documentation, and honestly? she's giving niche-but-important. Let's get into it 🫢


✨ NAME ✨

Net::DNS::RR::HIP β€” the DNS HIP resource record. yep, that's it, that's the whole name, no notes πŸ’…


✨ SYNOPSIS ✨

okay bestie, here's how you actually use her:

use Net::DNS;
$rr = Net::DNS::RR->new('name IN HIP algorithm hit key servers');

like, that's the whole vibe. one constructor call and you're in 🌸


✨ DESCRIPTION ✨

so this is the class for DNS Host Identity Protocol (HIP) resource records. that's literally the entire description and honestly? iconic minimalism πŸ‘‘


✨ METHODS ✨

okay so here's the tea: the available methods are the ones inherited from the base class, plus the type-specific methods that are defined in this very package. so you get the family traits AND her own personality πŸ’–

lowkey important 🚨 β€” using undocumented package features or reaching directly into internal data structures is discouraged, and it could result in program termination or other unpredictable behaviour. no cap, do not touch the internals. fr fr.

🌟 algorithm

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

the PK algorithm field tells you which public key cryptographic algorithm is in play, and like, the implied format of the public key field. the values are the ones defined for the IPSECKEY algorithm type [RFC4025]. she's referencing RFCs, she's precise, we stan πŸ“š


🌟 hit

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

the hexadecimal representation of the host identity tag. hex girlie behavior ✨


🌟 hitbin

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

the binary representation of the host identity tag. same tag, different fit, both slay πŸ¦‹


🌟 key

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

the MIME Base64 representation of the public key. base64 my beloved πŸ’œ


🌟 keybin

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

the binary representation of the public key. that's it. that's the method. main character energy, minimal words πŸ”₯


🌟 servers

@servers = $rr->servers;

an optional list of domain names of rendezvous servers. note the @ β€” she's list context, she's giving plural, she's a whole squad πŸŽ€


Copyright (c)2009 Olaf Kolkman, NLnet Labs

All rights reserved.

and also: package template (c)2009,2012 O.M.Kolkman and R.W.Franks. gotta credit the template girlies too, periodt πŸ™ˆ


πŸ’– LICENSE πŸ’–

so here's the legal situation, and ngl it's pretty generous:

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
  • both the copyright notice and this permission notice appear in supporting documentation, and
  • the name of the author is not used in advertising or publicity pertaining to distribution of the software without specific, prior written permission.
okay now the loud part 🚨 β€” 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.

like that's the whole disclaimer in all caps, I did not soften it, respect the caps πŸ’€


🌈 SEE ALSO 🌈

go read the RFC, it's good for you, iykyk πŸ“–βœ¨


and that's the page!! footer vibes for the record: this is perl v5.42.0, dated 2026-09-02, and the page itself is Net::DNS::RR::HIP(3). mwah, go build something cute, bestie πŸŽ€πŸ’–πŸ«Ά

πŸ“¦ where this page comes from