---
name: "Net::Domain"
section: "3perl"
platform: "linux"
package: "perl"
version: "5.44.0-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/Net::Domain/3perl"
---

# Net::Domain(3perl)

Attempt to evaluate the current host's internet name and domain

## NAME

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

## SYNOPSIS

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

## DESCRIPTION

Using various methods **attempt** to find the Fully Qualified Domain Name (FQDN) of the current host. From this determine the host-name and the host-domain.

Each of the functions will return *undef* if the FQDN cannot be determined.

### Functions

- hostfqdn()

  Identify and return the FQDN of the current host.

- domainname()

  An alias for **hostfqdn()**.

- hostname()

  Returns the smallest part of the FQDN which can be used to identify the host.

- hostdomain()

  Returns the remainder of the FQDN after the *hostname* has been removed.

## EXPORTS

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

- Default Exports

  *None*.

- Optional Exports

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

- Export Tags

  *None*.

## KNOWN BUGS

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

## 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.

## COPYRIGHT

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.

## VERSION

Version 3.15

## DATE

20 March 2023

## HISTORY

See the *Changes* file.
