Sys::Hostname::Long(3)

NAME
Sys::Hostname::Long - Try every conceivable way to get full hostname

SYNOPSIS
    use Sys::Hostname::Long;
    $host_long = hostname_long;

DESCRIPTION
How to get the host full name in perl on multiple operating systems (mac, windows, unix* etc)

DISCUSSION
This is the SECOND release of this code. It has an improved set of tests and improved interfaces - but it is still often failing to get a full host name. This of course is the reason I wrote the module, it is difficult to get full host names accurately on each system. On some systems (eg: Linux) it is dependent on the order of the entries in /etc/hosts.

To make it easier to test I have testall.pl to generate an output list of all methods. Thus even if the logic is incorrect, it may be possible to get the full name.

Attempt via many methods to get the systems full name. The Sys::Hostname class is the best and standard way to get the system hostname. However it is missing the long hostname.

Special thanks to David Sundstrom and Greg Bacon for the original Sys::Hostname

SUPPORT
This is the original list of platforms tested.

        MacOS           Macintosh Classic               OK
        Win32           MS Windows (95,98,nt,2000...)
                        98                              OK
        MacOS X         Macintosh 10                    OK
                        (other darwin)                  Probably OK (not tested)
        Linux           Linux UNIX OS                   OK
                        Sparc                           OK
        HPUX            H.P. Unix 10?                   Not Tested
        Solaris         SUN Solaris 7?                  OK (now)
        Irix            SGI Irix 5?                     Not Tested
        FreeBSD         FreeBSD                         OK

A new list has now been compiled of all the operating systems so that I can individually keep informaiton on their success.

THIS IS IN NEED OF AN UPDATE AFTER NEXT RELEASE.

Acorn - Not yet tested
AIX - Not yet tested
Amiga - Not yet tested
Atari - Not yet tested
AtheOS - Not yet tested
BeOS - Not yet tested
BSD - Not yet tested
BSD/OS - Not yet tested
Compaq - Not yet tested
Cygwin - Not yet tested
Concurrent - Not yet tested
DG/UX - Not yet tested
Digital - Not yet tested
DEC OSF/1 - Not yet tested
Digital UNIX - Not yet tested
DYNIX/ptx - Not yet tested
EPOC - Not yet tested
FreeBSD - Not yet tested
Fujitsu-Siemens - Not yet tested
Guardian - Not yet tested
HP - Not yet tested
HP-UX - Not yet tested
IBM - Not yet tested
IRIX - Not yet tested - 3rd hand information might be ok.
Japanese - Not yet tested
JPerl - Not yet tested
Linux
    Debian - Not yet tested
    Gentoo - Not yet tested
    Mandrake - Not yet tested
    Red Hat- Not yet tested
    Slackware - Not yet tested
    SuSe - Not yet tested
    Yellowdog - Not yet tested
LynxOS - Not yet tested
Mac OS - Not yet tested
Mac OS X - OK 20040315 (v1.1)
MachTen - Not yet tested
Minix - Not yet tested
MinGW - Not yet tested
MiNT - Not yet tested
MPE/iX - Not yet tested
MS-DOS - Not yet tested
MVS - Not yet tested
NetBSD - Not yet tested
NetWare - Not yet tested
NEWS-OS - Not yet tested
NextStep - Not yet tested
Novell - Not yet tested
NonStop - Not yet tested
NonStop-UX - Not yet tested
OpenBSD - Not yet tested
ODT - Not yet tested
OpenVMS - Not yet tested
Open UNIX - Not yet tested
OS/2 - Not yet tested
OS/390 - Not yet tested
OS/400 - Not yet tested
OSF/1 - Not yet tested
OSR - Not yet tested
Plan 9 - Not yet tested
Pocket PC - Not yet tested
PowerMAX - Not yet tested
Psion - Not yet tested
QNX
    4 - Not yet tested
    6 (Neutrino) - Not yet tested
Reliant UNIX - Not yet tested
RISCOS - Not yet tested
SCO - Not yet tested
SGI - Not yet tested
Symbian - Not yet tested
Sequent - Not yet tested
Siemens - Not yet tested
SINIX - Not yet tested
Solaris - Not yet tested
SONY - Not yet tested
Sun - Not yet tested
Stratus - Not yet tested
Tandem - Not yet tested
Tru64 - Not yet tested
Ultrix - Not yet tested
UNIX - Not yet tested
U/WIN - Not yet tested
Unixware - Not yet tested
VMS - Not yet tested
VOS - Not yet tested
Windows
    CE - Not yet tested
    3.1 - Not yet tested
    95 - Not yet tested
    98 - Not yet tested
    Me - Not yet tested
    NT - Not yet tested
    2000 - Not yet tested
    XP - Not yet tested
z/OS - Not yet tested

KNOWN LIMITATIONS

  Unix
Most unix systems have trouble working out the fully quallified domain name as it to be configured somewhere in the system correctly. For example in most linux systems (debian, ?) the fully qualified name should be the first entry next to the ip number in /etc/hosts

        192.168.0.1     fred.somwhere.special   fred

If it is the other way around, it will fail.

  Mac

TODO
Contributions

        David Dick
        Graeme Hart
        Piotr Klaban

        * Extra code from G
        * Dispatch table
        * List of all operating systems.

Solaris
    * Fall back 2 - TCP with DNS works ok
    * Also can read /etc/defaultdomain file

SEE ALSO
        L<Sys::Hostname>

AUTHOR
Scott Penrose <scottp@dd.com.au>

COPYRIGHT
Copyright (c) 2001,2004,2005 Scott Penrose. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.