Net::RD...Registry(3)

πŸ“¦
version 0.43 Β· 3 versions
, in fedora 44

✨ NAME ✨

okay so bestie, this page is the manual for Net::RDAP::Registry β€” a module that gives you an interface to the IANA RDAP registries. it's from the User Contributed Perl Documentation section of the perl man pages, and we're gonna go through it together, no skipping πŸ’–


🌸 SYNOPSIS 🌸

here's the vibe, copy-paste ready:

use Net::RDAP::Registry;
use Net::IP;
use Net::ASN;

$url = Net::RDAP::Registry->get_url(Net::DNS::Domain->new('example.com'));
$url = Net::RDAP::Registry->get_url(Net::IP->new('192.168.0.1'));
$url = Net::RDAP::Registry->get_url(Net::IP->new('2001:DB8::/32'));
$url = Net::RDAP::Registry->get_url(Net::ASN->new(65536));
$url = Net::RDAP::Registry->get_url('ABC123-TAG');

πŸ¦‹ DESCRIPTION πŸ¦‹

so like, RFC 7484 is the whole blueprint for how RDAP clients figure out which RDAP service is the authoritative one for any given internet resource β€” and they do it by checking one of several IANA registries. that's the lore πŸ“œ

this module is your bestie who handles that for you: it gives you an interface to those registries and hands back a URI object matching the URL for a resource that came from them. slay.

and the way it keeps things fresh? Net::RDAP::Registry downloads the registry files straight from the IANA website and keeps up-to-date local copies of those files chilling on your machine. always current, never stale, periodt ✨


πŸ‘‘ METHODS πŸ‘‘

$url = Net::RDAP::Registry->get_url($resource);

this method returns a URI object corresponding to the authoritative RDAP URL for whatever resource you throw at it. and $resource can be literally any one of these:

  • a Net::IP object representing an IPv4 or IPv6 address or address range;
  • a Net::ASN object representing an Autonymous System;
  • a Net::DNS::Domain object representing a domain name.
  • a string containing a tagged entity handle
fr fr, this method requires you to pass objects β€” that's not a vibe check it's a validation check, so the resource identifiers are properly validated before anything happens 🫢

and if there's just no URL to be found in the IANA registry? then undef is returned. no drama, just undef πŸ’€


Copyright 2018-2023 CentralNic Ltd, 2024-2026 Gavin Brown. for licensing info, pls see the LICENSE file in the Net::RDAP distribution β€” iykyk, go read it, it's giving responsible πŸ’…


and that's the whole page bestie!! this was pulled from perl v5.42.2, dated 2026-06-17, and the man page is Net::RD...Registry(3) β€” ty for reading, ur officially iconic πŸŒˆβ­πŸ’œ

πŸ“¦ where this page comes from