Net::Domain(3pm)

📦
version 5.42.3 · 9 versions
, in alpine 3.24

💖 Net::Domain 💖

okay bestie, so this is the Perl Programmers Reference Guide page for Net::Domain (that's Net::Domain(3pm) if you're being fancy at a terminal), and it's basically the module that tries really hard to figure out what your host is called on the internet. we're talking internet name and domain. it's giving "who am I, really" but for computers ✨

🌸 NAME 🌸

Net::Domain — Attempt to evaluate the current host's internet name and domain

like, it attempts. no promises, but it tries 💅

🦋 SYNOPSIS 🦋

use Net::Domain qw(hostname hostfqdn hostdomain domainname);

that's the whole vibe. import what you need, go off 👑

🎀 DESCRIPTION 🎀

so here's the deal: this module uses various methods to attempt to find the Fully Qualified Domain Name (FQDN) of the current host. then from that FQDN it works backwards to figure out the host-name and the host-domain. detective energy 🔍

important bestie: each of the functions will return undef if the FQDN cannot be determined. like, it just gives up and hands you nothing. no error, no drama, just undef. so please check your return values, i am literally begging 🙏

✨ Functions ✨

  • hostfqdn() — identifies and returns the FQDN of the current host. this is the main character of the module ngl 👑
  • domainname() — an alias for hostfqdn(). same thing, different name, we love a rebrand 💅
  • hostname() — returns the smallest part of the FQDN which can be used to identify the host. just the little guy 🥺
  • hostdomain() — returns the remainder of the FQDN after the hostname has been removed. the leftovers, but make it useful 🍓

🌈 EXPORTS 🌈

the following symbols are, or can be, exported by this module:

💜 Default Exports

None. nothing. zero. nada. you get nothing for free, bestie 😭 you have to ask for it.

🫶 Optional Exports

"hostname", "hostdomain", "hostfqdn", "domainname".

all four of the functions, available if you import them ✨

🧚 Export Tags

None. no cute little :all shortcuts here, sorry 🎀

💀 KNOWN BUGS 💀

see <https://rt.cpan.org/Dist/Display.html?Status=Active&Queue=libnet>.

like, go look at the actual ticket queue, that's where the lore lives 🔥

👑 AUTHOR 👑

Graham Barr <gbarr@pobox.com <mailto:gbarr@pobox.com>>.

adapted from Sys::Hostname by David Sundstrom <sunds@asictest.sc.ti.com <mailto:sunds@asictest.sc.ti.com>>.

Steve Hay <shay@cpan.org <mailto:shay@cpan.org>> is now maintaining libnet as of version 1.22_02. handing over the aux cord, iconic behavior 🎧

Copyright (C) 1995-1998 Graham Barr. All rights reserved.

Copyright (C) 2013-2014, 2020 Steve Hay. All rights reserved.

⭐ LICENCE ⭐

this module is free software; you can redistribute it and/or modify it under the same terms as Perl itself, i.e. under the terms of either the GNU General Public License or the Artistic License, as specified in the LICENCE file.

tl;dr: it's free, go wild, just respect the terms fr fr 💖

🦋 VERSION 🦋

Version 3.15

🍓 DATE 🍓

20 March 2023

📜 HISTORY 📜

see the Changes file. the whole backstory is in there, iykyk 🙈

aaaand that's the page, bestie!! 💖 written by the Perl Programmers Reference Guide, from perl v5.42.3, dated 2026-11-03 — mwah, slay, go resolve some hostnames responsibly ✨🎀🫶

📦 where this page comes from